Claude Memory : Memory, CLAUDE.md et Auto Memory

Qu’est-ce que la mémoire Claude, et pourquoi comporte-t-elle trois niveaux ?#

Vous ouvrez Claude.ai mardi et lui parlez de votre public, du format de réponse et de votre style d’écriture. Jeudi, vous revenez dans une nouvelle conversation — et Claude s’en souvient déjà. C’est Memory en action.

Vous ouvrez Claude Code dans le terminal, passez deux semaines à comprendre un projet et expliquez l’arborescence des dossiers, les règles de déploiement et vos bibliothèques préférées. Vous fermez la session, la rouvrez une heure plus tard — et l’agent repart de zéro. Memory ne fonctionne pas ici. Pour changer cela, vous avez besoin de CLAUDE.md.

Un troisième niveau est apparu en 2026. Auto Memory dans Claude Code signifie que l’agent rédige lui-même des notes sur votre projet : les commandes qui fonctionnent, les tests qui passent et les chemins sensibles du dépôt. Ces notes sont stockées localement sur votre disque et chargées automatiquement à la session suivante.

La principale source de confusion : on entend dire que « Claude se souvient maintenant » et on pense que cela fonctionne automatiquement partout. Ce n’est pas le cas. Memory de claude.ai n’est pas transféré vers Claude Code — la documentation officielle de Claude Code décrit deux mécanismes de mémoire, et Chat Memory n’en fait pas partie. CLAUDE.md et Auto Memory fonctionnent dans Claude Code : ce sont des systèmes entièrement différents. Il en va de même pour l’API Anthropic : elle dispose d’un outil Memory distinct, sans rapport avec la mémoire du chat.

Ce guide présente les trois systèmes pour que vous sachiez quoi mettre où et pourquoi Claude « oublie » soudainement un projet alors que vous avez pourtant « configuré la mémoire ».

Qu’est-ce que Memory dans Claude.ai, et qui en bénéficie gratuitement en 2026 ?#

Comment Memory recueille les informations

Anthropic appelle ce processus Memory Synthesis. Environ une fois par jour, Claude traite vos conversations récentes, repère ce qui sera utile à long terme et ajoute de courts résumés à votre profil Memory. Il ne s’agit pas de citations mot pour mot de vos messages, mais de formulations condensées comme « l’utilisateur est spécialiste du marketing, dirige un projet en ligne et préfère les réponses courtes sans remplissage ».

Lors de votre prochaine conversation, ces résumés sont automatiquement ajoutés au début du contexte. Claude sait qui vous êtes, ce que vous faites et quel style de réponse vous aimez — sans que vous ayez à le répéter dans chaque chat.

Quels forfaits prennent en charge Memory

Anthropic a déployé Memory par étapes : 11 septembre 2025 — Team et Enterprise ; 23 octobre 2025 — Pro et Max ; 2 mars 2026 — gratuit dans tous les forfaits, avec aussi l’outil d’importation depuis ChatGPT, Gemini et Grok.

C’est important : Memory fonctionne là où il existe une interface Web ou une application mobile Claude.ai. Si vous utilisez Claude dans votre propre code ou depuis la CLI, Memory n’est pas disponible.

Où l’afficher et le modifier

Dans claude.ai : Paramètres → Fonctionnalités → Memory. URL directe : claude.ai/settings/capabilities?modal=memory. Une liste de tout ce que Claude a enregistré à votre sujet s’affiche. Trois boutons :

• Mettre en pause — Claude conserve la mémoire accumulée, mais cesse de l’utiliser et de l’enrichir.
• Réinitialiser la mémoire — efface tout.

  Une fois que vous sélectionnez cette option et cliquez sur « Réinitialiser la mémoire », cette action est irréversible.

• Modifier des entrées individuelles — vous pouvez supprimer manuellement certaines entrées.

Les commandes intégrées fonctionnent directement dans le chat : dites à Claude « souviens-toi de X » ou « oublie Y » — Memory sera mise à jour sans avoir à ouvrir les paramètres.

Un autre point important : les projets dans Claude.ai ont une mémoire distincte.

Cela signifie que les conversations dans un projet ne sont pas intégrées à la mémoire générale, et vice versa.

Vous pouvez poser la question directement à Claude

Dans n’importe quel chat, écrivez : « De quoi te souviens-tu à mon sujet ? » Claude listera ce dont il se souvient pour cette conversation. C’est le moyen le plus rapide de vérifier ce qui a été ajouté à votre profil Memory.

