Mémoire automatique dans le code Claude

Problème : ton fichier CLAUDE.md est bien en place avec les règles du projet, mais Claude ne cesse de te poser les mêmes questions sur les commandes de compilation, les conventions de test et les bizarreries de débogage. Les instructions indiquent ce que tu veux que Claude fasse, mais elles ne tiennent pas compte de ce que Claude a déjà appris sur ton dépôt.

Astuce rapide : Vérifie si la mémoire automatique est déjà active. Dans n'importe quelle session Claude Code, exécute /memory. Un sélecteur s'ouvre, affichant tes fichiers CLAUDE.md et un bouton pour activer/désactiver la mémoire automatique. Ce bouton est activé par défaut, ce qui signifie que Claude a discrètement pris des notes sur ton projet pour toi.

# Find your project's auto memory directory
ls ~/.claude/projects/

Tu vois les répertoires listés ? Claude a des notes en attente. Continue à lire pour découvrir ce qu’elles contiennent, comment les utiliser et comment elles s’intègrent à ton système CLAUDE.md. Si tes fichiers de mémoire te semblent surchargés après de nombreuses sessions, jette un œil à Auto Dream, la fonctionnalité de consolidation qui nettoie et réorganise tout ce que la mémoire automatique écrit.

Qu'est-ce que la mémoire automatique, au juste ?

La mémoire automatique est un dossier persistant dans lequel Claude enregistre ses apprentissages, ses schémas et ses observations pendant qu'il travaille. Voici la distinction essentielle : CLAUDE.md contient tes instructions à l'intention de Claude. MEMORY.md contient les notes que Claude prend pour lui-même au sujet de ton projet.

CLAUDE.md est l'endroit où tu écris des choses comme « utilise pnpm, pas npm » ou « écris les tests avant le code ». La mémoire automatique est l'endroit où Claude note ses propres observations : « la commande de compilation est pnpm build, les tests se trouvent dans __tests__/, API utilise Express avec un middleware dans src/middleware/. »

Ne confonds pas ça avec la mémoire de session, qui stocke des résumés au niveau de la conversation pour pouvoir les consulter d'une session à l'autre. La mémoire automatique fonctionne à un niveau plus profond. Elle contient des connaissances durables sur le projet qui restent là, peu importe la conversation qui les a créées.

Trois systèmes de mémoire, côte à côte

Claude Code utilise désormais trois systèmes de mémoire distincts. Savoir lequel utiliser t'évite de refaire deux fois le même travail ou de choisir le mauvais outil.

La meilleure configuration consiste à faire fonctionner les trois ensemble. CLAUDE.md définit les règles. La mémoire automatique enregistre ce que Claude apprend au fur et à mesure. La mémoire de session conserve le fil conducteur entre les sessions.

Où se trouvent les fichiers

Chaque projet dispose de son propre dossier de mémoire, ancré à la racine du dépôt Git :

~/.claude/projects/<project>/memory/
├── MEMORY.md          # Main index, loaded every session
├── debugging.md       # Detailed debugging patterns
├── api-conventions.md # API design decisions
└── ...                # Any topic files Claude creates

Quelques détails de stockage à connaître :

• La racine du dépôt Git définit le chemin du projet. Tous les sous-répertoires d'un même dépôt partagent un dossier de mémoire. Si tu lances Claude depuis src/api/, tu accèdes à la même mémoire que si tu le lançais depuis la racine du dépôt.
• Chaque arborescence de travail Git dispose de son propre dossier. C'est voulu. Les différentes arborescences de travail contiennent généralement des branches différentes à des états différents.
• En dehors d'un dépôt Git, le répertoire de travail joue le rôle de racine du dépôt.

Ce qui est enregistré

Pendant que Claude travaille sur ton projet, il classe ses notes dans quelques catégories :

Modèles de projet : commandes de compilation, conventions de test, choix de style de code. Lance ta suite de tests une fois et Claude enregistre la commande ainsi que les éventuels indicateurs spéciaux nécessaires.

Informations de débogage : corrections de bugs complexes et causes d'erreurs courantes. Tu passes du temps à résoudre un problème CORS ou un nœud de configuration Webpack ? Claude note la solution.

Notes d'architecture : fichiers clés, relations entre les modules, abstractions importantes. Claude cartographie le terrain une fois pour toutes afin de ne pas avoir à redécouvrir ta structure à chaque session.

Tes préférences : comment tu communiques, tes habitudes de travail, tes outils préférés. Claude remarque les schémas sur lesquels tu t'appuies.

MEMORY.md fonctionne comme un index succinct. À mesure que les notes s’accumulent, Claude transfère les détails dans des fichiers thématiques tels que debugging.md ou patterns.md. Cela permet de maintenir le fichier principal sous la barre des 200 lignes, puisque seules les 200 premières lignes sont chargées au démarrage.

Comment l'utiliser

Laisse-le simplement tourner

La solution la plus simple : ne touche à rien. La mémoire automatique est activée par défaut. Claude lit et écrit des fichiers en mémoire en arrière-plan pendant que tu travailles. Tu le remarqueras pendant tes sessions lorsque Claude modifie des fichiers dans le dossier de mémoire.

Enregistrer quelque chose de spécifique

Dis clairement à Claude ce qu’il doit stocker :

"remember that we use pnpm, not npm"
"save to memory that the API tests require a local Redis instance"
"note that the staging environment uses port 3001"

Claude les place immédiatement dans le fichier de mémoire approprié.

Parcourir et modifier

