Introduction

Début décembre, chez Verdier Architectes. La bibliothèque technique est réorganisée. Julien ouvre une nouvelle session de Claude Code et demande : « Mets à jour la fiche du béton de chanvre. »

Claude Code lit le dossier, trouve la fiche, la modifie. Mais il écrit les unités à l’anglaise, oublie le renvoi vers la liste des normes et nomme la nouvelle version « fiche-beton-chanvre-updated ». Tout ce que Julien avait expliqué la veille a disparu.

C’est normal : chaque session de Claude Code repart à zéro. Pour qu’il retienne vos règles, il faut les écrire là où il les lira à chaque fois.

Ce fichier existe. Il s’appelle CLAUDE.md. Cette page vous apprend à l’écrire, à l’organiser et à l’entretenir, avec son complément, la mémoire automatique.

1. Claude oublie entre deux sessions

D’après Anthropic, chaque session de Claude Code commence avec une fenêtre de contexte neuve, sans l’historique des sessions précédentes. Pendant une longue session, Claude résume aussi automatiquement les échanges anciens quand la place manque ; les consignes données au début peuvent alors se perdre.

Deux mécanismes transportent le savoir d’une session à l’autre :

	Fichier CLAUDE.md	Mémoire automatique
Qui l’écrit	Vous	Claude
Ce qu’il contient	Consignes et règles	Apprentissages tirés de vos corrections et préférences
Quand il est lu	Au début de chaque session	Au début de chaque session (le début de l’index)

Vous connaissez déjà ce principe : la page « Consignes et mémoire de Claude » du module 3 présentait les consignes personnelles et les consignes de projet dans la conversation. Le fichier CLAUDE.md joue le même rôle pour un dossier, avec un avantage : c’est un fichier, que vous lisez, modifiez et partagez comme les autres.

Essayez avec Claude Code. Ouvrez deux sessions successives sur votre dossier d’essai. Dans la première, donnez une règle (« écris toujours les dates au format 24/11/2026 »). Dans la seconde, demandez une tâche qui utilise une date. Constatez l’oubli.

Exemples :

• Julien constate que la règle des unités, donnée la veille, n’est plus appliquée.
• La règle de nommage de la page 8.2 n’est respectée que si on la rappelle.
• Inès comprend pourquoi ses consignes de projet, dans la conversation, ne valent pas pour Claude Code.

2. Le fichier CLAUDE.md, lu au démarrage

Le fichier CLAUDE.md est un fichier texte, en Markdown, placé à la racine de votre dossier de travail. Claude Code le lit au début de chaque session. Tout ce qui y est écrit devient une consigne permanente pour ce dossier.

Pour le créer, deux possibilités :

• le demander à Claude Code : « Crée un fichier CLAUDE.md pour ce dossier, à partir de sa structure et du fichier A_LIRE.md. » La commande /init le fait aussi : Claude analyse le dossier et propose un premier fichier ;
• l’écrire vous-même, à partir du modèle du chapitre 3.

Dans les deux cas, relisez-le : Claude ne connaît pas les règles qui ne sont écrites nulle part.

Un point important : d’après Anthropic, Claude traite ce fichier comme un contexte, pas comme une règle imposée par le logiciel. Plus les consignes sont précises et courtes, mieux il les suit. Pour interdire vraiment une action, il faut d’autres mécanismes, vus dans les pages 8.4 et 8.6.

Essayez avec Claude Code. Demandez à Claude Code de proposer un CLAUDE.md pour votre dossier d’essai, sans rien écrire sur le disque. Comparez sa proposition avec vos règles réelles.

Exemples :

• La proposition de Claude Code décrit bien la structure mais invente une règle de validation que l’agence n’a jamais eue.
• Julien supprime cette règle et ajoute les trois qui manquent : unités, renvoi aux normes, nommage.
• Le fichier final tient en quarante lignes.

3. Quoi y mettre, quoi ne pas y mettre

À mettre dans le CLAUDE.md :

