Mémoire automatique dans le code Claude

Problème : Ton CLAUDE.md est en place avec les règles du projet, mais Claude ne cesse de demander les mêmes choses à propos des commandes de construction, des conventions de test et des bizarreries de débogage. Les instructions couvrent ce que tu veux que Claude fasse. Elles ne tiennent pas compte de ce que Claude a déjà appris sur ton répertoire.

Quick Win : Vois si la mémoire automatique est déjà en cours d'exécution. Dans n'importe quelle session de Claude Code, lance /mémoire. Un sélecteur s'ouvre, montrant tes fichiers CLAUDE.md et un interrupteur de mémoire automatique. L'interrupteur est activé par défaut, ce qui signifie que Claude a tranquillement pris des notes sur le projet à ta place.

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

Tu vois des répertoires dans la liste ? Claude a des notes qui t'attendent. Continue à lire pour savoir ce qu'elles contiennent, comment les utiliser et comment elles s'intègrent à ton système CLAUDE.md. Si tes fichiers de mémoire sont trop volumineux après de nombreuses sessions, regarde Auto Dream, la fonction de consolidation qui nettoie et réorganise tout ce qu'Auto Memory écrit.

Ce qu'est réellement la mémoire automatique

La mémoire automatique est un dossier persistant dans lequel Claude enregistre les apprentissages, les modèles et les idées pendant qu'il travaille. En voici les principaux éléments : CLAUDE.md est ton instruction à Claude. MEMORY.md est la note que Claude se donne à lui-même à propos 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 construction est pnpm build, les tests vivent dans __tests__/, l'API utilise Express avec le middleware dans src/middleware/."

Ne confonds pas cela avec la mémoire de session, qui stocke des résumés au niveau de la conversation pour les rappeler d'une session à l'autre. La mémoire automatique fonctionne à un niveau plus profond. Elle contient des connaissances durables sur le projet qui restent en place quelle que soit la conversation qui les a créées.

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

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

La meilleure configuration fait fonctionner les trois ensemble. CLAUDE.md établit les règles. La mémoire automatique enregistre ce que Claude apprend en cours de route. La mémoire de session conserve le fil entre les sessions.

Où vivent les fichiers

Chaque projet reçoit son propre dossier de mémoire, ancré à la racine du repo 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 sur le stockage qui valent la peine d'être connus :

• La racine du repo git est ce qui définit le chemin du projet. Chaque sous-répertoire à l'intérieur du même repo partage un dossier mémoire. Lance Claude à partir de src/api/ et tu auras la même mémoire qu'à partir de la racine du repo.
• Les arbres de travail Git ont chacun leur propre dossier. C'est voulu. Différents arbres de travail contiennent généralement différentes branches dans différents états.
• En dehors d'un repo git, le répertoire de travail joue le rôle de la racine du repo.

Ce qui est écrit

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

Modèles de projet : commandes de compilation, conventions de test, choix de style de code. Exécute ta suite de tests une fois et Claude enregistre la commande ainsi que les drapeaux spéciaux dont il a eu besoin.

Instructions de débogage : corrections de bogues délicats et racines d'erreurs courantes. Tu passes du temps à chercher un problème de CORS ou un nœud de configuration de webpack ? Claude note la solution.

Notes sur l'architecture : fichiers clés, relations entre les modules, abstractions importantes. Claude cartographie le territoire une fois pour ne pas avoir à redécouvrir ta disposition à chaque session.

Tes préférences : ta façon de communiquer, tes habitudes de travail, tes choix d'outils. Claude remarque les modèles sur lesquels tu t'appuies.

le fichier MEMORY.md fonctionne comme un petit index. Au fur et à mesure que les notes s'accumulent, Claude déplace les détails dans des fichiers thématiques comme debugging.md ou patterns.md. Cela permet de maintenir le fichier principal à moins de 200 lignes, puisque seules les 200 premières lignes sont chargées au démarrage.

Comment l'utiliser

Laisse-le tourner

Le chemin le plus facile : laisse-le fonctionner. La mémoire automatique est activée par défaut. Claude lit et écrit les fichiers de mémoire en arrière-plan pendant que tu travailles. Tu le remarqueras pendant les sessions lorsque Claude touchera les fichiers à l'intérieur du dossier de mémoire.

Sauvegarder quelque chose de spécifique

Indique clairement à Claude ce qu'il doit enregistrer :

"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 dépose tout de suite dans le bon fichier mémoire.

Parcourir et éditer

