Comment désactiver la mémoire automatique de Claude Code dans un projet

Pour désactiver la mémoire automatique de Claude Code pour un seul projet, ajoutez "autoMemoryEnabled": false au fichier .claude/settings.json de ce projet. Le bouton de la commande /memory ne convient pas : il écrit le paramètre dans votre fichier global et désactive la mémoire pour tous les projets de votre ordinateur.

Un agent peut vite s’encombrer d’informations dont il n’a pas besoin. Dans le cas décrit ici, Hermes a passé 2 heures à réfléchir à une tâche. À la question « Combien de tokens as-tu utilisés ? », il a répondu : « Mon estimation approximative est de 100 millions. » As-tu résolu la tâche ? « Non, j’ai fait des recherches. » Il a continué à parcourir tous les fichiers un par un et à s’embrouiller.

C’est pourquoi vous ne devriez mettre que les informations les plus précieuses dans la mémoire d’un agent. Et selon l’évaluation présentée ici, la mémoire automatique de Claude Code est assez faible : très petite et fortement compressée. Si vous voulez que Claude suive uniquement vos règles, 1 ligne dans les paramètres du projet suffit.

Voyons en quoi la mémoire automatique diffère de CLAUDE.md, comment la désactiver et que faire des anciennes notes. C’est parti.

Documentation de référence Ailoot : ailoot.ai/docs/.

En quoi la mémoire automatique diffère-t-elle de CLAUDE.md ?#

CLAUDE.md est le fichier principal contenant les instructions, que vous rédigez vous-même. À chaque nouvelle conversation, Claude se demande en quelque sorte : « Qu’y a-t-il ici ? Qui suis-je ? Que dois-je faire ? » Quand tout est précisé dans CLAUDE.md, il se dit : « D’accord, je suis l’expert. Compris. »

Claude écrit lui-même dans sa mémoire automatique. Vous lui dites : « N’oublie pas de toujours répondre dans la langue que je préfère » ou « Ne code pas les valeurs en dur ; récupère-les toujours dans la base de données », et il crée un fichier dans le dossier mémoire, en quelque sorte pour se dire « ne refais plus ça ». Lors des sessions suivantes, il s’en souvient.

Pas toujours, bien sûr. Les agents oublient encore des choses et vous devez garder un œil sur eux : « Écoute, mon ami, tu as encore oublié. On en a déjà parlé. » Il répond : « Ah oui, je m’en souviens ; je l’ai retrouvé ici, dans le fichier. » C’est pourquoi nous mettons généralement toutes les informations importantes dans CLAUDE.md au lieu de nous fier à la mémoire.

Vous trouverez une explication détaillée des règles à mettre dans CLAUDE.md dans un article séparé, et la différence entre Memory dans le chat Claude et CLAUDE.md dans un autre article.

Si vous construisez vos projets avec des agents IA, gardez à portée de main la documentation des outils que vous utilisez.

Ce que Claude écrit de lui-même#

Claude Code enregistre 4 types de notes :

• user — votre rôle, votre expérience et votre manière de travailler préférée ;
• feedback — vos corrections et les approches que vous avez confirmées ;
• project — le travail en cours, les échéances et les décisions qui ne sont pas visibles dans le code ;
• reference — où trouver des informations en dehors du projet, par exemple dans un outil de suivi des tâches.

Tout cela se trouve dans ~/.claude/projects/<project>/memory/. Le fichier principal est MEMORY.md, une table des matières comportant 1 ligne par note. Au début de chaque session, Claude en lit les 200 premières lignes ou 25 KB, puis ouvre les autres fichiers lorsqu’il en a besoin. La mémoire reste sur votre ordinateur : elle n’est transférée ni sur une autre machine ni dans le cloud.

Dans l’exemple décrit ici, elle contient le nom et le rôle de l’utilisateur, ainsi qu’une règle contre le codage en dur des valeurs dynamiques, soit seulement 5–7 lignes au total. Ce sont des règles destinées à l’agent lui-même : elles lui indiquent comment travailler.

Vous pouvez stocker les connaissances du projet dans un second cerveau : des dossiers contenant des fichiers que l’agent consulte grâce à des liens. Pour cette approche, il est utile de définir un skill de « second cerveau » et de garder avec les fichiers du projet un PDF contenant les commandes d’installation de Hermes ainsi qu’un tableau indiquant « quel modèle utiliser pour quelle tâche ».

