Gardez Claude concentré : l'astuce du fichier CLAUDE.md

Lorsque vous passez d'une session Claude Code à une autre, vous devez généralement réexpliquer de zéro la structure de votre projet, vos conventions de codage et vos décisions d'architecture. Cela fait perdre du temps et conduit à des résultats incohérents. Le fichier CLAUDE.md résout ce problème en jouant le rôle de mémoire persistante de Claude.

CLAUDE.md est un fichier markdown que vous placez à la racine de votre projet (./CLAUDE.md). Claude Code le lit automatiquement au début de chaque session et l'intègre à sa fenêtre de contexte comme instructions permanentes. Vous pouvez y inclure votre stack technique, vos conventions de nommage, vos exigences de tests, vos politiques de sécurité et toute règle d'architecture que votre équipe suit.

Pour commencer, créez un fichier CLAUDE.md avec les informations essentielles : le nom de votre projet, votre stack technique (React 18, Node.js, PostgreSQL), les répertoires clés et toute convention non négociable (« Toujours utiliser le mode strict de TypeScript », « Écrire les tests avant le code »). Limitez-le à 300-800 mots. Pour les équipes plus importantes, créez des règles spécifiques au projet dans des sous-répertoires .claude/rules/ et maintenez un fichier racine plus petit. Claude charge également un fichier global ~/.claude/CLAUDE.md pour les préférences personnelles applicables à tous les projets.

Exemple de workflow : une équipe chargée du traitement des paiements ajoute à son CLAUDE.md : « Backend : Node.js + Express. Base de données : PostgreSQL avec sécurité au niveau des lignes. Sécurité : tous les champs de montant doivent être des entiers (en centimes, pas en décimales). Toutes les API exigent des jetons d'authentification. » Désormais, chaque session avec Claude Code connaît automatiquement ces contraintes. Lorsque vous demandez à Claude d'écrire un nouvel endpoint, il génère un code qui respecte ces règles sans que vous ayez à les mentionner à chaque fois.