Le fichier CLAUDE.md est la mémoire permanente de Claude Code dans ton projet. C'est lui qui indique à l'IA comment travailler avec ton codebase, quelles conventions respecter, quels outils utiliser. Boris Cherny, le créateur de Claude Code chez Anthropic, a partagé le sien — et c'est une mine d'informations.
Quand tu lances Claude Code dans un dossier, il lit automatiquement le CLAUDE.md à la racine du projet. Ce fichier contient tes instructions persistantes : stack tech, patterns de code préférés, commandes importantes, règles de nommage, contexte métier.
Sans lui, Claude repart de zéro à chaque session. Avec lui, il connaît ton projet comme un dev senior qui travaille dessus depuis des mois.
L'essentiel de son CLAUDE.md tient en quatre règles. La troisième est celle qui change tout sur la durée.
Avant d'écrire la moindre ligne de code, Claude écrit le plan. Et si l'exécution dérape en cours de route, il ne bricole pas : il s'arrête et il refait le plan. Un plan écrit est vérifiable, un plan implicite ne l'est pas.
Le travail long ou exploratoire (fouiller un gros codebase, tester dix pistes) part dans un sous-agent. Le contexte principal reste propre et concentré sur la décision, pas sur le bruit de la recherche.
C'est la règle qui compose dans le temps. Chaque erreur commise devient une règle écrite dans le fichier. La session suivante la lit et ne refait pas l'erreur. Au bout de quelques semaines, le taux d'erreur s'effondre — parce que ton fichier a mémorisé tout ce qui a mal tourné.
Aucune tâche n'est déclarée terminée sans que les tests aient été lancés. Pas « ça devrait marcher » : la sortie des tests, ou rien.
La règle 3 ne marche que si tu écris la règle au moment de l'erreur, pas « plus tard ». Une erreur non écrite est une erreur qui reviendra à la session suivante, parce que Claude repart d'un contexte vide à chaque fois.
Colle ça dans un fichier CLAUDE.md à la racine de ton projet, puis adapte la section Stack et Commandes à ton cas.
CLAUDE.md à la racine = instructions globales du projetsrc/CLAUDE.md = instructions spécifiques au code source~/.claude/CLAUDE.md = règles globales pour tous tes projetsCommence par un CLAUDE.md minimal, puis enrichis-le au fil des sessions. Chaque fois que Claude fait une erreur de convention, ajoute une règle pour que ça n'arrive plus jamais.