Confidentialité

Anthropic précise explicitement que votre mémoire est privée à votre compte et n’est pas partagée avec d’autres utilisateurs. Par défaut, Anthropic peut utiliser vos conversations (y compris celles qui sont intégrées à Memory) pour améliorer ses modèles. Vous pouvez désactiver cette option dans les paramètres de confidentialité, sous Contrôles des données.

Qu’est-ce que CLAUDE.md dans Claude Code, et en quoi diffère-t-il de Memory ?#

Memory recueille des informations sur vous en tant que personne — votre style, vos préférences et votre profession. CLAUDE.md concerne un projet précis : ce dépôt, ces commandes et ces règles de travail sur le code. La différence est fondamentale : Memory assemble « qui je suis en général », tandis que CLAUDE.md indique « comment ce travail est organisé ».

Où Claude Code cherche CLAUDE.md

À quatre emplacements à la fois, par ordre de priorité croissante :

Les quatre fichiers sont chargés simultanément et concaténés ; ils ne se remplacent pas les uns les autres.

L’ordre va du contexte général au contexte particulier. Projet et Local arrivent en dernier : ils se trouvent donc à la fin du contexte, au plus près de la requête. C’est pourquoi vous devriez placer tout ce qui est essentiel dans le CLAUDE.md du projet.

Ce qu’on y met généralement

• La pile technologique du projet — Next.js / Prisma / PostgreSQL / Redis
• Les commandes — comment lancer les tests, construire et déployer
• Les chemins sensibles — les dossiers à ne pas toucher sans demande explicite
• Les conventions — style de commit, format de nommage des fichiers
• Les règles métier — ce qui compte pour le projet (par exemple, ne jamais coder les prix en dur)
• Les repères de contexte — « pour la logique métier, voir docs/business/ ; pour le système de design, voir docs/design/ » (vous choisissez les noms des dossiers ; l’essentiel est de ne pas tout entasser dans un seul fichier)

Pour une présentation complète, consultez le guide de CLAUDE.md, qui comprend un modèle prêt à l’emploi.

En quoi CLAUDE.md DIFFÈRE de Memory

En une phrase : Memory, c’est votre tête ; CLAUDE.md, ce sont les instructions du projet affichées sur le mur du bureau.

Qu’est-ce qu’Auto Memory dans Claude Code, et où est-il stocké ?#

En quoi Auto Memory diffère de CLAUDE.md

CLAUDE.md contient vos instructions. Auto Memory contient les notes que l’agent rédige pour lui-même. Ce sont des types de contenu différents.

Vous rédigez CLAUDE.md à la main : « réponds toujours dans la langue préférée de l’utilisateur », « publie avec npm run deploy », « ne touche pas au dossier legacy/ ». Ce sont des règles que vous définissez à l’avance.

Auto Memory contient ce que Claude apprend au fil du travail. Il lance un test, qui échoue parce qu’il manque un paquet — Claude note alors : « dans ce projet, exécuter npm install avant les tests ». Il ne répétera pas la même erreur à la session suivante.

Où il est stocké

Localement sur votre disque, dans un dossier distinct pour chaque projet :

~/.claude/projects/[project-name]/memory/

Le fichier principal qui s’y trouve est MEMORY.md. Un détail important : Claude Code charge CLAUDE.md dans son intégralité, mais MEMORY.md est soumis à une limite — seules les 200 premières lignes ou 25KB sont chargées, selon la première limite atteinte. Cela évite que Claude soit submergé par ses propres notes accumulées au fil des mois. Les notes sont conservées dans un dossier local hors du dépôt. Le texte chargé devient du contexte de conversation envoyé au service de modèle configuré ; la persistance locale ne promet pas un traitement hors ligne. N’y placez aucun secret.

Quand il fonctionne

Auto Memory fonctionne dans Claude Code à partir de la version v2.1.59+ et est activé par défaut dans les nouvelles installations. Pour vérifier son état et le gérer, utilisez la commande :

/memory

Cette commande ouvre un éditeur pour tous les niveaux de mémoire — CLAUDE.md et MEMORY.md. Vous pouvez voir ce que Claude a déjà consigné sur votre projet, modifier ces notes ou les effacer. Pour désactiver complètement Auto Memory, définissez autoMemoryEnabled: false dans ~/.claude/settings.json ou utilisez la variable d’environnement CLAUDE_CODE_DISABLE_AUTO_MEMORY=1.

Ce qu’on y met généralement

