Claude Code Memory : les 3 systemes de memoire que la plupart des devs ignorent
Mike Codeur
Claude Code a maintenant 3 systemes de memoire distincts : Memory, Auto Memory et Agent Memory. La plupart des developpeurs ne savent meme pas qu'ils existent -- et ceux qui connaissent CLAUDE.md pensent que c'est tout.
Et c'est marrant parce que decidement, Anthropic n'arrete pas de reprendre ce qui existait deja chez OpenClaw -- MEMORY.md, auto memory, agent memory, project rules. Feature apres feature, tout y passe.
La realite, c'est un systeme a 6 couches avec une hierarchie precise. Mal le configurer, c'est laisser Claude Code tourner a 30% de son potentiel.
Les 6 couches de memoire de Claude Code
Chaque couche a un role precis et une priorite dans la resolution des instructions :
| Couche | Nom | Qui ecrit | Scope |
|---|---|---|---|
| 1 | Managed Policy | Anthropic / ton organisation | Globale |
| 2 | Project Memory | Toi (CLAUDE.md) | Projet, partage via git |
| 3 | Project Rules | Toi (.claude/rules/*.md) | Projet, conditionnelles par fichier |
| 4 | User Memory | Toi (~/.claude/CLAUDE.md) | Machine, tous tes projets |
| 5 | Imports | Toi (fichiers externes) | A la demande |
| 6 | Auto Memory | Claude Code lui-meme | Projet, local a ta machine |
Couche 1 : Managed Policy
C'est la couche la plus haute dans la hierarchie. Elle est definie par Anthropic ou par ton organisation si tu utilises Claude Code en entreprise. Tu ne peux pas la modifier -- elle sert de garde-fou et de politique globale.
Couche 2 : Project Memory (CLAUDE.md)
Le fichier que tout le monde connait. Place a la racine de ton projet, il contient :
- Les conventions du projet (formatting, naming)
- Les commandes de build et de test
- L'architecture du projet
- Les regles specifiques a ton stack
Le point cle : ce fichier est versionne avec git. Toute ton equipe en beneficie.
# CLAUDE.md
## Build
- `pnpm dev` pour le dev local
- `pnpm build` pour la production
## Conventions
- TypeScript strict
- Drizzle ORM pour la DB
- Composants dans src/components/Couche 3 : Project Rules (.claude/rules/*.md)
C'est la couche la plus puissante et la moins connue. Des fichiers markdown dans .claude/rules/ qui s'activent conditionnellement :
---
globs: src/components/**/*.tsx
alwaysApply: false
---
Tous les composants React doivent utiliser des named exports.
Utiliser `cn()` pour la fusion de classes Tailwind.La regle ne s'active que quand Claude Code travaille sur un fichier qui matche le glob. Ca permet d'avoir des instructions specifiques sans polluer le CLAUDE.md principal.
Couche 4 : User Memory (~/.claude/CLAUDE.md)
Ton fichier de preferences personnelles, stocke dans ton home directory. Il s'applique a tous tes projets :
- Ton editeur prefere
- Tes conventions de style globales
- Tes preferences de communication avec Claude
Couche 5 : Imports
Des fichiers externes que tu charges a la volee dans le contexte. Utile pour injecter de la documentation, des specs, ou des references sans les mettre dans CLAUDE.md.
Couche 6 : Auto Memory
C'est la nouveaute. Claude Code ecrit ses propres notes dans ~/.claude/projects/<projet>/memory/ :
~/.claude/projects/<projet>/memory/
├── MEMORY.md <- Index (200 premieres lignes chargees auto)
├── debugging.md <- Notes de debugging
├── api-conventions.md <- Decisions apprises
└── ...
Quand tu corriges Claude Code ("non, utilise pnpm pas npm"), il note. Quand il resout un bug complexe, il enregistre la solution. Tu peux aussi lui dire "remember that..." et il ecrit dans ses fichiers.
La commande /memory te permet de voir toutes les couches d'un coup et de les editer.
Memory vs Auto Memory vs Agent Memory
C'est la confusion la plus courante :
| Systeme | Qui ecrit | Partage | Persistence |
|---|---|---|---|
| Memory (CLAUDE.md) | Toi | Via git (equipe) | Permanente |
| Auto Memory (MEMORY.md) | Claude Code | Local uniquement | Entre sessions |
| Agent Memory | Chaque sous-agent | Isole par agent | Entre sessions |
Agent Memory est le plus avance : quand Claude Code spawne des sous-agents (sub-agents), chacun maintient sa propre memoire independante qui persiste entre les sessions.
Le setup en 5 minutes
- Cree ton CLAUDE.md a la racine du projet avec tes conventions et commandes
- Ajoute des rules dans
.claude/rules/pour les regles conditionnelles - Configure ta User Memory dans
~/.claude/CLAUDE.mdpour tes preferences globales - Active Auto Memory en utilisant Claude Code normalement -- il ecrit tout seul
- Verifie avec
/memorypour voir l'etat complet
Conclusion
Le systeme de memoire de Claude Code est bien plus qu'un simple fichier CLAUDE.md. C'est une architecture a 6 couches qui, une fois bien configuree, transforme Claude Code en un vrai collaborateur qui te connait, connait ton projet, et apprend de ses erreurs.