Durable knowledge goes in these docs, not in agent memory. […]
Malgré cette règle, le systemPrompt derrière Claude Code force.
159 fichiers.
52 306 mots.
Répartis sur 18 projets en cours.
C’est ce que Claude Code a écrit, sans que je le lui demande, et sans que je puisse facilement relire et valider ce contenu.
Et ce n’est pas la sortie récente de Claude Opus 5 ou la mise à jour de Claude Code (v2.1.220) qui va avec qui va changer la donne.
Focus sur un point qui peut petit à petit empoisonner votre utilisation de Claude Code et faut-il activer, ou plutôt désactiver autoMemoryEnabled.
Opus 5 et les nouvelles règles du context engineering
Le 24 juillet, Anthropic sort Claude Opus 5.
À titre individuel, la nouvelle m’excite modérément : depuis Opus 4.6, je préférerais un modèle plus rapide à un modèle plus intelligent. Et de ce côté-là, c’est plutôt les modèles chinois (GLM) qui sont au rendez-vous.
Ce qui m’intéresse avec celui-ci, c’est ce qu’Anthropic a publié dans la foulée : les nouvelles règles du context engineering. Une tendance qui montait déjà depuis quelques mois.
En résumé, Thariq Shihipar y indique de simplifier agressivement. Supprimer les garde-fous écrits pour les générations précédentes, préférer le jugement à la règle rigide, charger le contexte à la demande plutôt qu’en bloc, arrêter de répéter la même consigne dans le system prompt, les descriptions d’outils et le CLAUDE.md… et in-fine, de retirer 80 % des contraintes accumulées.
Claude code est aux antipodes de ces recommandations