Au cours d'une session, exécute /memory pour ouvrir le sélecteur de fichiers de mémoire. Celui-ci répertorie tous les fichiers de mémoire (CLAUDE.md, mémoire automatique, configuration locale) et te permet d'ouvrir n'importe lequel d'entre eux dans l'éditeur de ton système.

Tu peux aussi les lire depuis le shell :

# List all memory files for a project
ls ~/.claude/projects/<project>/memory/
 
# Read the main memory index
cat ~/.claude/projects/<project>/memory/MEMORY.md
 
# Read a specific topic file
cat ~/.claude/projects/<project>/memory/debugging.md

Ce sont des fichiers Markdown simples. Modifie-les quand tu veux. Supprime les entrées obsolètes. Réorganise-les au fur et à mesure que le projet évolue.

Configuration et contrôle

La mémoire automatique est activée par défaut. Voici tous les paramètres que tu peux régler :

Activation par session

Lance /memory et active ou désactive la mémoire automatique. C'est le moyen le plus rapide de l'activer ou de la désactiver pour ton flux de travail actuel.

Désactiver pour tous les projets

Ajoute ceci dans tes paramètres utilisateur :

// ~/.claude/settings.json
{ "autoMemoryEnabled": false }

Désactiver pour un projet

Ajoute ceci dans les paramètres du projet :

// .claude/settings.json
{ "autoMemoryEnabled": false }

Remplacement de variable d'environnement

CLAUDE_CODE_DISABLE_AUTO_MEMORY prend le pas sur tous les autres paramètres. C'est le choix idéal pour les pipelines de CI, l'automatisation et les déploiements gérés :

export CLAUDE_CODE_DISABLE_AUTO_MEMORY=1  # Force off
export CLAUDE_CODE_DISABLE_AUTO_MEMORY=0  # Force on

Cela remplace à la fois le bouton « /memory » et « settings.json », donc ça fonctionne comme un véritable « kill switch ».

Quand choisir quoi

Trois systèmes de mémoire, un cadre de décision :

Opte pour CLAUDE.md quand tu veux des règles strictes. Normes de codage, choix d'architecture, commandes obligatoires, conventions d'équipe. CLAUDE.md se charge entièrement au démarrage et a une priorité élevée. Si tu veux qu'un modèle soit suivi à chaque fois, c'est là qu'il faut le mettre.

Opte pour la mémoire automatique quand tu veux que Claude s'adapte au fur et à mesure. Les modèles qui émergent pendant le travail réel, les corrections de débogage, les préférences discrètes. Tu n'as pas besoin de tout planifier à l'avance.

Utilise la mémoire de session quand tu as besoin de continuité dans la conversation. La mémoire de session conserve le fil de ce dont tu as discuté et décidé lors de chaque session. C'est la couche « qu'avons-nous fait hier ».

Utilise le répertoire « rules » lorsque ton fichier CLAUDE.md est devenu trop volumineux pour un seul fichier. Divise tes instructions en fichiers ciblés sous « .claude/rules/ » pour une structure plus claire sans perdre en priorité.

Le chevauchement est volontaire. La mémoire automatique récupère ce que tu as oublié de mettre dans CLAUDE.md. La mémoire de session conserve le contexte que les notes au niveau du projet ne peuvent pas contenir. Empile-les et tu obtiendras une mémoire en couches couvrant les règles, les connaissances du projet et l'historique des conversations.

Bonnes pratiques

Garde MEMORY.md sous les 200 lignes. Seules les 200 premières lignes se chargent au démarrage. Claude est invité à rester concis en plaçant les détails dans des fichiers thématiques. Si tu modifies à la main, respecte la même limite.

Relis tes fichiers de mémoire de temps en temps. Comme toutes les notes, elles deviennent obsolètes. Après une refonte majeure ou un changement d'architecture, parcoure les fichiers et supprime ce qui n'est plus d'actualité.

Évite les doublons entre CLAUDE.md et la mémoire automatique. Si quelque chose doit être une règle, mets-le dans CLAUDE.md. S'il s'agit d'un modèle susceptible d'évoluer, laisse la mémoire automatique s'en charger.

Enregistre explicitement les éléments critiques. Quand tu résous un bug tenace ou que tu finalises une décision architecturale importante, dis à Claude de s’en souvenir. Ne compte pas sur Claude pour tout repérer tout seul.

Désactive l'auto memory dans CI. L'automatisation n'a pas besoin que Claude accumule des notes sur ton environnement de build. Définis CLAUDE_CODE_DISABLE_AUTO_MEMORY=1 dans ta configuration CI.

Associe-la à l'ingénierie contextuelle. La mémoire automatique n'est qu'une couche d'une stratégie d'ingénierie contextuelle plus large. Plus tu prends soin de ce que Claude sait au démarrage, plus chaque session t'apporte en retour.

Prochaines étapes

• Configure ton système de mémoire CLAUDE.md pour des instructions de projet persistantes
• Comprends la mémoire de session pour assurer la continuité des conversations entre sessions
• Apprends les stratégies de gestion du contexte pour travailler dans les limites de tokens
• Explore le répertoire des règles pour des instructions de projet modulaires
• Découvre l'ingénierie de contexte pour les systèmes de mémoire d'AIs de production

La mémoire automatique comble le fossé entre ce que tu dis à Claude et ce que Claude déduit par lui-même. CLAUDE.md détient les règles « fais-le comme ça ». La mémoire automatique détient les connaissances « j'ai remarqué ceci à propos de ton projet ». Exécute-les ensemble et tu auras moins à t'expliquer et plus à livrer.