Comment désactiver la mémoire automatique pour un projet#

1. Ajoutez la ligne aux paramètres du projet

   Le dossier principal du projet contient un dossier caché .claude avec un fichier settings.json. Le plus simple est de demander à Claude Code de le faire lui-même : « Ajoute "autoMemoryEnabled": false au fichier .claude/settings.json de ce projet, et ne touche pas aux autres paramètres. » Si vous l’ouvrez manuellement et que le fichier n’existe pas, créez-le avec ce contenu :

   {
     "autoMemoryEnabled": false
   }
   

   Si le fichier contient déjà des paramètres, ajoutez la clé à côté des autres et ne touchez pas au reste. Lorsque autoMemoryEnabled vaut false, Claude ne lit pas le dossier mémoire et n’y écrit rien.

2. Choisissez à qui s’applique le paramètre

   .claude/settings.json est le fichier partagé du projet ; il s’applique à toutes les personnes qui y travaillent. Si vous souhaitez désactiver la mémoire uniquement pour vous, ajoutez la même clé à .claude/settings.local.json : il s’agit de votre fichier personnel de paramètres pour ce projet.

   Les paramètres du projet ont priorité sur les paramètres globaux. Même si la mémoire est activée dans ~/.claude/settings.json, la valeur false l’emporte pour ce projet.

3. Redémarrez Claude Code

   Fermez la session et exécutez à nouveau claude dans le dossier du projet. Saisissez /status : le fichier du projet doit apparaître sur la ligne Setting sources. S’il y figure, Claude l’a lu. La mémoire restera activée dans le projet voisin.

Il existe 2 autres méthodes, mais elles répondent à des besoins différents :

• La variable d’environnement CLAUDE_CODE_DISABLE_AUTO_MEMORY=1. En exécutant CLAUDE_CODE_DISABLE_AUTO_MEMORY=1 claude, vous désactivez la mémoire pour cette exécution seulement et remplacez la valeur de la clé dans les fichiers de paramètres. Mais vous devez saisir la commande chaque fois.
• Le bouton de /memory. Il écrit autoMemoryEnabled dans ~/.claude/settings.json, votre fichier global pour tous les projets de l’ordinateur. Si vous l’utilisez dans un projet, vous désactivez la mémoire partout.

Encore une chose : dans une session en arrière-plan, le bouton ne peut que désactiver la mémoire, pas la réactiver. Pour l’activer, utilisez une session normale que vous avez démarrée vous-même en exécutant claude dans le terminal.

Que faire des anciennes notes#

La commande /memory répertorie les fichiers mémoire et vous permet de les ouvrir. Ce sont de simples fichiers texte : vous pouvez les modifier ou les supprimer.

Ne les supprimez pas à l’aveuglette ; regardez d’abord ce qu’ils contiennent. Dans le cas décrit ici où un dossier de règles a été nettoyé, l’agent avait consigné des informations inutiles sur l’utilisateur dans le cadre de son autoréflexion. Des règles encombrées sont aussi nuisibles qu’un fichier CLAUDE.md à la racine encombré de règles obsolètes : l’agent continue de les utiliser, hallucine et vous fournit un contexte de moins bonne qualité.

Vous pouvez demander à l’agent de faire le ménage. Une fois par semaine, vous pouvez lui donner une tâche de ce genre pour le dossier professionnel ; elle fonctionne aussi pour le dossier mémoire :

Votre tâche consiste à trouver tout ce qui n’est plus pertinent ou est obsolète, et à prouver que c’est effectivement obsolète. Vous ne devez pas encore le supprimer ; trouvez-le simplement et présentez-le-moi.

Il vous fournit une liste accompagnée de preuves, et vous décidez quoi supprimer. Ne transférez des notes vers CLAUDE.md que les informations les plus précieuses. Vous trouverez une explication sur la façon de garder les instructions courtes pour que Claude les suive dans un article séparé. L’article sur le second cerveau explique comment organiser la mémoire du projet dans son ensemble, avec des dossiers et des règles ici.

Avez-vous laissé la mémoire automatique activée ou l’avez-vous désactivée ? Regardez ce que Claude a retenu à votre sujet. Vous pouvez continuer à découvrir Ailoot sur ailoot.ai.