• Les commandes qui ont fonctionné ou échoué
• La structure du projet que l’agent a comprise
• Les anti-modèles rencontrés
• Les noms des fichiers et fonctions clés

La documentation officielle de Claude Code d’Anthropic décrit directement la différence :

Autrement dit : CLAUDE.md = les instructions que vous écrivez. Auto Memory = les notes que Claude rédige pour lui-même à partir de vos corrections et préférences.

Memory ou CLAUDE.md : quel système convient à quelle tâche ?#

Matrice de décision

Memory et CLAUDE.md ne font pas double emploi. Ils fonctionnent dans des produits différents et stockent des éléments différents. Ils ressemblent à un agenda personnel et à une politique d’entreprise : les deux sont utiles, mais personne ne les confond.

Quand activer Memory : 3 scénarios où il est vraiment utile#

Scénario 1. Vous utilisez claude.ai comme assistant personnel

Vous écrivez à Claude tous les jours : reformuler un e-mail, analyser un tableur, trouver une idée. Les sujets varient, mais vous êtes toujours la même personne. Memory vous évite de dire : « Bonjour, je suis spécialiste du marketing, je dirige un projet en ligne et voici le style de réponse que j’aime. »

Après une semaine d’utilisation, Claude connaît votre profession, votre format de réponse préféré, vos formats favoris, la longueur et le ton qui vous conviennent. Chaque nouvelle conversation commence avec ces éléments. Vous gagnez 30–60 secondes par conversation.

Scénario 2. Vous rédigez beaucoup de contenu dans le même style

Publicités, publications pour les réseaux sociaux, lettres d’information par e-mail — toujours la même voix de marque. Memory apprendra votre style : les mots à éviter, le ton à employer et la longueur des paragraphes.

Une fois, sur quelques semaines, dites à Claude : « dans nos textes, pas de tirets cadratins, un ton amical, pas plus de 3 paragraphes ». Cette préférence sera enregistrée. Chaque nouveau texte respectera ensuite votre style, sans rappel.

Scénario 3. Vous avez besoin du contexte de votre rôle

Vous êtes designer avec une pile spécifique — Figma + Sketch, pas Photoshop. Vous êtes chef de produit SaaS, pas dans le commerce en ligne.

Memory prendra en compte ce contexte lié à votre rôle et adaptera automatiquement ses réponses. Vous obtiendrez moins de réponses génériques et davantage de réponses adaptées à votre travail précis.

Quand Memory n’est pas nécessaire

Si vous travaillez principalement avec Claude Code dans le terminal, Memory ne vous apporte rien. Elle n’y fonctionne tout simplement pas. Utilisez plutôt CLAUDE.md et ne confondez pas les deux systèmes.

Si vous utilisez Claude via l’API dans votre code, elle n’y fonctionne pas non plus. Ajoutez les instructions manuellement au prompt système.

Si vous n’avez qu’un seul type de tâche et que cela ne vous dérange pas de répéter le contexte au début de chaque conversation, Memory n’est pas essentielle. C’est pratique, mais pas indispensable.

Que mettre dans CLAUDE.md, et que Auto Memory recueillera-t-il automatiquement ?#

Ce qui doit figurer dans CLAUDE.md

1. Description du projet en un paragraphe — de quoi il s’agit, à qui il s’adresse et pourquoi.
2. Technologies du projet — les frameworks, bibliothèques et bases de données utilisés.
3. Commandes — tests, compilation, publication. Les commandes exactes.
4. Répertoires sensibles — ceux auxquels il ne faut pas toucher sans demande explicite.
5. Conventions — style des commits, format de nommage des fichiers, langue des réponses.
6. Repères de contexte — par exemple : « la logique métier se trouve dans docs/business/ ; le design, dans docs/design/ ». Vous choisissez les noms des dossiers.

Ce que vous pouvez laisser à Auto Memory

1. Détails de l’environnement local — sur cette machine, Python se trouve dans /usr/local/bin/python3.11.
2. Modifications du projet — quelle commande a échoué hier et pourquoi.
3. Découvertes intermédiaires — où se trouvent les tests d’un module particulier.
4. Conseils sur le flux de travail — quel script lancer après quelle étape.

Ce qui ne doit figurer ni dans l’un ni dans l’autre

• Clés d’API, mots de passe, jetons — ils vont dans .env, pas dans des fichiers de mémoire.
• Données personnelles des clients.
• Informations susceptibles de devenir rapidement obsolètes (prix, dates de cohortes, campagnes temporaires).
• Prompts pour des tâches ponctuelles — ils encombrent le contexte.