• qui vous êtes, en deux lignes : l’entreprise, le dossier, son usage ;
• où trouver quoi : la structure, le référentiel, la règle de la source unique ;
• vos règles de travail : langue, ton, unités, nommage, format des dates ;
• les interdits : dossiers à ne jamais modifier, informations à ne jamais recopier ;
• les validations : ce que Claude doit faire valider avant d’agir.

À ne pas mettre :

• les informations de référence elles-mêmes : renvoyez vers le fichier du référentiel, sinon vous créez une deuxième source ;
• les mots de passe, codes d’accès et données personnelles : jamais ;
• les procédures longues (une méthode en vingt étapes) : elles alourdissent chaque session ; rangez-les dans un skill, présenté en page 8.5, que Claude charge seulement quand il en a besoin ;
• les généralités (« sois précis et professionnel ») : elles prennent de la place sans rien changer.

Voici un exemple pour la bibliothèque technique de l’agence :

# Bibliothèque technique de Verdier Architectes

Documentation technique de l'agence (5 personnes). Sert à rédiger
les notices et les cahiers des charges. Responsable : Julien.

## Où trouver quoi
- Lire d'abord 00_Referentiel/ : il fait foi.
- Une information, un seul endroit : ne jamais recopier un tarif,
  une norme ou une adresse. Renvoyer vers le fichier de référence.
- Structure et règles détaillées : voir A_LIRE.md.

## Règles de rédaction
- Français. Unités du système international (m², W/m.K).
- Dates au format 24/11/2026.
- Normes : citer uniquement celles de 00_Referentiel/normes-en-vigueur.md.
- Nommage : AAAA-MM-JJ_sujet_version.md en minuscules sans accents.

## Interdits
- Ne jamais modifier 40_Reglementation/ (textes officiels).
- Aucune donnée personnelle de client dans ce dossier.

## Avant d'agir
- Plus de 10 fichiers concernés : proposer un plan et attendre l'accord.
- Toute suppression : déplacer dans 90_Archives/ à la place.

Essayez avec Claude Code. Rédigez votre CLAUDE.md sur ce modèle : présentation, où trouver quoi, règles, interdits, validations. Visez trente à soixante lignes. Enregistrez-le à la racine du dossier d’essai.

Exemples :

• La règle « toute suppression devient un archivage » évite à Julien deux pertes de fichiers la première semaine.
• La procédure de mise à jour d’une fiche de matériau, en quinze étapes, sort du CLAUDE.md pour devenir un skill.
• Le tarif horaire, recopié par erreur dans une première version, est remplacé par un renvoi vers 00_Referentiel/tarifs.md.

4. Un fichier par dossier

Un grand dossier peut contenir plusieurs fichiers CLAUDE.md : un à la racine, d’autres dans certains sous-dossiers. D’après Anthropic :

• les CLAUDE.md du dossier de lancement et des dossiers au-dessus sont lus au démarrage ;
• ceux des sous-dossiers sont lus à la demande, quand Claude travaille sur des fichiers de ces sous-dossiers.

C’est utile pour des règles qui ne valent que pour une partie du travail. Le CLAUDE.md racine donne les règles communes ; celui de 20_Notices-types ajoute les règles propres aux notices. Claude ne les charge que lorsqu’il en a besoin, ce qui économise de la place.

Évitez les contradictions entre fichiers : si deux consignes s’opposent, Claude peut suivre l’une ou l’autre.

Essayez avec Claude Code. Repérez dans votre dossier un sous-dossier qui a des règles propres. Écrivez pour lui un court CLAUDE.md de dix lignes au maximum, sans répéter les règles communes.

Exemples :

• 20_Notices-types/CLAUDE.md : plan type d’une notice, longueur visée, mentions obligatoires.
• 40_Reglementation/CLAUDE.md : une seule ligne, « Lecture seule. Ne jamais modifier ces fichiers. »
• Julien supprime du fichier racine les règles des notices, désormais dans leur sous-dossier.

5. Personnel ou partagé

Il existe plusieurs niveaux de consignes, chacun avec sa portée :

