CLAUDE.md : où le placer et quelle taille lui donner ?
CLAUDE.md est relu à chaque session : trop long, il coûte à chaque tour. Voici où le placer et comment le garder court, d’après la documentation de Claude Code.
Où le placer
| Portée | Emplacement |
|---|---|
| Vous, sur tous vos projets | ~/.claude/CLAUDE.md |
| Le projet, partagé avec l’équipe | ./CLAUDE.md ou ./.claude/CLAUDE.md |
| Le projet, pour vous seul | ./CLAUDE.local.md |
| L’organisation (macOS) | /Library/Application Support/ClaudeCode/CLAUDE.md |
Comment il est chargé
Au lancement, Claude Code lit les fichiers CLAUDE.md du dossier de travail et de tous les dossiers au-dessus, et les met bout à bout. Ceux des sous-dossiers ne se chargent que quand Claude y travaille. Un fichier de plus de 4 Mio est ignoré.
La syntaxe @chemin/vers/fichier importe un autre fichier, sur quatre niveaux au plus. Mais les imports entrent dans le contexte dès le démarrage : ils rangent, ils n’allègent pas.
Le garder court
- Visez moins de 200 lignes par fichier, comme le recommande Anthropic.
- Déplacez les procédures longues dans des skills : elles ne se chargent que quand elles servent.
- Gardez l’essentiel : conventions, commandes de build et de test, pièges connus.
Questions fréquentes
CLAUDE.md compte-t-il dans mes limites ?
Il fait partie du contexte envoyé au modèle, donc il pèse sur chaque tour, même s’il est souvent relu depuis le cache à prix réduit.
CLAUDE.md survit-il au compactage ?
Oui : après un compactage, Claude Code le recharge.