CLAUDE.md (Claude Code) : emplacement et lecture par les outils

CLAUDE.md est le fichier mémoire que Claude Code charge au démarrage depuis votre répertoire personnel, le projet et chaque répertoire parent. Les règles associées à des chemins dans .claude/rules/ fournissent des consignes supplémentaires, chargées uniquement lors de la lecture de fichiers correspondants.

Emplacement

• Projet : ./CLAUDE.md ou ./.claude/CLAUDE.md, versionné et partagé avec l’équipe.
• Local : ./CLAUDE.local.md, pour les notes personnelles à exclure de git.
• Utilisateur : ~/.claude/CLAUDE.md, appliqué à tous les projets.
• Règles : ./.claude/rules/**/*.md et ~/.claude/rules/**/*.md, avec une portée pouvant être définie à l’aide du frontmatter paths.
• Politique gérée : /Library/Application Support/ClaudeCode/CLAUDE.md sur macOS, C:\Program Files\ClaudeCode\CLAUDE.md sur Windows, ou la clé claudeMd dans managed-settings.json.

Format

Markdown. Les fichiers dans .claude/rules/ peuvent commencer par un frontmatter YAML dont la clé paths contient des globs. Incluez d’autres fichiers avec @path/to/file, jusqu’à 4 niveaux de profondeur. Aucune limite de taille stricte n’est documentée, mais Anthropic recommande de ne pas dépasser 200 lignes par fichier.

Clés du frontmatter : paths

@AGENTS.md

# Claude Code notes

- Run `pnpm test` after every change under src/.
- Use the `gh` CLI for issues and pull requests.
- Ask before adding a dependency.

## API

- Error format is described in @docs/api-errors.md.
- One handler file per route in src/api/.

Priorité et fusion

Aucun fichier ne remplace un autre : tous les fichiers détectés sont concaténés. La politique gérée est chargée en premier, puis les fichiers du système de fichiers, de la racine jusqu’au répertoire de lancement ; les fichiers les plus proches sont donc lus en dernier. Dans un même répertoire, CLAUDE.local.md est lu après CLAUDE.md. Les fichiers des sous-répertoires sont chargés à la demande, lorsque Claude y lit des fichiers. La politique gérée ne peut pas être exclue avec claudeMdExcludes.

Outils qui le lisent

Conseils

• Si vous conservez un CLAUDE.md, commencez-le par @AGENTS.md ; sinon, avec le paramètre par défaut, Claude Code ignore AGENTS.md.
• Placez les consignes propres à une zone dans .claude/rules/ et utilisez le frontmatter paths pour qu’elles ne soient chargées que pour les fichiers concernés.
• Les imports organisent le fichier, mais consomment tout de même du contexte, car le texte importé est également chargé.
• Exécutez /doctor pour vérifier en une seule fois CLAUDE.md, CLAUDE.local.md, AGENTS.md, les règles et les skills.

Autres fichiers d’instructions