Donner une mémoire à l'agent avec CLAUDE.md

1. À la fin de cette leçon, tu sauras

Expliquer le rôle du fichier CLAUDE.md.
Créer un premier CLAUDE.md avec /init, puis le compléter.
Ouvrir et modifier la mémoire avec /memory.
Choisir ce qui doit y figurer, et ce qui ne doit jamais y être.

2. Pourquoi ça t’intéresse

Chaque fois que tu relances l’agent, il repart de zéro : il ne se souvient pas que tu es bénévole dans une association de parents d’élèves, que tu détestes le jargon, ni que les documents reçus de l’école ne doivent jamais être modifiés. Sans mémoire, tu répètes tout, à chaque session. Avec un fichier CLAUDE.md, tu l’écris une fois. C’est comme la fiche qu’on laisse à une baby-sitter sur le frigo : les habitudes de la maison, les choses à ne jamais faire, et qui appeler en cas de doute.

3. Avant de commencer


Il te faut	Ton dossier `formation-ia` rangé (leçon précédente), le modèle de cette leçon
Coût	Celui de ton abonnement : vérifie le prix du jour sur claude.com/pricing
Durée	40 à 50 minutes

4. Comprendre en 3 minutes

CLAUDE.md est un fichier texte, placé à la racine de ton dossier, que l’agent relit à chaque session. C’est sa fiche de consignes permanente.

« À la racine » veut dire directement dans le dossier où tu lances claude, pas dans un sous-dossier.

Deux commandes à connaître :

Commande	Ce qu’elle fait
`/init`	L’agent examine ton dossier et te propose un premier `CLAUDE.md`
`/memory`	Ouvre les fichiers de mémoire pour que tu les modifies, dont celui du dossier

Ce qu’on y met, et ce qu’on n’y met pas :

Oui	Non
Qui tu es, en deux lignes, et pour qui tu travailles	Mots de passe, codes, numéros de compte
Le but du dossier	Données de santé, adresses, informations sur d’autres personnes
Tes préférences de style (ton, longueur, langue)	Des pages entières de détails : reste court
La structure du dossier (sources, brouillons, livrables, notes)	Des consignes contradictoires
Les règles : ce qu’il ne doit jamais faire	Ce qui change chaque jour (ça va dans les notes)

Garde-le court et concret. Une consigne vague (« sois efficace ») ne sert à rien. Une consigne précise (« propose un plan avant toute création de fichier ») change vraiment le comportement.

Le modèle commenté de cette leçon t’aide à démarrer : modèle de CLAUDE.md.

5. Faire ensemble

Étape 1 · Laisser l’agent proposer une base

Lance claude dans formation-ia, puis tape :

/init

L’agent parcourt le dossier et propose un fichier CLAUDE.md. Lis sa proposition avant d’accepter. Il est normal qu’elle soit un peu générale : il ne te connaît pas encore.

Étape 2 · Compléter avec le modèle

Ouvre le modèle de la leçon dans ton navigateur. Puis demande :

Je vais te donner des informations pour compléter CLAUDE.md. Pose-moi d'abord les questions qui te manquent, une par une, sur :
qui je suis, le but de ce dossier, mes préférences de style, et les règles à respecter.
Ensuite, propose-moi le nouveau CLAUDE.md complet, court, en français, avant de l'écrire.

Réponds à ses questions en t’inspirant du modèle. Relis la proposition finale : enlève tout ce qui est sensible ou trop long.

Étape 3 · Ouvrir la mémoire toi-même

Tape :

/memory

Choisis le fichier du dossier dans la liste. Il s’ouvre dans un éditeur de texte. Corrige une phrase à la main, enregistre, ferme. Tu viens de modifier la mémoire de l’agent sans passer par lui.

Étape 4 · Tester la mémoire

Ferme le terminal, rouvre-le, retourne dans formation-ia, relance claude, puis :

Sans relire mes fichiers de travail, dis-moi ce que tu sais de moi, de ce dossier et des règles à respecter.

Sa réponse doit refléter ton CLAUDE.md. Si un point manque, c’est que la consigne n’est pas assez claire : reformule-la.

6. Faire toi-même

Écris le CLAUDE.md du vrai dossier que tu as rangé à la leçon précédente. Il doit contenir :

deux lignes sur toi et sur le but du dossier ;
trois préférences de style ;
la structure des sous-dossiers ;
au moins trois règles, dont « ne jamais modifier les fichiers de sources » et « proposer un plan avant toute création ».

Teste-le en relançant l’agent et en lui demandant de résumer ce qu’il sait.

Résultat attendu : un CLAUDE.md d’une demi-page maximum, sans aucune donnée sensible, que l’agent restitue correctement.

7. Vérifier

CLAUDE.md se trouve à la racine du dossier, pas dans un sous-dossier.
Il tient en une demi-page environ.
Il ne contient ni secret, ni donnée personnelle sensible.
Chaque règle est assez précise pour qu’on sache si elle est respectée.
Après relance, l’agent restitue mes préférences et mes règles.

8. Ce que tu gardes

Ton CLAUDE.md, et dans ton carnet : « Quand je répète une consigne pour la deuxième fois, je l’ajoute à CLAUDE.md. » Pense à faire un point de sauvegarde après chaque modification importante.

9. Pour aller plus loin

Avec /memory, regarde aussi le fichier de mémoire personnel, valable pour tous tes dossiers : tu peux y mettre tes préférences générales.
La documentation officielle (code.claude.com/docs) détaille le fonctionnement de la mémoire.