Fichier CLAUDE.md : à quoi il sert, où le mettre, 3 modèles

Un fichier CLAUDE.md est un fichier texte Markdown que Claude Code lit au début de chaque session, pour que vous écriviez vos règles, votre contexte et vos préférences une fois pour toutes au lieu de les répéter à chaque conversation. Placez-le dans le dossier principal d'un projet pour les règles de ce projet, ou dans ~/.claude/CLAUDE.md pour les règles qui s'appliquent à tout ce que vous faites. Claude le traite comme des consignes plutôt que comme des réglages stricts, donc des instructions courtes et précises fonctionnent le mieux.

Le Markdown, c'est simplement du texte avec quelques symboles pour la structure : # commence un titre et - commence une puce. Vous n'avez besoin de rien d'autre pour écrire un bon CLAUDE.md.

Comment fonctionne CLAUDE.md

Chaque session Claude Code démarre avec une mémoire vierge. Deux choses transmettent des connaissances d'une session à l'autre : les fichiers CLAUDE.md que vous écrivez, et les notes de mémoire automatique que Claude écrit pour lui-même.

Les deux sont du contexte, pas des réglages imposés : Claude les lit et essaie de les suivre, comme l'explique la documentation sur la mémoire d'Anthropic. Pour bloquer quelque chose quoi qu'il arrive, utilisez plutôt une règle de permission, présentée plus bas.

Où placer les fichiers CLAUDE.md

~ désigne votre dossier personnel (%USERPROFILE% sous Windows), et ./ le dossier principal de votre projet.

Claude Code charge le CLAUDE.md du dossier où vous le lancez et de chaque dossier au-dessus, et les fichiers s'additionnent au lieu de se remplacer. Un CLAUDE.md dans un sous-dossier ne se charge que quand Claude commence à travailler sur des fichiers de ce sous-dossier.

Comme le fichier le plus spécifique est lu en dernier, une règle de projet est la plus proche du travail. Évitez quand même de contredire votre fichier personnel, car quand deux règles se contredisent, Claude peut suivre l'une ou l'autre.

Comment en créer un

1. Ouvrez le dossier du projet dans Claude Code. Dans le terminal, placez-vous dans le dossier et lancez claude ; dans l'application de bureau, utilisez l'onglet Code et Select folder.
2. Lancez /init. Claude parcourt le dossier et écrit un CLAUDE.md de départ. S'il en existe déjà un, il propose des améliorations au lieu de l'écraser.
3. Ou laissez Claude vous interroger. Pour un dossier encore presque vide, le prompt ci-dessous donne de meilleurs résultats que /init.
4. Modifiez-le. /memory liste vos fichiers CLAUDE.md et en ouvre un dans votre éditeur, ou dites simplement « ajoute cette règle à CLAUDE.md ».
5. Rechargez-le. Le fichier est lu au démarrage de la session, donc lancez /clear ou une nouvelle session après modification ; la page sur le cache des prompts d'Anthropic explique pourquoi les modifications en cours de session attendent.
6. Vérifiez qu'il est chargé. Lancez /context et cherchez le fichier sous Memory files.

Je veux un CLAUDE.md pour ce dossier. Pose-moi jusqu'à 8 questions, une à la fois, sur mon activité, pour qui est le travail, mon ton, les règles que je veux toujours voir respectées et ce que « terminé » veut dire pour moi. Puis écris un CLAUDE.md de moins de 60 lignes avec des titres clairs, et montre-le-moi avant de l'enregistrer.

Quoi y mettre, et quoi laisser de côté

Voyez CLAUDE.md comme l'endroit des choses que vous réexpliqueriez sinon. Un bon signal pour ajouter une ligne : Claude fait deux fois la même erreur, ou vous tapez la même correction que la semaine dernière.

Si vos règles sont déjà dans un autre fichier, importez-le avec @, comme @brand/voice.md, au lieu de le copier. Les fichiers importés se chargent aussi au démarrage, donc les imports gardent les choses organisées mais n'allègent pas le fichier.

Trois modèles prêts à copier

Remplacez tout ce qui est entre crochets, supprimez ce qui ne s'applique pas, et gardez le résultat court. Chacun est un point de départ à élaguer après une semaine d'usage réel.

Modèle 1 : dirigeant d'entreprise

Enregistrez-le sous ~/.claude/CLAUDE.md pour l'appliquer partout, ou sous CLAUDE.md dans le dossier de votre travail administratif.

# Moi et mon entreprise
- Je dirige [NOM DE L'ENTREPRISE], un(e) [TYPE D'ACTIVITÉ] à [VILLE OU MARCHÉ].
- Les clients sont [QUI ILS SONT]. Produits ou services principaux : [LISTE].
- Je ne suis pas développeur. Explique tout ce qui est technique en une phrase simple.

# Comment travailler avec moi
- Pose-moi des questions avant de commencer tout ce qui prend plus de quelques étapes.
- Montre-moi un plan court avant de modifier plus de 3 fichiers.
- Réponds en [LANGUE], en paragraphes courts, sans jargon.

# Règles toujours valables
- N'envoie jamais d'e-mails, de messages ni de paiements. Prépare des brouillons que j'enverrai.
- Ne supprime jamais de fichiers. Déplace ce que tu veux retirer dans un dossier appelé _trash.
- N'invente jamais de chiffres, prix ou faits. S'il manque quelque chose, demande-moi.
- La devise est [DEVISE]. Les dates s'écrivent [FORMAT DE DATE].

