Aller au contenu
Mastering Claude

Accueil / Une installation structurée

Une installation structurée9 minApplication

CLAUDE.md global, une constitution

Le CLAUDE.md global cible désormais une longueur en lignes plutôt qu'en kilo-octets, et il ne prend pas le pas sur les autres CLAUDE.md par écrasement : les quatre échelles, gérée, utilisateur, projet, locale, se concatènent dans le contexte du plus large au plus spécifique.

La documentation actuelle de Claude Code cible une longueur en lignes pour un CLAUDE.md, pas un poids en kilo-octets : moins de 200 lignes par fichier, relevé le 2 septembre 2026, parce qu'un fichier plus long consomme plus de contexte et réduit l'adhérence aux règles qu'il contient. Un plafond dur séparé existe en plus de cette cible, un fichier de plus de 4 Mio est purement ignoré, mais ce plafond ne sert pas de cible à viser, seulement de limite à ne jamais approcher.

Un empilement, pas un écrasement

Un CLAUDE.md global n'agit pas seul. La documentation distingue quatre échelles chargées dans un ordre précis, du plus large au plus spécifique : la politique gérée par une organisation, les instructions utilisateur du fichier ~/.claude/CLAUDE.md, les instructions de projet du fichier à la racine du dépôt, puis les instructions locales du fichier CLAUDE.local.md. Ces quatre fichiers, quand ils existent, sont concaténés dans le contexte plutôt que de s'écraser les uns les autres : celui qui est chargé en dernier est simplement lu en dernier par le modèle, il ne supprime rien de ce qui précède.

# CLAUDE.md global, extrait (moins de 200 lignes au total)
## Règles absolues
- Ne jamais committer sans qu'on le demande explicitement.
## Routine de session
- Lire la mémoire de fichiers avant de répondre à la première question.
## Pointeurs
- Voir skills/ pour les workflows récurrents du projet en cours.

Régénérer plutôt que réécrire à vide

La commande /init génère un CLAUDE.md de départ en analysant réellement le dépôt ouvert, commandes de build, instructions de test, conventions découvertes. Si un CLAUDE.md existe déjà, /init propose des améliorations au lieu de l'écraser. Une variable d'environnement récente, CLAUDE_CODE_NEW_INIT=1, active un mode interactif en plusieurs phases qui explore le dépôt par sous-agent avant de proposer un fichier à valider, absent des versions plus anciennes de la commande.

Avant chaque réécriture du fichier global, archivez la version que vous remplacez plutôt que de l'écraser : c'est la seule façon de revenir en arrière si la nouvelle version supprime une règle qui comptait. La carte du module situe cette constitution comme le deuxième des sept éléments, juste après le moteur installé et connecté à la leçon précédente.

Figure 1

L'ordre de chargement d'un CLAUDE.md, du plus large au plus spécifique

01
Politique gérée
Le périmètre le plus large, posé par une organisation, chargé en premier dans le contexte.
02
Instructions utilisateur
Le fichier ~/.claude/CLAUDE.md, valable pour tous les projets d'une même personne, chargé en second.
03
Instructions de projet
Le fichier CLAUDE.md à la racine du dépôt ouvert, chargé en troisième.
04
Instructions locales
Le fichier CLAUDE.local.md, le plus spécifique, chargé en dernier et lu en dernier par le modèle.
Les quatre fichiers ne s'écrasent pas entre eux quand ils existent tous, ils se concatènent dans le contexte selon cet ordre, et le dernier chargé est simplement lu en dernier par le modèle, pas le seul appliqué.
Calibrez vous-même

Une développeuse ouvre son fichier CLAUDE.md global et compte 340 lignes. Elle déplace la moitié du contenu vers une note séparée, puis relance une session dans un dépôt où un CLAUDE.md de projet existe déjà à la racine.

Écrivez en une phrase ce que cette situation établit, et en une phrase ce qu'elle n'établit pas.

Ce qu’il faut retenir
  • La cible de longueur d'un CLAUDE.md tient désormais en lignes, moins de 200, plutôt qu'en kilo-octets, avec un plafond dur séparé de 4 Mio au-delà duquel le fichier entier est ignoré.
  • Les quatre échelles de CLAUDE.md, politique gérée, utilisateur, projet, local, ne s'écrasent pas entre elles, elles se concatènent dans le contexte selon un ordre du plus large au plus spécifique.
  • Un fichier local chargé en dernier n'annule aucune règle posée par les fichiers plus larges, il vient simplement s'ajouter après elles dans ce que le modèle lit.
  • La commande /init génère un CLAUDE.md à partir d'une analyse réelle du dépôt ouvert, et propose des améliorations plutôt que d'écraser un fichier déjà présent.
  • Archiver la version remplacée avant chaque réécriture du CLAUDE.md global reste le seul moyen de revenir en arrière si la nouvelle version supprime une règle qui comptait.
À faire maintenant

Ouvrez votre CLAUDE.md global maintenant et comptez ses lignes avec votre éditeur : au-delà de 200, déplacez le surplus vers une note pointée par le fichier plutôt que de le laisser grossir, et archivez la version que vous remplacez avant d'écrire la nouvelle.

Vérifier à la source

Chaque affirmation datable de cette leçon renvoie ici au texte public qui la porte. Une source qui ne s’ouvre pas ne prouve rien.