Fichier	Portée	Exemple
CLAUDE.md du dossier	Le dossier, partagé avec ceux qui y travaillent	Les règles de la bibliothèque technique
CLAUDE.local.md du dossier	Le dossier, pour vous seul	Vos raccourcis personnels sur ce dossier
CLAUDE.md personnel, dans le dossier .claude de votre profil	Tous vos dossiers, pour vous seul	« Réponds en français. Tutoie-moi. »

Le fichier du dossier est celui qui compte le plus : il voyage avec le dossier et sert à toute l’équipe. Le fichier personnel reprend vos préférences, comme les consignes personnelles de la conversation.

Et le fichier AGENTS.md ? D’autres outils d’IA utilisent un fichier appelé AGENTS.md pour le même usage. D’après Anthropic, Claude Code le lit quand le dossier n’a pas de CLAUDE.md. Si vous utilisez plusieurs outils, un CLAUDE.md peut aussi y renvoyer. Gardez une seule source de consignes, comme pour le reste.

Essayez avec Claude Code. Classez vos consignes en deux colonnes : celles qui valent pour tous ceux qui travaillent sur le dossier, celles qui ne concernent que vous. Les premières vont dans le CLAUDE.md du dossier, les secondes dans votre fichier personnel.

Exemples :

• « Unités du système international » va dans le CLAUDE.md du dossier : tout le monde doit l’appliquer.
• « Réponds-moi en phrases courtes » va dans le fichier personnel de Julien.
• Sofia, que Claire autorise début décembre à rejoindre l’essai (matrice des accès mise à jour), profite des règles du dossier sans hériter des préférences de Julien.

6. La mémoire automatique

Claude Code tient aussi, de lui-même, un carnet de notes. D’après Anthropic, il y enregistre des apprentissages tirés de vos corrections et de vos préférences : une façon de faire que vous avez corrigée, une préférence exprimée, une information sur le projet.

Ces notes sont rangées dans votre profil, dans un dossier propre à chaque projet (~/.claude/projects/<projet>/memory/), avec un index appelé MEMORY.md. Le début de l’index (les 200 premières lignes ou 25 Ko) est lu au début de chaque session.

La commande /memory permet de voir ces fichiers, de les ouvrir et d’activer ou de désactiver la mémoire automatique.

Comme la mémoire de la conversation (page « Consignes et mémoire de Claude »), elle rend service mais peut retenir une erreur. Relisez-la.

Essayez avec Claude Code. Après quelques sessions, ouvrez la mémoire automatique avec /memory. Lisez chaque note. Supprimez celles qui sont fausses, déplacez dans le CLAUDE.md celles qui méritent d’être des règles pour tous.

Exemples :

• Claude a noté que Julien préfère les tableaux aux listes pour comparer des matériaux : note utile, conservée.
• Il a aussi noté que « les fiches de 2019 sont à jour », ce qui est faux : note supprimée.
• La note sur la règle des arrondis devient une ligne du CLAUDE.md, pour que Sofia en profite aussi.

7. Entretenir sa mémoire

Un CLAUDE.md vieillit comme tout document. Quelques règles d’entretien :

• court : Anthropic recommande moins de 200 lignes par fichier ; au-delà, Claude suit moins bien les consignes et chaque session consomme davantage ;
• précis : « dates au format 24/11/2026 » plutôt que « dates en français » ;
• sans contradiction : relisez les fichiers des sous-dossiers en même temps ;
• à jour : une règle abandonnée doit disparaître du fichier ;
• daté : indiquez en bas la date de la dernière revue et son auteur.

Prévoyez une revue mensuelle de quinze minutes : relire le CLAUDE.md et la mémoire automatique, retirer ce qui est périmé, ajouter les règles apprises dans le mois. Vous pouvez demander à Claude Code de repérer les consignes contradictoires ou obsolètes.

Essayez avec Claude Code. Demandez à Claude Code : « Relis tous les fichiers CLAUDE.md de ce dossier et ta mémoire automatique. Liste les consignes en double, contradictoires ou trop vagues. » Corrigez.

Exemples :

• La première revue de Julien, le 5 janvier, supprime six lignes devenues inutiles.
• Elle révèle une contradiction sur le format des dates entre le fichier racine et celui des notices.
• Le CLAUDE.md passe de 58 à 44 lignes.

