The components of agent memory : ce qu'Anthropic a mesuré, et ce que ça change pour vos agents
Le 6 novembre 2026, l'équipe Engineering d'Anthropic a publié « The components of agent memory »1. Le billet donne une définition de la mémoire d'agent, une hiérarchie en quatre couches et une série de mesures. La page ne porte pas de signature en tête ; la mention en pied de page indique qu'il a été rédigé par Lance Martin.
Une définition qui exclut beaucoup de choses
Anthropic appelle mémoire d'agent la connaissance que Claude tire de son expérience et conserve entre les sessions, enregistrée sous forme de contexte qu'il peut relire plus tard. Les poids du modèle, l'apprentissage en contexte et la compaction sortent du périmètre1. La mémoire, dans ce cadre, ce sont des fichiers que l'agent écrit, relit et corrige.
Quatre couches, de la plus brute à la plus chère
Le billet empile quatre niveaux1 :
- les transcripts, journal complet des sessions, consultable par recherche ;
- les notes de mémoire, écrites par Claude lui-même ;
- les représentations, par exemple des wikis de pages reliées entre elles ;
- le contexte injecté, chargé à chaque session.
Plus on monte, plus chaque token coûte cher, puisque l'agent le relit à chaque démarrage. Claude Code applique cette discipline : à chaque session, il ne charge que les 200 premières lignes du fichier MEMORY.md, ou ses 25 premiers Ko si cette limite est atteinte avant2.
Les lecteurs de sfeir.com reconnaîtront les trois tiers décrits dans Architecture 3-tier du contexte. Le contexte injecté correspond à la Hot Memory, les notes et les wikis à la Warm Memory, les transcripts à la Cold Memory. Cette correspondance est notre lecture, pas celle d'Anthropic.
Le dreaming : une passe de maintenance hors ligne
Anthropic ajoute une opération au-dessus de la hiérarchie, le dreaming. Entre deux sessions, un agent relit les transcripts, corrige les notes fausses, construit des représentations, promeut certaines notes vers le contexte injecté et comble les trous. Le billet rattache l'idée au « sleep-time compute » proposé par des chercheurs de Letta et de l'université de Californie à Berkeley1.
L'exemple le plus parlant vient de Pokémon Red. Sur un graphique du billet, l'agent dont une note a été corrigée par dreaming atteint Cerulean City à l'action 1 935. Sans la correction, il tourne en rond1.
Ce que disent les chiffres
Tous les chiffres qui suivent viennent d'Anthropic, sans réplication indépendante à ce jour. Plusieurs ne figurent que sur les graphiques du billet.
- CL-Bench 1.0, tâche base de données. Opus 5.5 passe de 0,655 sans mémoire à 0,838 avec mémoire (récompense moyenne). Sonnet 4.6 passe de 0,330 à 0,364, puis à 0,641 avec mémoire et consigne affinée.
- Les règles d'enregistrement fixes coûtent cher. Imposer à Opus 5 de n'enregistrer que ses échecs réduit son gain de mémoire de 0,234 (0,150 pour Opus 4.7, 0,020 pour Sonnet 4.6).
- Neuf fichiers battent 413 fichiers. Sur Pokémon Red, Sonnet 3.7 écrit 413 fichiers dans 225 dossiers et gagne un badge. Fable 5 écrit neuf fichiers dans deux dossiers, plus un global.md, et en gagne quatre. La comparaison porte sur une seule partie de chaque modèle, relevée vers la 10 000e action.
- Le wiki complète la recherche. Sur le corpus Stainless (environ 350 000 fichiers, 420 millions de tokens, 25 questions), le wiki seul passe de 13 % à 48 % des critères quand le dreaming porte sur 2 puis 128 sessions. Wiki et recherche combinés passent de 54 % à 61 %, contre 53 % pour la recherche seule, avec environ 20 000 tokens économisés par question.
- Le wiki aide surtout quand il faut croiser plusieurs documents. Second terrain de test : un dossier de fusion d'entreprises et le benchmark juridique Harvey LAB. Sur 24 questions portant sur la fusion, celles qui demandent de croiser plusieurs documents, de juger ou de calculer obtiennent 87 % avec le wiki, contre 73 % en recherche seule.
- Un wiki peut déraper. Sur une tâche LAB, un corpus de 115 Ko a produit un wiki de 203 Ko, soit 1,77 fois le corpus qu'il devait résumer.
- La consigne de construction compte. Quand plusieurs agents écrivaient dans une même page, 41 faits contractuels sur 57 survivaient dans le wiki. Avec un agent par contrat, citant les termes mot pour mot, les 57 y figurent. Claude a trouvé cette consigne lui-même, dans une boucle où il analysait ses échecs.
Quatre conséquences pratiques
Anthropic résume sa recommandation centrale en une phrase : « We’ve found that it helps to tell Claude what memory is for, but not how to use it »1.
Pour une équipe qui exploite des agents, cela donne quatre décisions :
- Écrire l'objectif de la mémoire et laisser l'agent choisir quoi noter. La règle « n'enregistre que les échecs » a dégradé les résultats.
- Plafonner la couche injectée. Fixer une limite de lignes et la faire respecter en revue.
- Orienter la maintenance vers ce qui change. Anthropic pose la question ouverte de concentrer le dreaming sur l'information susceptible de changer : versions, noms d'environnements, décisions récentes.
- Conserver les transcripts et les rendre cherchables. Toute la pile repose sur eux.
Où cela existe déjà dans les produits
Claude Code distingue les fichiers CLAUDE.md, écrits par l'humain, et l'auto memory MEMORY.md, écrite par l'agent2. Claude Managed Agents propose des memory stores montés en lecture-écriture par défaut, ou en lecture seule3. L'API Dreams, en research preview sur demande depuis le 6 mai 2026, lit un store et de 1 à 100 sessions, puis écrit un nouveau store sans modifier l'original45. Sa documentation la déclare non éligible au HIPAA, et non éligible au ZDR sauf pour les Managed Agents auto-hébergés4.
Ces mémoires vivent chez l'éditeur. La suite de la série traite de l'autre option : garder la copie maîtresse dans un dépôt Git que l'on possède. Voir Posséder sa mémoire d'agent.
Sources
- Anthropic (Engineering, rédigé par Lance Martin), « The components of agent memory », 6 novembre 2026, consulté le 14 novembre 2026. anthropic.com
- Claude Code Docs, « How Claude remembers your project » (CLAUDE.md et auto memory), consulté le 14 novembre 2026. code.claude.com
- Claude Platform Docs, Managed Agents, « Memory », consulté le 14 novembre 2026. platform.claude.com
- Claude Platform Docs, Managed Agents, « Dreams », consulté le 14 novembre 2026. platform.claude.com
- Claude Platform Docs, notes de version du 6 mai 2026 (Dreams en research preview). platform.claude.com
Articles similaires
Posséder sa mémoire d'agent : le dépôt Git comme cerveau partagé entre tous vos agents IA
Claude Code, Codex, Cursor, Hermes, CodeBuddy, WorkBuddy : chaque agent garde sa propre mémoire. Le pattern du dépôt Git de Markdown partagé, ses sources de 2026, ses risques et sa transposition en équipe.
Mémoire d'agent et souveraineté : Git, base managée ou mémoire native de l'éditeur ?
Trois endroits où ranger la mémoire de vos agents IA, six critères pour choisir, et une architecture qui garde la sortie ouverte quand un éditeur change de propriétaire ou de fournisseur.
Architecture 3-Tier du contexte : Hot, Warm et Cold Memory
Le paradoxe du prompt vide : quand 80 % du travail se fait avant d'écrire Une étude portant sur 283 sessions de travail avec des agents IA révèle un chiffre qui devrait faire réfléchir tout architecte logiciel : l'infrastructure contextuelle représente désormais 24,2 % de la doc...
GBrain : la mémoire de Garry Tan, en Markdown et sous licence MIT
GBrain indexe un dépôt de Markdown en graphe interrogeable par vos agents, en CLI et par MCP. Ce que fait l'outil de Garry Tan, ce qu'il laisse à votre charge, et des chiffres à dater (relevés le 14 novembre 2026).