# Fichiers et dossiers
- Les documents entrants sont dans /inbox. Le travail terminé va dans /output.
- Nomme les fichiers comme AAAA-MM-JJ_sujet.

# Quand tu termines une tâche
- Liste ce que tu as modifié, ce que tu n'as pas pu faire et ce dont tu n'étais pas sûr.

# Compact instructions
Lors de la compaction, garde la liste des fichiers modifiés et les questions en suspens.

La dernière section utilise une fonction de la documentation d'Anthropic : un titre « Compact instructions » dit à Claude quoi garder quand il résume une longue conversation. Gardez ce titre en anglais.

Modèle 2 : marketeur

Enregistrez-le sous CLAUDE.md dans votre dossier marketing. Pour des workflows marketing complets qui l'utilisent, voyez Claude Code pour le marketing.

# Marque
- Marque : [NOM DE LA MARQUE]. Nous vendons [OFFRE] à [PUBLIC].
- Ton : [TROIS ADJECTIFS]. Nous sonnons comme [EXEMPLE], jamais comme [CONTRE-EXEMPLE].
- Mots que nous n'utilisons jamais : [LISTE].
- Orthographe : français de [FRANCE, BELGIQUE, SUISSE OU CANADA].

# Faits et affirmations
- Utilise uniquement les faits de /brand/facts.md et des fichiers que je te donne.
- Chaque statistique a besoin d'un lien source. Si tu n'en trouves pas, retire le chiffre.
- Ne nomme pas de concurrents sauf si je le demande.

# Canaux et formats
- LinkedIn : moins de [NOMBRE] mots, une idée par post.
- E-mail : objet de moins de [NOMBRE] caractères, un seul appel à l'action.
- Légendes Instagram : l'accroche en première ligne, moins de [NOMBRE] mots au total.

# Fichiers
- Les briefs sont dans /briefs. Les brouillons vont dans /drafts, un fichier par contenu, nommé canal_sujet_date.

# Avant de dire que c'est fini
- Vérifie chaque affirmation dans les fichiers sources et liste tout ce qui n'est pas étayé.

Modèle 3 : projet de site web

Enregistrez-le sous CLAUDE.md dans le dossier principal du site. Le guide pour créer un site avec l'IA détaille un projet complet qui va bien avec.

# Projet
- Site pour [NOM DE L'ENTREPRISE] : [À QUOI SERT LE SITE].
- La seule action attendue des visiteurs : [PAR EXEMPLE, RÉSERVER UN APPEL].
- Construit avec [TECHNOLOGIES, PAR EXEMPLE HTML ET CSS SIMPLES]. Hébergé sur [HÉBERGEUR].

# Commandes
- Aperçu en local : [COMMANDE]
- Vérification avant publication : [COMMANDE]

# Règles de design
- Couleurs : [CODES HEX]. Polices : [POLICES]. Garde beaucoup d'espace blanc.
- Mobile d'abord : vérifie chaque modification en largeur téléphone avant de dire que c'est fini.
- Chaque image a un texte alternatif. Les boutons disent ce qui se passe ensuite (« Réserver un appel », pas « Envoyer »).

# Règles de contenu
- Utilise uniquement les textes de /content et les faits que je confirme. Aucun avis, chiffre ou logo inventé.
- Chaque page a son propre titre et sa meta description.

# À ne pas faire
- N'ajoute pas de bibliothèques, plugins ou services sans me demander.
- Ne modifie pas les réglages de domaine, de DNS ou d'hébergement.

# Terminé signifie
- La commande de vérification passe, la page fonctionne en largeur téléphone, et tu listes ce que tu as modifié.

Quand CLAUDE.md ne suffit pas

Le guide pour créer un skill Claude montre comment transformer une procédure en skill. Pour les règles deny, le guide des permissions d'Anthropic donne la syntaxe, et notre aide-mémoire Claude Code inclut un fichier de paramètres de départ.

Garder CLAUDE.md léger économise aussi de l'usage, car il se charge à chaque session. Le guide des limites d'usage de Claude Code explique l'importance de la taille du contexte.

Quand Claude ignore votre CLAUDE.md

• Il ne s'est jamais chargé. Lancez /context et cherchez-le sous Memory files ; s'il manque, il est dans le mauvais dossier.
• Vous l'avez modifié en cours de session. Lancez /clear ou une nouvelle session pour charger la nouvelle version.
• Il est trop long ou trop flou. Supprimez tout ce que Claude fait déjà de lui-même, et réécrivez les règles floues en règles vérifiables.
• Deux règles se contredisent. Parcourez votre fichier personnel, celui du projet et ceux des sous-dossiers, et supprimez l'une des deux.
• Il faut une règle stricte. Transformez-la en règle de permission ou en hook.

Que faire ensuite

Ouvrez votre dossier de projet le plus utilisé, lancez /init ou le prompt d'entretien, et gardez le résultat sous 60 lignes la première semaine. Chaque fois que vous corrigez Claude, demandez-vous si cette correction a sa place dans le fichier, et retirez tout ce que Claude fait déjà de lui-même. Le tutoriel pour débutants montre CLAUDE.md à l'œuvre dans un vrai projet, et le cours Claude Code consacre une leçon au fichier CLAUDE.md, suivie des skills et de MCP.