Résumé

Chaque session de Claude Code repart à zéro. Deux mécanismes transportent le savoir : le fichier CLAUDE.md, que vous écrivez ; la mémoire automatique, que Claude tient. Le CLAUDE.md, placé à la racine du dossier, est lu au début de chaque session. Claude le traite comme un contexte : plus il est précis et court, mieux il est suivi.

On y écrit qui l’on est, où trouver quoi, les règles de travail, les interdits et les validations. On n’y met ni les informations de référence (on y renvoie), ni mots de passe, ni données personnelles, ni procédures longues (elles vont dans des skills). Les CLAUDE.md des sous-dossiers sont lus à la demande ; un fichier personnel porte vos préférences ; AGENTS.md est lu en l’absence de CLAUDE.md.

La mémoire automatique note vos corrections et préférences dans votre profil ; /memory permet de la relire. Entretenez le tout : moins de 200 lignes, précis, sans contradiction, revu chaque mois.

Remplissez « Mon fichier CLAUDE.md » dans l’annexe : c’est la vingt-huitième page de votre carnet d’utilisation.

Questions fréquentes

Le CLAUDE.md garantit-il que Claude respectera mes règles ?

Non. Claude le lit comme un contexte et le suit d’autant mieux qu’il est court et précis. Pour interdire une action à coup sûr, utilisez les modes d’autorisation et les règles d’autorisation, vus en pages 8.4 et 8.6.

Mes collègues voient-ils mon CLAUDE.md ?

Celui du dossier, oui, s’ils travaillent sur le même dossier : c’est le but. Votre fichier personnel et votre CLAUDE.local.md restent à vous.

La mémoire automatique est-elle partagée avec l’équipe ?

Non. Elle est rangée dans votre profil, sur votre ordinateur. Ce qui doit servir à toute l’équipe va dans le CLAUDE.md du dossier.

Puis-je désactiver la mémoire automatique ?

Oui, avec la commande /memory. Le CLAUDE.md continue de fonctionner.

Quelle différence avec le fichier « À lire » ?

Le fichier « À lire » décrit le dossier pour les humains. Le CLAUDE.md donne des consignes de travail à Claude. Le second peut renvoyer au premier pour les détails.

Termes clés

• CLAUDE.md : fichier de consignes en Markdown que Claude Code lit au début de chaque session.
• Consignes de projet : celles du CLAUDE.md du dossier, partagées avec ceux qui y travaillent.
• Consignes personnelles : celles de votre fichier CLAUDE.md personnel, valables pour tous vos dossiers.
• Mémoire automatique : notes que Claude Code prend seul à partir de vos corrections et préférences.
• MEMORY.md : l’index de la mémoire automatique, dont le début est lu à chaque session.
• AGENTS.md : fichier de consignes utilisé par d’autres outils d’IA, que Claude Code lit en l’absence de CLAUDE.md.

Références

• Anthropic — How Claude remembers your project
• Anthropic — How Claude Code works
• Anthropic — Manage costs effectively
• Claude Academy — Claude Code 101 (cours gratuit, en anglais)

QCM (une seule bonne réponse par question)

Question 1 — Pourquoi Claude Code oublie-t-il les consignes de la veille ?

1. Parce qu’il est en panne
2. Parce que chaque session commence sans l’historique des précédentes
3. Parce qu’il faut payer une option

Question 2 — Quand le CLAUDE.md du dossier est-il lu ?

1. Au début de chaque session
2. Une fois par mois
3. Seulement si on le demande

Question 3 — Qui écrit le CLAUDE.md et qui écrit la mémoire automatique ?

1. Claude écrit les deux
2. Vous écrivez les deux
3. Vous écrivez le CLAUDE.md ; Claude tient la mémoire automatique

Question 4 — Que ne faut-il pas mettre dans le CLAUDE.md ?

1. Les règles de nommage
2. Les mots de passe et les données personnelles
3. Les dossiers à ne jamais modifier

Question 5 — Le tarif horaire de l’entreprise doit figurer dans le CLAUDE.md :