Au moment où Anthropic vous explique d’alléger votre contexte, son propre harnais le remplit tout seul.
J’ai beau écrire « ne mets rien en mémoire » dans le CLAUDE.md, le system prompt, lui, demande à Claude de tenir sa mémoire à jour. C’est l’étage du dessus qui gagne. Ce n’est pas de la désobéissance, c’est une hiérarchie.
Faut-il passer de la règle au réglage "autoMemoryEnabled": false ?
À propos de la mémoire de Claude
Petite digression pédagogique, si vous n’êtes pas encore à l’aise avec les concepts de CLAUDE.md et de mémoire.
CLAUDE.md
Claude en produit une bonne partie : /init le génère en analysant la codebase, /doctor propose de le dégraisser, et il suffit de lui demander d’y ajouter une consigne pour qu’il s’en charge. Le mien est un aller-retour permanent entre lui et moi.
Il est un fichier, à un emplacement connu, à la racine du projet où je travaille. Mon process repose majoritairement sur un IDE, Zed (équivalent vs code), dont le Git Panel liste les fichiers modifiés. Quand Claude touche au CLAUDE.md, la ligne apparaît là, à côté de mon code. Je valide ou je refuse.
La mémoire
Elle ne vit pas dans le projet, mais dans un dossier dérivé de son chemin absolu, slashs remplacés par des tirets :
~/.claude/projects/-home-example-user-my-current-project/memory/
├── MEMORY.md # l'index, chargé à chaque session
├── deploy-cache.md # une note détaillée par sujet
├── prod-curl-user-agent.md
└── ...
Le Git Panel ne l’affichera pas, puisque le dossier n’appartient pas au dépôt. Ce n’est pas un chemin où l’on passe, c’est un chemin où l’on va, exprès, après avoir décidé d’aller voir. Et on ne décide jamais.
CLAUDE.md | auto-memory | |
|---|---|---|
| À l’injection | invisible | invisible |
| À la relecture | 1 fichier, dans le projet | 159 fichiers, hors projet |
| À l’écriture | une ligne dans le Git Panel | Saved 2 memories |
| À l’audit | git log, git blame | un champ modified |
Pour écrire une mémoire, Claude utilise pourtant exactement les mêmes outils que pour votre code. Un Write ordinaire. À l’arrivée, l’opération se résume à un compteur : Saved 2 memories. Deux quoi ? Il faut aller voir.
Toute la provenance d’une mémoire tient dans un champ modified de son en-tête, ajouté par une version récente de Claude Code.
MEMORY.md sert d’index. Seules ses 200 premières lignes (ou 25 Ko) sont injectées au démarrage. Les fichiers thématiques, eux, ne sont pas chargés : Claude va les lire en cours de session, quand il juge le sujet pertinent. Et d’une lecture de fichier, vous ne voyez que le nom passer dans le terminal, jamais le contenu.
Une note écrite il y a trois mois peut donc orienter la réponse d’aujourd’hui sans s’être affichée une seule fois devant vous. Ni à l’écriture, ni à la lecture.
Deux sources de vérité, dont une invisible. Bon courage pour debugger des réponses à côté.
Une mémoire fausse coûte plus cher qu’une absence de mémoire
Une mémoire n’arrive pas dans le contexte avec le statut d’hypothèse. Elle arrive avec le statut de fait établi, avant même que le code ne soit lu. Quand le code la contredit, l’agent ne conclut pas « ma note est périmée », il cherche à réconcilier les deux. Il relit, il teste, il contourne, il repart sur une piste. Il tourne en rond, et vous payez les tokens de ce ping-pong.
Le pire, c’est le cycle. La correction que vous tapez dans le chat meurt avec la session. La note fausse, elle, survit. Vous corrigez la même chose trois fois, à trois semaines d’intervalle, sans jamais faire le lien.
Ce n’est pas un problème de mémoire, c’est un problème de revue
Couper l’auto-memory revient à traiter une infection par l’amputation.
Ce qui rend un CLAUDE.md sain, ce n’est pas son auteur, puisque c’est souvent Claude. C’est qu’il vit dans votre projet, sous vos yeux, et dans votre historique Git.
MEMORY.md ne coche aucune de ces cases :
- il est stocké dans
~/.claude/projects/, donc hors du dépôt et hors de Git ; - il est machine-local : votre collègue a le sien, différent, et vous ne verrez jamais le sien ;
- il n’apparaît dans aucune pull request ;
- il est écrit pendant que vous travaillez sur autre chose, au moment précis où votre attention est ailleurs.
Aucun de ces quatre problèmes n’en est un de mémoire. Ce sont des problèmes de revue.
Remonter la mémoire dans les docs
La règle en tête de cet article n’est pas née en théorie. Elle est sortie d’une journée passée, sur le plus gros mono-repo que je maintiens, à remonter des dizaines de notes de mémoire vers les docs du dépôt.
Son cœur tient en une ligne : la note complète va dans le doc versionné, la mémoire ne garde qu’un pointeur.
La mémoire est un cache, pas une archive
Huit jours après cette passe de nettoyage, 14 nouveaux fichiers s’étaient déjà écrits sur ce projet. Environ deux par jour.
Une mémoire ne se corrompt pas comme une archive, elle se remplit comme un cache. On ne se bat pas contre un cache. On le vide.
Concrètement, je garde l’auto-memory activée et je la traite comme jetable. Elle accumule ce qu’elle veut pendant un mois. À la fin du mois, ce qui avait de la valeur est déjà parti dans un fichier versionné, et je supprime le reste.
Ça ne tient que si la routine tourne vraiment, et c’est la limite de ma méthode : une discipline régulière que je peux très bien laisser filer, sans que rien ne vienne me le rappeler.
Ma routine mensuelle, en 7 prompts
Mise à jour le 26 juillet 2026.
Je fais tourner cette séquence projet par projet, dans une session dédiée. Un prompt par message, dans cet ordre.
- [ ] /doctor
- [ ] Based on this blog post, how can we take this further?
https://claude.dev/blog/the-new-rules-of-context-engineering-for-claude-5-generation-models/
- [ ] Prefer referencing relevant .md files (rules/docs) over relying on memory.
- [ ] Are the documentation and rules files up to date?
- [ ] What did you keep in memory and why ?
- [ ] Clear the memory.
- [ ] Audit existing documentation and rules, and clean up any obsolete content.
1. /doctor fait le diagnostic de configuration. Depuis la version 2.1.206, il propose aussi un dégraissage du CLAUDE.md : il coupe ce que Claude peut redécouvrir seul dans la codebase (arborescence, dépendances, vue d’ensemble de l’archi) et conserve les pièges et les conventions qui s’écartent des défauts de l’outil.
2. L’article d’Anthropic remet ses principes sur la table, cette fois appliqués par l’agent à sa propre configuration. C’est le passage qui produit les propositions les plus concrètes.
3. Le troisième prompt déclenche la migration : ce qui a une valeur d’équipe quitte la mémoire pour un .claude/rules/ ou un fichier de doc, qui se relit et se discute en PR.
4. La mise à jour des docs confronte le contenu fraîchement remonté au code réel. C’est là que sortent les notes périmées, celles qui décrivent un déploiement qui a changé ou un outil qui a bougé.
5. « What did you keep in memory and why ? » est le prompt que j’ai ajouté le plus tard, et le plus utile. Il force l’agent à justifier chaque note survivante. Une note qu’il n’arrive pas à justifier est une note à supprimer, et vous apprenez au passage ce qu’il croyait important.
6. Clear the memory. vide le dossier, entièrement. C’est l’étape qui fait tiquer, et celle qui rend les cinq précédentes utiles : sans elle, vous avez juste dupliqué la mémoire dans les docs.
7. Le dernier prompt ferme la boucle dans l’autre sens. Les docs aussi pourrissent, et une doc obsolète est le même piège que la mémoire, avec en prime la légitimité du versionnement.
Et chez Codex, la même mémoire mais le défaut inverse
Le sujet ne se limite pas à Claude Code, et l’alternative OpenAi va dans l’autre sens.
Codex a lui aussi une mémoire persistante, dans ~/.codex/memories/. Sauf que local Codex memories are off by default. Il faut aller la chercher, avec un [features] memories = true.
Le réglage n’y est pas binaire non plus. memories.generate_memories décide si la session écrit des notes, memories.use_memories si les notes existantes sont réinjectées.
Depuis la publication de cet article, j’ai commencé à travailler au quotidien avec Codex. J’ai documenté comment faire cohabiter Claude Code et Codex sans dupliquer les instructions. Mais deux éditeurs qui livrent la même fonctionnalité avec des défauts opposés, ça dit surtout que la bonne réponse est encore à trouver.
En résumé, voici ma pratique actuelle entre mémoire et documentation :
- Tout ce qui oriente une décision part dans un fichier versionné. La mémoire garde le contingent, jamais le structurant.
- Une mémoire qui contredit le code est fausse par défaut, pas l’inverse.
- La mémoire se vide, elle ne se corrige pas. Corriger une note, c’est accepter de la relire une fois de plus le mois prochain.
Pour suivre l’évolution de ma stack, l’article Mon adoption de l’IA est mis à jour régulièrement. Et si vous débarquez sur ces sujets côté dirigeant plutôt que côté praticien, commencez par les 9 repères pour passer la vitesse avec l’IA.
Vous pouvez aussi vous abonner :
Poursuivre votre lecture