Les fichiers CLAUDE.md donnent à Claude Code des instructions persistantes pour un projet, votre workflow personnel ou votre organisation. Ils sont chargés au début de la session comme contexte, et non comme configuration appliquée de force. Les règles peuvent être réparties dans des fichiers .claude/rules/, éventuellement limités à certains chemins.
Ce qu'il fait
Où CLAUDE.md s'exécute et ce qu'il ajoute, d'après sa documentation
Charge les instructions du projet depuis ./CLAUDE.md ou ./.claude/CLAUDE.md, partagées via le contrôle de version
Prend en charge ~/.claude/CLAUDE.md au niveau utilisateur et ./CLAUDE.local.md privé
Prend en charge un CLAUDE.md de politique gérée pour les instructions à l'échelle de l'organisation
Importe d'autres fichiers avec la syntaxe @path/to/file (profondeur maximale de quatre niveaux)
Répartit les instructions dans .claude/rules/*.md, avec un frontmatter paths optionnel pour des règles limitées à certains fichiers
/init génère un CLAUDE.md de départ à partir de la base de code
Quand l'utiliser
Bonne adéquation
Vous réexpliquez à chaque session les mêmes commandes de build ou conventions
Une équipe veut des standards de code partagés dans le contrôle de version
Une organisation a besoin de politiques d'entreprise appliquées à tous les utilisateurs
Pas pour
Application garantie : la doc recommande un hook PreToolUse pour bloquer des actions
Procédures en plusieurs étapes ou instructions pour un seul domaine : utilisez un skill ou une règle limitée à des chemins
Comment installer CLAUDE.md
Il vous faut : Claude Code
Créez ./CLAUDE.md ou ./.claude/CLAUDE.md à la racine du projet
Ajoutez les commandes de build/test, les conventions et l'organisation du projet, en visant moins de 200 lignes
Ou exécutez /init pour générer un fichier de départ
Exécutez /context et vérifiez la liste des fichiers Memory pour confirmer le chargement
Ajoutez CLAUDE.local.md à .gitignore pour les préférences personnelles
Exemple de configuration (tiré de la documentation officielle)
See @README for project overview and @package.json for available npm commands for this project.
# Additional Instructions
- git workflow @docs/git-instructions.md
Autorisations et sécurité
Notes de sécurité des mainteneurs
Traité comme du contexte, pas comme une configuration appliquée ; utilisez des hooks pour garantir un comportement
Le CLAUDE.md de politique gérée ne peut pas être exclu par les utilisateurs
Examinez la source avant de donner à un agent l'accès à des identifiants ou à des systèmes de production. Nous documentons ce que déclarent les mainteneurs ; nous n'auditons pas le code.
Limites
Les fichiers plus longs consomment plus de contexte et réduisent le respect des instructions ; visez moins de 200 lignes
Des instructions contradictoires peuvent être résolues de façon arbitraire
Les imports ne réduisent pas le coût en contexte, les fichiers importés sont aussi chargés au lancement
Outil de codage agentique d'Anthropic qui lit votre base de code, modifie des fichiers et exécute des commandes depuis le terminal, les IDE ou le navigateur.
La gratuité s'arrête à : Pas d'offre gratuite : Claude Code est inclus dans les abonnements Claude payants (Pro, Max, Team, Enterprise…
Où peuvent se trouver les fichiers CLAUDE.md dans Claude Code ?
Projet : ./CLAUDE.md ou ./.claude/CLAUDE.md ; utilisateur : ~/.claude/CLAUDE.md ; local : ./CLAUDE.local.md ; politique gérée à un chemin système propre à chaque OS. source
Quelle taille un CLAUDE.md doit-il avoir ?
Visez moins de 200 lignes par fichier ; les fichiers plus longs réduisent le respect des instructions. source
Claude Code obéit-il strictement à CLAUDE.md ?
Non. Il est fourni comme contexte, pas comme configuration appliquée ; utilisez des hooks pour les comportements obligatoires. source
Comment exclure un CLAUDE.md dans un monorepo ?
Utilisez le paramètre claudeMdExcludes avec des globs de chemins absolus ; les fichiers de politique gérée ne peuvent pas être exclus. source
