Les fichiers que Claude Code lit
| Fichier | Où | Pour |
|---|---|---|
| Instructions utilisateur | ~/.claude/CLAUDE.md | Tes préférences, dans tous les projets |
| Instructions du projet | ./CLAUDE.md ou ./.claude/CLAUDE.md | Les règles de l’équipe, partagées via Git |
| Instructions locales | ./CLAUDE.local.md | Tes 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) :
- Ajoute le dossier de ton projet dans Mes dossiers. Les fichiers que Claude Code écrit, comme les plans, les spécifications et les rapports, apparaissent marqués N (nouveau) ou U (mis à jour). Une note ouverte se recharge quand Claude Code ou une autre application la modifie.
- Surligner les modifications montre ce qui a changé dans un fichier que tu as déjà lu : en bleu pour ce qui est ajouté, en orange pour ce qui est supprimé ou modifié. Pratique pour un
MEMORY.mdou un plan que Claude met à jour en continu. - Comparer côte à côte montre deux versions. Avec l’historique des fichiers activé, Fichier › Afficher l’historique… te permet de revenir à une version antérieure.
~/.claudeest un dossier caché. Dans le panneau d’ouverture, appuie sur ⌘⇧. (Commande-Maj-point) pour afficher les dossiers cachés.- Aucune connexion Internet ; tes notes restent sur ton Mac.
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)