Partie 8 · Organiser ton travail
Le fichier CLAUDE.md en 4 minutes : piloter Claude Code avec des instructions persistantes
Tu sauras créer un fichier CLAUDE.md pour donner à Claude Code des consignes que tu n'auras plus jamais à répéter.
Répéter les mêmes consignes à chaque session de travail finit par te fatiguer. Avec un fichier CLAUDE.md, tu les écris une seule fois et Claude Code les relit tout seul à chaque nouvelle conversation dans ton projet.
Tu y mets tes règles, tes conventions, tes préférences. Tu n'as plus à les répéter à chaque session de travail.
En 4 minutes de lecture, tu vas apprendre où placer ce fichier, ce qu'on y met, et comment l'organiser. Ce chapitre est de niveau avancé : tu peux supposer une habitude minimale du terminal et des fichiers texte.
Chaque terme technique est expliqué. C'est le chapitre 47 d'un manuel complet disponible sur claude-pour-les-debutants.fr.
C'est quoi CLAUDE.md
CLAUDE.md est un simple fichier markdown (un format de texte enrichi) que tu poses à la racine d'un projet de code ou dans ton dossier personnel.
À chaque fois que tu démarres une conversation dans Claude Code (la version terminal de Claude), il lit ce fichier en arrière-plan et garde son contenu en tête pendant toute la session.
Tu peux le voir comme une fiche d'identité du projet que Claude lit en arrivant. Tout nouveau collègue qui rejoindrait l'équipe lirait ce document pour comprendre le contexte ; Claude fait pareil.
→ CLAUDE.md fonctionne uniquement avec Claude Code, pas dans claude.ai web. Pour le web, tu utilises les Projets (chapitre 43) ou Memory (chapitre 44).
✦ Tu peux avoir plusieurs CLAUDE.md à différents endroits selon la portée (juste ce projet, ou tous tes projets, ou toute ton équipe).
Les 4 niveaux où placer ton CLAUDE.md
Tu as 4 emplacements possibles pour ranger un CLAUDE.md, du plus global au plus local.
Le niveau organisation est géré par ton IT si tu travailles en entreprise. Le fichier est dans /Library/Application Support/ClaudeCode/CLAUDE.md sur Mac, ou un équivalent sur Linux et Windows.
Tu ne touches pas à ce niveau en général.
Le niveau utilisateur est ton fichier personnel pour tous tes projets. Il se trouve dans ~/.claude/CLAUDE.md.
Tu y mets tes préférences globales (ton style de code, ta langue préférée, tes outils favoris).
Le niveau projet est partagé avec ton équipe via Git. Il se trouve à la racine du projet, dans ./CLAUDE.md ou ./.claude/CLAUDE.md.
C'est le plus important : tu y mets les conventions du projet.
Le niveau local au projet est juste pour toi sur ce projet, ignoré par Git. Il se trouve dans ./CLAUDE.local.md.
Tu y mets tes notes personnelles sur le projet (raccourcis, particularités de ton setup).
Ce qu'on met dans un CLAUDE.md de projet
Tu organises ton CLAUDE.md de projet en sections claires.
Tu mets d'abord les commandes de base du projet : comment lancer les tests, comment démarrer le serveur, comment installer les dépendances. Claude sait alors quoi lancer quand tu lui demandes "lance les tests".
Tu mets ensuite les conventions de code : indentation (espaces ou tabs), nommage (camelCase ou snake_case), structure des dossiers. Claude respecte ces conventions quand il écrit du code.
Tu mets aussi les règles métier importantes : ne pas toucher à tel module, toujours valider les inputs utilisateur, jamais commit dans la branche main directement.
Tu mets enfin les liens vers la doc : où trouver le README, le changelog, les specs. Claude peut alors aller chercher des infos complémentaires quand tu lui poses une question.
Créer ton premier CLAUDE.md
La méthode la plus simple est d'utiliser la commande /init dans Claude Code.
Tu ouvres Claude Code dans le dossier de ton projet, tu tapes /init dans la conversation. Claude analyse automatiquement ton codebase (le code source du projet), identifie la structure et les conventions, et te propose un CLAUDE.md de départ que tu peux ajuster.
Tu peux aussi créer le fichier à la main avec un éditeur de texte. Tu crées un fichier CLAUDE.md à la racine, tu y écris tes sections, et tu sauvegardes.
Au prochain démarrage de Claude Code, il le lit automatiquement.
▸ Anthropic recommande de garder ton CLAUDE.md sous 200 lignes pour que Claude le respecte bien. Au-delà, il commence à oublier des règles.
Bien écrire les instructions
Tu obtiens de meilleurs résultats avec des instructions précises plutôt que vagues.
L'instruction "formate le code correctement" est trop floue. L'instruction "utilise une indentation de 2 espaces, jamais de tabs" est précise et applicable.
L'instruction "écris des tests" est vague. L'instruction "écris des tests unitaires Jest pour chaque nouvelle fonction publique, dans un fichier .test.js à côté du fichier source" est claire.
→ Plus tu es précis, mieux Claude suit l'instruction.
↳ Tu ajoutes une nouvelle règle à CLAUDE.md à chaque fois que Claude fait 2 fois la même erreur ou que tu te retrouves à répéter la même correction.
Le prompt pour rédiger ton CLAUDE.md
Tu copies ce prompt dans une conversation Claude Code sans CLAUDE.md existant pour qu'il t'aide à le créer.
<role>Tu es un assistant qui m'aide à créer un fichier CLAUDE.md
de projet, structuré et précis, qui guide les futures conversations
de Claude Code dans ce repo.</role>
<context>
Le type de projet : {LANGAGE_FRAMEWORK_OU_DOMAINE}
Mes conventions de code préférées : {INDENTATION_NOMMAGE_STRUCTURE}
Les commandes essentielles du projet : {INSTALL_TEST_BUILD_RUN}
Les règles métier critiques : {INTERDITS_ABSOLUS_OU_FORTEMENT_DECONSEILLES}
</context>
<task>
1. Lance la commande Bash pour scanner la structure du projet
(ls -la, cat README.md, cat package.json).
2. Identifie automatiquement la stack technique et les conventions
visibles dans le code existant.
3. Rédige un CLAUDE.md structuré en 5 sections (Identité, Stack,
Commandes, Conventions, Règles critiques).
4. Garde le fichier sous 150 lignes pour rester lisible.
5. Termine en me proposant 3 améliorations possibles que je
pourrai ajouter au fil de l'usage.
</task>
<constraints>
Sections claires avec headers H2. Pas de paragraphes longs :
préfère des listes à puces. Tout en français sauf les noms
techniques (commandes, paths).
</constraints>
Tu peux remplir cet exemple pour mieux comprendre.
LANGAGE_FRAMEWORK_OU_DOMAINE = projet Next.js TypeScript pour
un site de recettes de cuisine.
INDENTATION_NOMMAGE_STRUCTURE = 2 espaces, camelCase pour les
variables, kebab-case pour les noms de fichiers.
INSTALL_TEST_BUILD_RUN = npm install, npm test, npm run build,
npm run dev (port 3000).
INTERDITS_ABSOLUS_OU_FORTEMENT_DECONSEILLES = jamais commit
de clé API dans le code, toujours valider les inputs des
formulaires côté client ET serveur.
→ Tu reçois un CLAUDE.md prêt à coller à la racine de ton projet.
Importer d'autres fichiers
Tu peux organiser ton CLAUDE.md de manière modulaire avec la syntaxe @chemin/fichier.
Tu écris dans CLAUDE.md une ligne comme @docs/conventions.md ou @README.md. Il charge alors le contenu de ces fichiers en plus du CLAUDE.md.
Tu peux avoir jusqu'à 5 niveaux d'imports imbriqués.
Cette méthode est utile pour éviter qu'un CLAUDE.md devienne trop long. Tu mets les règles génériques dans CLAUDE.md et tu importes les conventions de code détaillées depuis un autre fichier.
# Mon projet
Voir @README pour la vue d'ensemble du projet et @package.json pour
les commandes npm disponibles.
## Règles spécifiques
- Toujours valider les inputs utilisateur
- Tests unitaires obligatoires pour les fonctions publiques
@docs/conventions-detaillees.md
Si Claude n'applique pas ton CLAUDE.md
Claude peut parfois rater une règle de ton CLAUDE.md, surtout s'il est trop long ou si une règle est ambiguë.
Si tu vois qu'il rate une consigne, tu lances la commande /memory dans Claude Code pour vérifier que ton CLAUDE.md a bien été chargé. Tu peux aussi simplifier la formulation de la règle ratée.
Lis le CLAUDE.md du projet et résume-moi en 5 points les règles
les plus importantes que tu as comprises. Si tu vois des règles
contradictoires ou ambiguës, signale-les.
✦ Cette vérification rapide permet de calibrer ton CLAUDE.md en 30 secondes.
Un dernier mot
Un CLAUDE.md bien rédigé fait gagner un temps énorme sur tous les projets de code que tu reprends régulièrement.
La méthode tient en 3 réflexes. Tu crées le CLAUDE.md avec /init puis tu l'ajustes.
Tu y ajoutes une règle à chaque fois que Claude fait 2 fois la même erreur. Tu gardes le fichier sous 200 lignes pour qu'il soit bien respecté.
Tu peux passer au chapitre 48 du manuel sur la fenêtre de contexte, qui explique comment Claude gère la mémoire d'une conversation.
→ Essaie Claude maintenant : claude.ai
→ Chapitre suivant : La fenêtre de contexte de 200k à 1M de tokens
Ce chapitre t'a aidé ?
Sois le premier à donner ton avis.