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.
Voir le CLAUDE.md de celui qui a conçu l'outil te donne les bonnes pratiques directement depuis la source. Tu comprends comment l'outil est pensé pour être utilisé.
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.