Le système de mémoire
Un nouvel employé, le premier jour, ne sait rien de votre entreprise : ni ses règles, ni ses outils, ni son histoire. Ce qui en fait un collaborateur précieux, c'est ce qu'il retient. Claude Code résout cela avec quelque chose d'une simplicité rafraîchissante : des fichiers en texte brut lus au début de chaque session. Aucune boîte noire : vous pouvez ouvrir, lire et modifier chacun d'eux.
Trois fichiers portent l'essentiel de la charge. Nous appelons cela le pattern de mémoire à trois fichiers.
CLAUDE.md : le manuel de l'employé
CLAUDE.md est la première chose que Claude Code lit dans un projet. Il contient vos consignes permanentes : écrites par vous, en langage clair.
Ce qu'on y met : qui vous êtes et comment vous aimez travailler ( « réponds toujours en anglais », « sois concis » ) ; les règles du projet ( « ne touche jamais au dossier X », « lance toujours les tests avant de dire terminé » ) ; comment les choses sont organisées ( « les fichiers clients vivent dans /clients, un dossier par client » ).
Voyez-le comme le manuel de l'employé : personne ne le récite à voix haute, mais tout le monde est censé le suivre. L'effet pratique est énorme : vous cessez de répéter les mêmes instructions à chaque session, et l'agent cesse de commettre deux fois la même catégorie d'erreur.
MEMORY.md : le carnet personnel
Tandis que CLAUDE.md est écrit surtout par vous, MEMORY.md est écrit surtout par l'agent lui-même. Lorsqu'il apprend quelque chose qui mérite d'être conservé : une préférence que vous avez exprimée, un fait sur le projet, l'emplacement d'une ressource importante : il consigne une note brève.
Chaque note est un fait, daté et titré. Au fil des semaines, cela devient l'expérience accumulée de l'agent : la différence entre un nouveau venu et un collègue présent depuis un an. Vous pouvez ( et devriez ) la relire de temps à autre : elle se lit comme un carnet, pas comme du code.
lessons.md : le journal des erreurs
Le troisième fichier est le plus singulier : un journal des erreurs et des règles qui en sont tirées. Quand quelque chose tourne mal : l'agent a mal compris une instruction, une automatisation a échoué pour une raison subtile : la leçon est consignée : ce qui s'est passé, pourquoi, et quelle règle l'empêche la prochaine fois.
Le fichier est relu au début de chaque session. Le résultat est une boucle d'amélioration qui se cumule : chaque erreur n'arrive qu'une fois. D'après notre expérience d'exploitation d'agents en production chez eaQbe, cette seule habitude sépare les systèmes qui s'améliorent chaque semaine de ceux qui se répètent.
Comment les trois s'articulent
| Fichier | Écrit par | Contient | Analogie |
|---|---|---|---|
CLAUDE.md | Vous | Règles et consignes permanentes | Manuel de l'employé |
MEMORY.md | L'agent | Faits et préférences appris | Carnet personnel |
lessons.md | Les deux | Erreurs et règles qui en découlent | Journal de rétrospective |
La beauté du pattern, c'est sa transparence. La mémoire de votre collaborateur IA n'est pas un état neuronal mystérieux : ce sont trois fichiers texte dans votre projet, que vous pouvez lire en cinq minutes et corriger avec un éditeur de texte.
Questions fréquentes
Claude Code se souvient-il des choses d'une session à l'autre ?
Oui : grâce à ces fichiers ( plus des outils optionnels de mémoire long terme, voir MCP ). Tout ce qui se trouve dans CLAUDE.md, MEMORY.md ou lessons.md est rechargé au début de chaque session.
Faut-il être technique pour écrire CLAUDE.md ?
Non. C'est du langage clair. « Réponds toujours en français. N'envoie jamais d'e-mail sans m'en montrer d'abord un aperçu. Les dossiers de nos clients sont sous /clients. » : voilà un parfait CLAUDE.md.
Quelle est la différence entre CLAUDE.md et MEMORY.md ?
Le sens de l'écriture. CLAUDE.md, ce sont vos instructions à l'agent ; MEMORY.md, ce sont les notes de l'agent sur ce qu'il a appris. Le manuel face au carnet.
Pour aller plus loin
- Ensuite : Réglages, permissions & hooks : comment vous décidez de ce que l'agent peut faire.
- La mise en place complète de la mémoire fait partie de notre formation Claude Code.