CLAUDE.md et fichiers de mémoire de Claude Code, expliqués

Claude Code utilise des fichiers Markdown pour ses instructions et sa mémoire. Tu lui donnes des instructions dans CLAUDE.md. Il garde ses propres notes dans des fichiers de mémoire. Et quand tu le lui demandes, il écrit des plans, des spécifications et des rapports sous forme de fichiers .md dans ton projet. Cette page montre où se trouve chaque fichier et comment les lire confortablement.

Les fichiers que Claude Code lit

FichierOùPour
Instructions utilisateur~/.claude/CLAUDE.mdTes préférences, dans tous les projets
Instructions du projet./CLAUDE.md ou ./.claude/CLAUDE.mdLes règles de l’équipe, partagées via Git
Instructions locales./CLAUDE.local.mdTes propres notes pour un projet ; ajoute-le à .gitignore
Règles.claude/rules/*.md (un projet) ou ~/.claude/rules/ (tous les projets)Un sujet par fichier ; peut être limité à certains chemins

Comment ils se chargent. Claude Code lit CLAUDE.md et CLAUDE.local.md dans le dossier où tu le lances et dans tous les dossiers au-dessus. Ils sont combinés, pas remplacés : du dossier le plus haut vers le bas, de sorte que le fichier du dossier où tu as lancé Claude est lu en dernier. Un CLAUDE.md dans un sous-dossier se charge quand Claude commence à travailler avec les fichiers de ce dossier.

Importations. Une ligne comme @docs/style.md intègre un autre fichier dans ton CLAUDE.md.

Reste bref. La documentation recommande moins de 200 lignes par CLAUDE.md. Déplace les règles par sujet dans .claude/rules/.

AGENTS.md

Si un projet a un AGENTS.md (le fichier que lisent Codex et d’autres agents) et n’a ni CLAUDE.md ni CLAUDE.local.md, Claude Code lit AGENTS.md à la place. Si les deux existent, il ne lit par défaut que CLAUDE.md. Pour utiliser un seul fichier pour les deux, importe-le : mets @AGENTS.md dans ton CLAUDE.md. Plus d’informations sur AGENTS.md : page Codex.

La mémoire automatique : les notes que Claude écrit lui-même

La mémoire automatique est activée par défaut. Au fil de son travail, Claude Code enregistre des notes sur toi, tes retours, le projet et l’emplacement des choses. Elles se trouvent dans :

~/.claude/projects/<project>/memory/

MEMORY.md y est l’index ; les 200 premières lignes (ou 25 Ko) se chargent au début de chaque session. Tu peux activer ou désactiver la mémoire automatique avec la commande /memory.

Ce sont de simples fichiers Markdown que tu peux lire et modifier. Vérifie-les de temps en temps : une note erronée affecte chaque nouvelle session jusqu’à ce que tu la corriges ou la supprimes.

Lire ces fichiers sur Mac

Sur Mac, avec PilcrowMD (gratuit, bêta) :

PilcrowMD pour Mac (bêta) · En savoir plus sur la lecture des fichiers d’agents

Questions fréquentes

Claude ignore mon CLAUDE.md. Pourquoi ? Lance /context dans une session et vérifie qu’il figure sous les fichiers de mémoire (Memory files). Les fichiers longs ou contradictoires sont suivis de façon moins fiable.

CLAUDE.local.md doit-il aller dans Git ? Non, il est destiné à tes propres notes. Ajoute-le à .gitignore.

Puis-je lire ces fichiers sur mon téléphone ? Si le dossier du projet est synchronisé avec Google Drive, ajoute-le dans Mes dossiers dans PilcrowMD pour Android. Ouvre une note pour voir sa dernière version ; il n’y a pas de rechargement en direct sur Android.

Aussi sur Mac : PilcrowMD pour Mac (bêta)