La règle des 200 lignes

Dans sa documentation, Anthropic recommande de limiter CLAUDE.md à environ 100–200 lignes. Au-delà de 200 lignes, Claude la lit moins efficacement — un contexte trop long consomme des ressources et réduit la précision. Quand le fichier s’allonge, déplacez des sections dans des fichiers .md distincts à proximité et gardez de courts repères dans CLAUDE.md : « pour le style du code, voir docs/code-style.md ».

Pour une présentation détaillée de la structure du fichier, consultez le guide du second cerveau pour Claude Code, qui explique comment la structure évolue de CLAUDE.md à cinq dossiers de contexte.

Quelles sont les 5 erreurs qui compromettent la mémoire de Claude, et comment les éviter ?#

Erreur 1. Confondre Memory et CLAUDE.md

C’est l’erreur la plus courante. Quelqu’un entend dire que « Claude se souvient maintenant », active Memory dans claude.ai, puis ouvre Claude Code dans le terminal et se demande pourquoi l’agent a de nouveau « tout oublié ».

Memory dans claude.ai n’est pas transféré vers Claude Code. Ce sont des produits différents, aux architectures différentes. Pour que Claude se souvienne d’un projet dans le terminal, écrivez CLAUDE.md. Pour que Claude se souvienne de vous dans le navigateur, activez Memory.

Comment éviter cette erreur. Avant de configurer la mémoire, décidez où vous travaillez principalement. Si c’est claude.ai, utilisez Memory. Si c’est Claude Code, utilisez CLAUDE.md et Auto Memory. Si vous utilisez les deux, configurez les deux systèmes au lieu d’essayer de les combiner.

Erreur 2. Oublier que les noms de fichiers respectent la casse

Le nom de fichier CLAUDE.md est sensible à la casse. Le fichier en majuscules CLAUDE.md sera lu par l’agent. claude.md et Claude.md ne le seront pas. Il en va de même pour CLAUDE.local.md. C’est une erreur typique chez les personnes qui configurent Claude Code pour la première fois : elles créent un fichier, y inscrivent des instructions et se demandent pourquoi cela ne fonctionne pas, alors que le nom du fichier est en minuscules.

Comment éviter cette erreur. Vérifiez la casse avant l’enregistrement. Sur Mac, sélectionnez le fichier dans le Finder et appuyez sur Entrée : le nom complet apparaîtra. Dans le terminal : ls -la CLAUDE*. Si le résultat affiche claude.md, renommez-le : mv claude.md CLAUDE.md.

Erreur 3. CLAUDE.md a atteint 800 lignes

Vous prenez un modèle prêt à l’emploi, ajoutez toutes les règles qui semblent importantes et vous vous retrouvez avec un fichier de 800 lignes. Claude met alors plus de temps à le lire, tandis que la qualité de ses réponses baisse. Un contexte trop long accapare l’attention du modèle.

Comment éviter cette erreur. Limitez CLAUDE.md à environ 100–200 lignes. Au-delà de 200, déplacez des sections dans des fichiers .md distincts et gardez des repères dans CLAUDE.md : « pour le style du code, voir docs/code-style.md ». C’est le même principe que pour toute documentation destinée aux humains : ne mettez pas tout dans un seul fichier.

Erreur 4. Conserver des secrets dans CLAUDE.md ou Auto Memory

Les clés d’API, mots de passe et jetons ne doivent pas figurer dans les fichiers de mémoire. CLAUDE.md est généralement validé dans git, et les secrets risquent donc de se retrouver dans le dépôt. Auto Memory est stocké localement, mais son contenu pourrait apparaître dans une capture d’écran, une conversation partagée ou une fuite via un serveur MCP ayant accès au disque.

Comment éviter cette erreur. Conservez les secrets dans .env (et ajoutez .env à .gitignore). Dans CLAUDE.md, mentionnez uniquement les noms des variables : « clé API dans STRIPE_KEY ; la récupérer depuis .env. »

Erreur 5. S’attendre à ce qu’Auto Memory découvre seule votre logique métier

Auto Memory recueille des observations techniques — commandes, erreurs et structure. Elle n’apprendra pas seule les règles métier (« pour une agence immobilière, ne pas accepter les commandes en dessous d’un certain seuil », « éviter certains termes dans les textes »). Celles-ci doivent figurer dans CLAUDE.md ou dans des fichiers .md distincts référencés par CLAUDE.md.

