CLAUDE.md

Il contient ce que l'agent doit savoir sans qu'on le lui répète : commandes de compilation et de test, conventions, décisions d'architecture et choses à éviter. Claude Code lit le fichier du projet (./CLAUDE.md ou ./.claude/CLAUDE.md), celui des préférences personnelles (~/.claude/CLAUDE.md) et, le cas échéant, un fichier administré par l'organisation. Il réunit ces instructions au lieu de laisser un fichier en remplacer un autre. Les fichiers des sous-répertoires arrivent plus tard, quand Claude y lit un fichier.

Le coût se sous-estime facilement. Le fichier entre dans la session comme un message placé après le prompt système. Chaque requête renvoyant tout le contexte, chaque ligne se paie à chaque tour : moins cher tant que le cache tient, au tarif normal ou au-dessus quand il faut le reconstruire. Une section utile une fois par mois est donc facturée à toutes les requêtes de toutes les sessions.

En septembre 2026, la documentation d'Anthropic recommande moins de 200 lignes par fichier : les fichiers longs occupent davantage de contexte et les consignes sont moins bien suivies. Les imports @path rangent le texte sans réduire sa taille, car ils chargent aussi le fichier au démarrage. Déplacez plutôt les procédures spécialisées vers des skills ou des règles limitées à certains chemins. Les notes destinées aux mainteneurs peuvent aller dans des commentaires HTML en bloc, retirés avant l'envoi au modèle.

Deux comportements méritent attention. Le fichier à la racine du projet survit à /compact, car Claude Code le relit sur disque. Une modification pendant la session n'est prise en compte qu'après /clear, /compact ou un redémarrage. La commande /context montre les fichiers de mémoire effectivement chargés.