Chapitre 1 · Comprendre la mémoire de Claude Code
Pourquoi Claude oublie d'une session à l'autre
Suis cette formation dans ton espace : ta progression est gardée, et la communauté répond à tes questions.
Suivre gratuitementLe problème : une mémoire qui repart de zéro
Tout ce que Claude a sous les yeux pendant une conversation s'appelle le contexte (sa mémoire de travail) : tes messages, ses réponses, les fichiers qu'il a lus, le résultat des commandes. Quand tu fermes la conversation ou que tu tapes /clear, ce contexte est vidé.
Exemple : un coach sportif passe une heure à expliquer à Claude que ses clients sont des débutants, qu'il tutoie, qu'il refuse les promesses du type « perds tout ton ventre en une semaine ». Le lendemain, nouvelle conversation : Claude ne sait plus rien de tout ça. Il écrit un post Instagram plein de promesses miracles.
Ce que Claude relit tout seul à chaque conversation
Au démarrage d'une conversation, Claude Code lit automatiquement :
- ton fichier CLAUDE.md ;
- sa mémoire automatique (des notes qu'il prend à partir de tes corrections) ;
- la description de tes skills (on en parle au chapitre 4).
Le reste (un fichier précis, une page web, le contenu complet d'un skill), il le lit seulement quand il en a besoin.
Conclusion : tout ce qui doit être su à chaque fois doit être écrit dans CLAUDE.md.
CLAUDE.md, c'est quoi exactement ?
C'est un simple fichier texte, au format Markdown (un format de texte avec des titres marqués par # et des listes marquées par -). Tu y écris ce que Claude doit savoir à chaque conversation : l'objectif du projet, ton public, ton ton, tes règles, ce qui est interdit, les commandes utiles. C'est la méthode conseillée par l'équipe de Claude Code pour donner un contexte durable.
Où il se range
Il existe trois emplacements, chacun avec son rôle :
CLAUDE.mdà la racine de ton projet : les règles de ce projet. C'est le plus important.~/.claude/CLAUDE.md: tes préférences pour tous tes projets, par exemple « tutoie-moi, réponds en français ». Le signe~désigne ton dossier personnel :C:\Users\<ton nom>sur Windows,/Users/<ton nom>sur Mac.CLAUDE.local.mdà la racine du projet : tes notes perso pour ce projet, à ne pas partager.
CLAUDE.md et mémoire automatique : la différence
À côté de CLAUDE.md, Claude Code prend ses propres notes à partir de tes corrections : c'est la mémoire automatique. Retiens cette phrase :
CLAUDE.md, ce sont tes consignes. La mémoire automatique, ce sont ses notes.
Une règle importante, ne compte pas sur lui pour la noter. Écris-la toi-même dans CLAUDE.md. Tu gardes ainsi le contrôle sur ce qu'il sait.
Pas à pas : vérifier ce que Claude sait déjà
- Ouvre Claude Code dans ton dossier de projet.
- Tape
/memory: tu vois tes fichiers de mémoire et tu peux les ouvrir pour les modifier. - Tape
/context: tu vois ce qui occupe le contexte, et si un CLAUDE.md est chargé. - Demande-lui directement ce qu'il sait de ton projet, avec ce prompt :
Contexte : je veux savoir ce que tu sais de ce projet au démarrage.
Objectif : vérifier si tu as un CLAUDE.md et ce que tu retiens de moi.
Contraintes : ne crée et ne modifie aucun fichier.
Format attendu : 1. s'il existe un CLAUDE.md et où, 2. ce qu'il dit en 5 lignes, 3. ce qui manque pour bien m'aider (public, ton, règles, interdits).
Validation : termine par la question la plus importante que je devrais régler en premier.
Les erreurs à éviter
- Réexpliquer ton projet à chaque conversation. C'est exactement le rôle de CLAUDE.md.
- Compter sur la mémoire automatique pour les règles importantes. Ce sont ses notes, pas tes consignes.
- Croire que
/clearefface CLAUDE.md. Non :/clearvide la conversation, mais CLAUDE.md reste chargé. C'est justement ce qui rend/clearsans danger. - Mettre tes préférences perso dans le CLAUDE.md du projet. Si c'est valable partout (langue, tutoiement), range-le dans
~/.claude/CLAUDE.md.
À toi de jouer
- Lance le prompt ci-dessus dans ton dossier de projet.
- Note sur papier trois choses que tu as déjà dû réexpliquer à une IA plus d'une fois (ton ton, ton public, une règle).
- Garde cette liste : dans la leçon suivante, ces trois choses entreront dans ton premier CLAUDE.md.