1. Sous forme de renvoi vers le fichier du référentiel qui fait foi
2. Recopié en entier
3. En plusieurs exemplaires

Question 6 — Où ranger une procédure de vingt étapes ?

1. Dans le CLAUDE.md racine
2. Dans un skill, chargé seulement quand il sert
3. Dans la mémoire automatique

Question 7 — Les CLAUDE.md des sous-dossiers sont lus :

1. Jamais
2. Toujours, tous en même temps
3. À la demande, quand Claude travaille sur des fichiers de ces sous-dossiers

Question 8 — Quelle longueur viser pour un CLAUDE.md ?

1. Moins de 200 lignes
2. Plus de 1 000 lignes
3. Une ligne

Question 9 — La mémoire automatique a retenu une information fausse. Que faire ?

1. Rien, elle se corrigera seule
2. La supprimer après relecture avec /memory
3. Réinstaller l’application

Question 10 — Le CLAUDE.md garantit-il qu’une action interdite ne sera jamais faite ?

1. Oui, toujours
2. Oui, si le texte est en majuscules
3. Non, il guide Claude ; les interdictions strictes passent par les autorisations

Voir les réponses et les explications

Réponses : 1→2 · 2→1 · 3→3 · 4→2 · 5→1 · 6→2 · 7→3 · 8→1 · 9→2 · 10→3

Explications.

1. D’après Anthropic, chaque session commence avec une fenêtre de contexte neuve.
2. Le CLAUDE.md est chargé à chaque démarrage de session.
3. Le CLAUDE.md porte vos consignes ; la mémoire automatique, les apprentissages de Claude.
4. Un CLAUDE.md se partage : aucun secret ni donnée personnelle.
5. Un renvoi évite une deuxième source et les contradictions.
6. Un skill ne pèse sur la session que lorsqu’il sert.
7. Le chargement à la demande économise de la place.
8. Anthropic recommande moins de 200 lignes par fichier.
9. On relit, on supprime ce qui est faux, on promeut ce qui est utile.
10. Claude le traite comme un contexte ; les modes et règles d’autorisation interdisent vraiment.

Exercices

Exercice 1 — Écrire votre CLAUDE.md (20 min) Sur le modèle du chapitre 3, rédigez le CLAUDE.md de votre dossier d’essai : présentation, où trouver quoi, règles, interdits, validations. Trente à soixante lignes.

Exercice 2 — Le tester (10 min) Ouvrez une nouvelle session et demandez une tâche qui met en jeu trois de vos règles. Vérifiez qu’elles sont appliquées. Ajustez la rédaction de celles qui ne le sont pas.

Exercice 3 — Planifier la revue (5 min) Fixez la date de votre première revue mensuelle et écrivez en bas du CLAUDE.md la ligne « Dernière revue : date, auteur ».

Corrections des exercices

Exercice 1 — Exemple : le fichier du chapitre 3, complété d’une ligne sur les arrondis et d’un renvoi vers A_LIRE.md. Un bon CLAUDE.md se lit en une minute et ne contient aucune information qui vit ailleurs.

Exercice 2 — Exemple : demande « mets à jour la fiche du béton de chanvre » ; unités, renvoi aux normes et nommage appliqués ; la règle des dates, d’abord ignorée, est réécrite avec un exemple précis. Une règle avec un exemple concret est mieux suivie qu’une règle abstraite.

Exercice 3 — Exemple : revue le premier lundi du mois, première le 5 janvier, par Julien. Une date fixe évite que le fichier ne vieillisse sans qu’on s’en aperçoive.

Annexe — Mon fichier CLAUDE.md

Vingt-huitième page de votre carnet d’utilisation de Claude.

Mon CLAUDE.md, rubrique par rubrique.

Rubrique	Mes consignes
Qui nous sommes, à quoi sert le dossier
Où trouver quoi (référentiel, source unique)
Règles de travail (langue, unités, dates, nommage)
Interdits
Avant d’agir (validations)

Mes consignes personnelles (fichier personnel) : …

Ma revue mensuelle.

Date	Lignes avant	Lignes après	Consignes ajoutées, retirées, corrigées