Claude Code Memory System
Claude Code dispose de 4 niveaux de mémoire persistante : CLAUDE.md projet (racine du repo), CLAUDE.md sous-dossiers (chargés à la demande, quand Claude lit un fichier de ce dossier), CLAUDE.md utilisateur (~/.claude/), et l'auto-memory (fichiers markdown écrits par Claude dans ~/.claude/projects/<projet>/memory/, dont les 200 premières lignes de MEMORY.md ou 25 Ko sont chargées à chaque session). Les CLAUDE.md découverts sont concaténés dans le contexte, ils ne se surchargent pas ; une politique d'organisation et un CLAUDE.local.md personnel existent aussi.
Forces
- 4 niveaux de granularité : global → projet → sous-dossier → auto-memory
- Auto-memory : Claude écrit lui-même ses notes persistantes entre les sessions
- CLAUDE.md commitable, les règles projet se propagent à toute l'équipe via le repo
Limites
- CLAUDE.md trop chargé → contexte window gaspillé à chaque session
- L'auto-memory peut devenir stale si Claude n'est pas invité à la nettoyer régulièrement
- Un CLAUDE.md se charge en entier à chaque session, qu'il concerne ou non le fichier que tu touches, et il ne se met jamais à jour tout seul. Avant d'installer un outil qui injecte les règles au bon moment, essaie la réponse native : des fichiers dans .claude/rules/ avec un champ paths, qui ne se chargent que lorsque Claude lit un fichier correspondant
- La mémoire automatique (MEMORY.md) est un bloc personnel : une consigne qui mériterait d'être partagée ne s'en extrait pas sans livrer tout le reste avec elle, préférences et notes privées comprises ([reel Instagram Ddv8_rzgaCr](https://www.instagram.com/reel/Ddv8_rzgaCr/)). Ce qui doit voyager avec l'équipe va dans une règle (.claude/rules/) ou un skill, qui se partagent un par un ; la mémoire garde ce qui ne concerne que toi
Pour qui
- Projets long-terme où Claude doit connaître les conventions et l'architecture sans rappel
- Équipes multi-devs voulant partager les règles Claude via le repo (CLAUDE.md commité)