Jusqu'à présent, tu as guidé Claude Code en lui donnant des instructions précises dans tes prompts.

C'est très bien, mais cela pose un problème majeur : si tu dois lui rappeler chaque jour que tu préfères écrire tes commentaires en français, tu vas vite perdre du temps.

C'est là qu'intervient le fichier CLAUDE.md.

1. Le cerveau de ton projet

Le fichier CLAUDE.md est un simple fichier texte que tu places à la racine (à la base) de ton dossier de projet.

Le ".md" signifie "Markdown", ce qui est juste un format de texte facile à lire.

Dès que tu lances Claude Code, il cherche ce fichier en priorité. S'il le trouve, il le lit comme une bible de consignes avant même de te dire bonjour.

Astuce

Ce fichier est lu automatiquement et en permanence. C'est le moyen idéal pour donner des règles définitives que Claude ne devra jamais oublier.

2. Pourquoi ce fichier est-il indispensable ?

Sans ce fichier, Claude Code agit comme un bon programmeur, mais un programmeur générique.

Il va utiliser des conventions standards, écrire des variables comme il en a l'habitude, et structurer le code à sa façon.

Avec le fichier CLAUDE.md, il devient ton programmeur personnel. Les réponses qu'il te donnera seront dix fois plus précises, car il connaîtra tes préférences à l'avance.

3. Que mettre à l'intérieur ?

Ce fichier est ton espace personnel. Tu peux y écrire ce que tu veux en français naturel. Voici les sections les plus utiles pour un débutant :

  • L'objectif du projet : Explique brièvement ce que fait l'application.
  • L'architecture : Dis-lui où se trouvent les images, où sont les composants, et où est la base de données.
  • Les règles strictes : Ce qu'il ne doit jamais faire (ex: ne jamais utiliser telle technologie).
  • Les commandes : Comment lancer ton projet sur ton ordinateur.

4. Exemple de fichier CLAUDE.md

Voici à quoi ressemble un fichier CLAUDE.md simple mais extrêmement efficace :

Ce simple fichier va changer la donne. Désormais, chaque fois que tu demanderas à Claude de créer un composant, il sera petit, avec des variables "const", et commenté en français. Sans que tu aies besoin de le lui répéter.

5. Les bonnes pratiques

Il est tentant de mettre des centaines de règles dans ce fichier. C'est une erreur.

Si ton fichier est trop long, Claude risque d'ignorer certaines règles. Reste simple et va à l'essentiel.

Bonnes pratiques
  • Garde ce fichier sous les 50 lignes.
  • Utilise des tirets pour lister tes règles clairement.
  • Écris des phrases courtes et directes.
  • Mets-le à jour dès que tu changes ta façon de travailler.

6. FAQ

C'est fortement recommandé. Chaque projet a ses propres règles. Ce qui est valable pour ton site vitrine ne l'est pas forcément pour ton application e-commerce.
Oui. Dès que tu lances Claude Code, il vérifie si un fichier CLAUDE.md existe. Si c'est le cas, il le lit et le garde en mémoire pendant toute la conversation.
Oui. Claude est intelligent. S'il remarque que tu as modifié le fichier CLAUDE.md, il relira les nouvelles règles pour s'y adapter immédiatement.
Absolument ! Tu peux lui dire : 'Analyse mon projet et crée un fichier CLAUDE.md adapté à mes habitudes'. C'est un excellent moyen de commencer.

Le fichier CLAUDE.md est parfait pour les règles générales d'un projet. Mais que faire si tu as des règles plus spécifiques, ou des comportements que tu souhaites partager avec toute ton équipe ? C'est ce que nous allons voir avec les Rules personnalisées.

Chapitre terminé