Comment éviter cette erreur. Séparez ces éléments : les détails techniques sont ajoutés automatiquement à Auto Memory. Saisissez à la main dans CLAUDE.md les règles métier, le style et les conventions. Ne vous attendez pas à ce que l’un remplace l’autre.

Comment configurer Memory + CLAUDE.md en une soirée (guide étape par étape) ?#

1. Activez Memory dans Claude.ai. Ouvrez Paramètres → Fonctionnalités → Memory. Activez le commutateur. Vérifiez tout de suite les paramètres de confidentialité : décidez si Anthropic peut utiliser vos conversations pour entraîner ses modèles. C’est vous qui choisissez.

2. Parlez à Claude de vous. Dans vos 2–3 prochaines conversations, dites-lui qui vous êtes, ce que vous faites et quel style de réponse vous aimez. Memory Synthesis enregistrera ces informations dans la journée.

3. Vérifiez le lendemain ce qui a été enregistré. Dans n’importe quel chat, écrivez : « De quoi te souviens-tu à mon sujet ? » Claude listera ses souvenirs. Si un élément ne vous convient pas, supprimez-le dans Paramètres → Memory ou demandez à Claude de l’oublier.

4. Créez CLAUDE.md dans votre projet. À la racine de votre projet principal, créez un fichier nommé CLAUDE.md (avec des majuscules). Le modèle prêt à l’emploi du guide de CLAUDE.md comporte 6 sections et la longueur recommandée est d’environ 200 lignes, selon Anthropic.

5. Remplissez les sections correspondant à votre projet. Décrivez la pile technologique, les commandes, les chemins sensibles et les conventions. Pas plus de 200 lignes — au-delà, Claude lira le fichier moins efficacement.

6. Vérifiez Auto Memory. Dans Claude Code, saisissez la commande /memory. Un éditeur pour tous les niveaux s’ouvrira. Auto Memory en fait partie. Consultez ce que Claude sait déjà de votre projet.

7. Validez CLAUDE.md dans git. Ce fichier fait partie du projet. Si vous travaillez en équipe, tout le monde verra les règles.

8. Continuez à travailler comme d’habitude. Après chaque erreur de l’agent, ajoutez une ligne dans CLAUDE.md indiquant « ne fais pas ça ». Au bout d’un mois, vous aurez un ensemble de règles vivant, et Claude ne tombera plus dans les pièges habituels.

Ce qui ne fonctionne pas : 3 éléments que la mémoire de Claude ne retient pas#

L’état de la session n’est pas conservé lors du changement de modèle

Vous travaillez dans Claude Code avec Opus 4.8, puis passez à Sonnet 4.6 : le contexte de la session peut être réinitialisé, car les modèles ont des fenêtres de contexte différentes. CLAUDE.md et Auto Memory seront automatiquement chargés dans la nouvelle session, mais pas la discussion en cours.

Les fichiers que vous n’avez pas montrés ne sont pas chargés

Claude ne voit que ce qui se trouve dans CLAUDE.md, ce qui figure dans Auto Memory et ce que vous avez explicitement ouvert dans la session en cours. Si votre projet comporte 500 fichiers et que vous écrivez « regarde comment je gère les paiements », l’agent ne sait pas quel fichier examiner. Vous devez indiquer explicitement le chemin ou ajouter un repère dans CLAUDE.md.

Memory ne fonctionne pas pour les conversations ponctuelles via l’API

Chaque requête à l’API Claude est isolée. Aucune mémoire n’est chargée. Si vous créez un chatbot via l’API, vous transmettez manuellement le prompt système et l’historique des messages. Memory, CLAUDE.md et Auto Memory ne vous aident pas dans ce cas.

Et ensuite : la mémoire comme point de départ d’un Second Brain#

CLAUDE.md et Auto Memory donnent à Claude des repères sur l’organisation du code. C’est suffisant pour les tâches techniques : refactorisations, bugs, migrations et tests.

Mais dès que vous devez prendre des décisions métier — à qui envoyer un e-mail, comment formuler une offre ou quel prix fixer — la mémoire technique ne suffit pas. Il vous faut du contexte : qui sont vos clients, comment prennent-ils leurs décisions et comment fonctionne l’économie de votre activité ?

C’est le Second Brain — un dossier de connaissances métier à côté du projet, auquel Claude accède grâce aux repères figurant dans CLAUDE.md. Mémoire du code plus mémoire de l’activité : l’agent cesse d’être « un assistant intelligent qui hallucine » et devient votre coauteur.