Au cours d'une session, lance /memory pour ouvrir le sélecteur de fichiers de mémoire. Celui-ci liste 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 l'interpréteur de commandes :

# 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

Il s'agit de simples fichiers markdown. Modifie-les quand tu veux. Supprime les entrées qui ne sont plus d'actualité. Réorganise-les au fur et à mesure que le projet grandit.

Configuration et contrôle

La mémoire automatique est activée par défaut. Voici tous les boutons que tu peux tourner :

Commutation par session

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

Tuer pour chaque projet

Ajoute ceci à tes paramètres d'utilisateur :

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

Kill It For One Project

Dépose ceci dans les paramètres du projet :

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

Remplacement de la variable d'environnement

CLAUDE_CODE_DISABLE_AUTO_MEMORY bat tous les autres paramètres. C'est le bon choix pour les pipelines 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 la bascule /memory et settings.json, et fonctionne donc comme un interrupteur d'arrêt d'urgence.

Quand chercher quoi

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

recherche CLAUDE.md quand tu veux des règles strictes. Normes de codage, appels d'architecture, commandes requises, conventions d'équipe. CLAUDE.md se charge entièrement au démarrage et se trouve en haute priorité. Si tu veux qu'un modèle soit suivi à chaque fois, c'est ici que ça se passe.

**Si tu veux que Claude prenne les choses en main au fur et à mesure, c'est ici qu'il faut le faire. Les modèles qui font surface pendant le travail réel, les corrections de débogage, les préférences discrètes. Tu n'as pas besoin de tout prévoir à l'avance.

**Tu peux faire appel à la mémoire de session lorsque tu as besoin de la continuité d'une conversation. La mémoire de session conserve le fil de ce que vous avez discuté et décidé lors de chaque session. C'est la couche "qu'avons-nous fait hier".

**Tu peux faire appel au répertoire des règles lorsque ton CLAUDE.md est trop volumineux pour un seul fichier. Divise tes instructions en fichiers ciblés sous .claude/rules/ pour une structure plus propre sans perdre la priorité.

Le chevauchement est volontaire. La mémoire automatique récupère les choses que tu as oublié de mettre dans CLAUDE.md. La mémoire de session porte le contexte que les notes au niveau du projet ne peuvent pas porter. En les empilant, tu obtiens une mémoire en couches couvrant les règles, la connaissance du projet et l'historique des conversations.

Meilleures pratiques

**Garde MEMORY.md en dessous de 200 lignes ** Seules les 200 premières lignes se chargent au démarrage. On dit à Claude de rester concis en poussant les détails dans les fichiers de sujets. Si tu édites à la main, respecte le même plafond.

**Comme toutes les notes, elles deviennent périmées. Après un grand remaniement ou un changement d'architecture, passe en revue les fichiers et supprime ce qui n'est plus vrai.

Ne fais pas de double emploi entre CLAUDE.md et la mémoire automatique. Si quelque chose doit être une règle, mets-la dans CLAUDE.md. S'il s'agit d'un modèle qui risque de se déplacer, laisse la mémoire automatique s'en charger.

**Lorsque tu découvres un bogue désagréable ou que tu verrouilles un appel d'architecture important, dis à Claude de s'en souvenir. Ne parie pas sur le fait que Claude attrape tout tout seul.

**L'automatisation n'a pas besoin que Claude empile des notes sur ta boîte de construction. Mets CLAUDE_CODE_DISABLE_AUTO_MEMORY=1 dans ta configuration CI.

**La mémoire automatique est une couche d'une stratégie d'ingénierie contextuelle plus large. Plus tu apportes de soin à ce que Claude sait au démarrage, plus chaque session te le rendra.

Prochaines étapes

• Configure ton système de mémoire CLAUDE.md pour des instructions de projet persistantes
• Comprendre la mémoire de session pour assurer la continuité des conversations d'une session à l'autre
• Apprends les stratégies de gestion du contexte pour travailler dans les limites des jetons
• Explore le répertoire de règles pour des instructions de projet modulaires
• En savoir plus sur l'ingénierie contextuelle pour les systèmes de mémoire d'IA de production

La mémoire automatique comble le fossé entre ce que tu dis à Claude et ce que Claude élabore tout seul. CLAUDE.md possède les règles "fais-le comme ça". La mémoire automatique possède les connaissances "J'ai remarqué ceci à propos de ton projet". Fais-les fonctionner ensemble et tu t'expliques moins et tu expédies plus.