Aller au contenu
Mastering Claude

Accueil / Fondamentaux et boucle d'agent

Fondamentaux et boucle d'agent10 minFondation

CLAUDE.md, la mémoire du projet

CLAUDE.md est lu automatiquement au début de chaque session sur le dépôt où il se trouve, et ses règles sont lues comme du contexte, sans garantie d'application stricte.

CLAUDE.md est un fichier texte posé à la racine d'un dépôt. Claude Code le lit automatiquement au début de chaque session ouverte sur ce dépôt, sans que personne n'ait besoin de le mentionner. Le fichier est livré comme un message utilisateur après le prompt système, pas comme une partie du prompt système lui même : Claude lit ces règles et tente de les suivre, sans garantie stricte de conformité. Pour bloquer une action quel que soit ce que Claude décide, il faut un hook PreToolUse plutôt qu'une ligne de CLAUDE.md.

Ce que produit /init

La commande /init lance une analyse réelle du dépôt courant, pas la recopie d'un modèle générique. Elle parcourt la structure des dossiers, les scripts déclarés dans les fichiers de configuration et les conventions déjà en place, puis propose un premier jet de CLAUDE.md à partir de ce qu'elle trouve. Ce premier jet reste à relire et à couper : un fichier court avec des règles absolues sert mieux qu'une longue description de ce que le dépôt contient déjà par ailleurs.

# Commandes
npm test lance la suite de tests
npm run build produit le dossier dist

# Conventions
Les composants React vivent dans src/components, un fichier par composant

# Règles absolues
Ne jamais committer le dossier dist
Toujours passer par npm run lint avant un commit

Une variante plus large derrière une variable d'environnement

Au 2026-09-02, activer la variable d'environnement CLAUDE_CODE_NEW_INIT=1 avant de lancer /init déclenche un parcours interactif plus large que le seul CLAUDE.md : il couvre aussi les skills, les hooks et les fichiers de mémoire personnels, et propose d'importer la configuration d'un autre agent détecté dans le dépôt, par exemple un fichier AGENTS.md déjà présent. Sans cette variable, /init garde son comportement habituel et ne produit qu'un CLAUDE.md.

Pourquoi un fichier court gagne

Un CLAUDE.md chargé en entier à chaque session pèse sur le contexte disponible pour le reste de la tâche. Les règles qui comptent vraiment sont celles qui, absentes, feraient perdre du temps ou produiraient une erreur : la commande exacte pour lancer les tests, l'endroit où vivent les composants, ce qu'il ne faut jamais committer. Le reste, l'historique du projet ou la liste complète des dépendances, se retrouve mieux dans un fichier lu à la demande que dans une mémoire chargée à chaque tour de la boucle d'agent, et une commande dédiée permet aussi de vérifier ce qui est réellement chargé dans la session en cours, voir les commandes slash essentielles.

Figure 1

Deux comportements de /init

Périmètre couvert par /initCe qui est analyséCe qui est proposé
Sans CLAUDE_CODE_NEW_INIT=1Le code source et la structure du dépôtUn fichier CLAUDE.md
Avec CLAUDE_CODE_NEW_INIT=1Le dépôt, plus les skills, les hooks et la mémoire personnelle déjà présentsUn parcours interactif qui peut importer la configuration d'un autre agent détecté
La même commande produit un résultat différent selon qu'une variable d'environnement précise est active ou non au moment où elle est lancée.
Calibrez vous-même

Une développeuse lance /init dans un dépôt où la variable d'environnement CLAUDE_CODE_NEW_INIT=1 est active. Claude Code analyse le contenu du dépôt, engage un parcours interactif qui pose des questions sur les skills et les hooks présents, puis propose un fichier CLAUDE.md à valider.

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

Ce qu’il faut retenir
  • CLAUDE.md se lit automatiquement au début de chaque session sur le dépôt où il se trouve, sans qu'il faille le signaler.
  • Les règles écrites dans CLAUDE.md sont lues comme du contexte au début de session, sans garantie d'application stricte : ce qui doit être garanti passe par un hook.
  • La commande /init analyse réellement le dépôt courant pour produire un premier jet, ce n'est pas un modèle générique recopié.
  • Activer CLAUDE_CODE_NEW_INIT=1 avant /init déclenche un parcours interactif qui couvre aussi les skills, les hooks et la mémoire personnelle.
À faire maintenant

Lancez /init dans un dépôt existant, relisez le fichier CLAUDE.md proposé, et supprimez toute ligne qui décrit ce que vous pourriez retrouver en lisant le code plutôt qu'une règle absolue ou une commande exacte.

Ce qui reste à vérifier

Ces points dépendent d’une interface ou d’une règle qui peut avoir changé depuis la rédaction. Vérifiez-les sur votre propre écran avant de vous y fier.

  • La date exacte d'introduction de la variante CLAUDE_CODE_NEW_INIT=1 n'a pas été retrouvée, seule sa présence au 2026-09-02 est confirmée.
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.