CLAUDE.md

CLAUDE.md est un fichier markdown d'instructions persistantes que Claude lit au DÉBUT de chaque session. Emplacements vérifiés, dans l'ordre de chargement du plus général au plus spécifique : politique gérée (/Library/Application Support/ClaudeCode/CLAUDE.md sur macOS, /etc/claude-code/CLAUDE.md sur Linux et WSL, C:\Program Files\ClaudeCode\CLAUDE.md sur Windows) ; instructions utilisateur (~/.claude/CLAUDE.md) ; instructions de projet (./CLAUDE.md ou ./.claude/CLAUDE.md) ; instructions locales (./CLAUDE.local.md, qui doit être ignoré par git). Tous les fichiers découverts sont CONCATÉNÉS dans le contexte plutôt que de se remplacer mutuellement, en remontant l'arborescence des répertoires à partir de votre répertoire de travail. Les fichiers peuvent en importer d'autres avec la syntaxe @path/to/import, relative au fichier importateur, avec une profondeur maximale de quatre sauts. Cependant, les importations ne sauvegardent pas le contexte, car les fichiers importés se chargent également au lancement. Visez moins de 200 lignes : les fichiers plus longs consomment plus de contexte et réduisent l'adhérence.

Fait mécanique clé : le contenu de CLAUDE.md est livré comme un message utilisateur APRÈS l'invite système, et non comme faisant partie de celle-ci. Claude le lit et essaie de le suivre, mais il n'y a aucune garantie de conformité stricte. C'est du contexte, pas une configuration forcée. Pour bloquer une action quelles que soient les décisions de Claude, utilisez plutôt un hook PreToolUse. Exécutez /init pour générer un CLAUDE.md de départ. Le CLAUDE.md de la racine du projet survit à la compaction : après /compact, Claude le relit depuis le disque et le réinjecte. Ce mécanisme est lié à la manière dont les fichiers agents-md fournissent des instructions persistantes pour les agents. Contrairement à un fichier de configuration strict, CLAUDE.md fonctionne davantage comme un ensemble de directives dans la fenêtre de contexte, influençant le comportement mais sans l'imposer rigoureusement. Considérez-le comme une forme d'auto-mémoire qui persiste entre les sessions.