Le fichier qui donne une mémoire à Claude

Chaque session commence par un trou de mémoire

Tu ouvres Claude Code et tu demandes une modification. Il lance npm install alors que ton projet tourne sous pnpm. Tu le corriges. Le lendemain, nouvelle session : même erreur.

Ce n'est pas un défaut de Claude. La documentation officielle le dit dès sa première phrase : chaque session commence avec une fenêtre de contexte neuve. Le contexte, c'est tout ce que le modèle a sous les yeux pendant la conversation : tes messages, les fichiers lus, le résultat des commandes. Quand la session se termine, ce contexte disparaît.

Ce que tu répètes sans t'en rendre compte

Regarde ces consignes. Elles viennent toutes de mes vrais fichiers. Sans CLAUDE.md, il faudrait les redire à chaque session :

• le port local de mon site (3200, parce que le 3000 est pris par un autre outil) ;
• « ne lis jamais le fichier .env » ;
• « vérifie le code avant de l'afficher, mon public est fait de développeurs » ;
• « ne commite que tes propres fichiers, j'ai d'autres sessions ouvertes ».

Chaque phrase prend dix secondes. Mais l'oublier coûte bien plus cher : un fichier secret affiché à l'écran, un commit (un enregistrement dans l'historique git) qui embarque le travail d'une autre session, une vidéo à refaire.

Deux mécanismes pour se souvenir

Claude Code a deux façons de garder des connaissances d'une session à l'autre. Les deux sont chargées au début de chaque conversation.

• CLAUDE.md : un fichier Markdown que tu écris. Le Markdown est du texte simple, où # fait un titre et - une puce. Tu y mets tes consignes : commandes, conventions, règles « toujours » et « jamais ».
• La mémoire automatique : des notes que Claude écrit lui-même, d'après tes corrections et tes préférences.

Claude Code sait aussi lire un fichier AGENTS.md, le format que partagent d'autres assistants de code comme Codex. Une leçon entière y est consacrée.

À quoi ressemble un CLAUDE.md

C'est du Markdown tout simple. Pas de format imposé, pas de champ obligatoire. Voici le début de celui de la plateforme sur laquelle tu lis cette leçon, raccourci :

@AGENTS.md

# formation.linedev.fr — instructions projet

## Règles

- **Ne jamais lire ni afficher `.env`, `.env.production`** (règle du client, bloquée par ses hooks).
  Les variables attendues sont dans `.env.example`.
- **En local, le site tourne sur le port 3200** (`pnpm dev`) : le 3000 est pris par le cockpit
  de pilotage.

## Commandes

```bash
pnpm dev                 # site local http://localhost:3200, administration /admin
pnpm exec tsc --noEmit   # types
```

« Le client », c'est moi : ce fichier est tenu à jour par Claude à chaque étape, à ma demande, et c'est ainsi qu'il m'appelle. La première ligne, @AGENTS.md, importe un autre fichier. Tu verras plus loin pourquoi elle est là, et pourquoi Next.js 16, le framework web de ce site, écrit exactement la même.

Une consigne, pas un verrou

Un point important dès le départ. Claude traite CLAUDE.md comme du contexte, pas comme une configuration imposée. Il lit tes règles et essaie de les suivre, mais rien ne l'y oblige.

Regarde la première règle de l'extrait : « bloquée par ses hooks ». Un hook est un script que Claude Code lance à un moment précis, par exemple juste avant qu'un outil s'exécute. La documentation est claire : pour bloquer une action quoi que Claude décide, il faut un hook. CLAUDE.md explique la règle, le hook la fait respecter.

Quand ajouter une ligne

La documentation donne une bonne boussole : CLAUDE.md, c'est l'endroit où tu écris ce que tu aurais réexpliqué. Ajoute une ligne quand :

• Claude refait la même erreur une deuxième fois ;
• une relecture de code relève quelque chose qu'il aurait dû savoir sur ce projet ;
• tu retapes la même correction qu'à la session précédente ;
• un nouveau collègue aurait besoin de la même information pour démarrer.

C'est exactement comme ça que mon fichier a grandi. Chaque erreur qui m'a coûté du temps est devenue une ligne. Et tu verras que ça a aussi un revers : un fichier qui grandit sans entretien finit par se contredire.

Ce qu'il te faut

• Claude Code, déjà installé. Tape claude --version dans ton terminal : il faut la version 2.1.277 ou plus récente pour la leçon sur AGENTS.md. Une installation faite par le script officiel se met à jour toute seule ; sinon, lance claude update. Si tu ne l'as jamais installé, la formation Claude Code : bien démarrer le fait pas à pas, sous Windows, macOS et Linux.
• Un compte : un abonnement Claude Pro, Max, Team ou Enterprise, ou un compte Claude Console.
• Un éditeur de texte pour ouvrir tes fichiers Markdown. N'importe lequel convient ; j'utilise VS Code.
• Un projet suivi par git, pour voir ce qui part dans un commit et ce qui reste chez toi.

Ce que tu vas apprendre

La prochaine leçon, gratuite elle aussi, ouvre le vrai CLAUDE.md de ma chaîne de vidéos. C'est lui qui fait tourner plus de 250 shorts produits en moins de deux semaines, avec plusieurs sessions en parallèle. Tu verras ce qu'il contient, ce qu'il m'évite, et l'endroit exact où il a dérapé.

Ensuite, la formation te donne la méthode complète :

• où ranger chaque consigne : pour toi seul, pour l'équipe, pour un seul dossier, et l'ordre réel dans lequel Claude lit tout ça ;
• un bon premier jet avec /init, puis ce qu'il faut ajouter à la main ;
• découper sans alourdir, avec les imports @ et les règles qui ne se chargent que pour certains fichiers ;
• la mémoire automatique : ce que Claude note seul, où il le range, et comment le relire avec /memory ;
• un seul AGENTS.md pour Claude et Codex, avec le montage que j'utilise et sa limite ;
• l'entretien : garder un fichier court, daté et sans contradiction.

Sources : How Claude remembers your project et la configuration requise de Claude Code, vérifiées le 19 octobre 2026.