Introduction Claude MD
Bascule de l'interface web vers le terminal.
Le fichier qui donne à Claude le contexte de votre projet.
Un agent IA a besoin d'un onboarding
Comme un nouveau collaborateur
Sans contexte, il devine. Parfois bien, parfois mal. Un nouveau salarié reçoit un onboarding. Un agent reçoit un CLAUDE.md.
Document à la racine du projet
Texte simple, une à deux pages. Décrit le but, les conventions, les commandes utiles, les pièges à éviter.
Lecture automatique
Claude Code détecte le fichier au démarrage. Le contexte est chargé sans rien à faire.
Gain immédiat
Sur les tâches répétées et structurantes — refactos, ajouts de feature, corrections de bug. Plus le projet vit, plus le gain s'accumule.
Le squelette d'un CLAUDE.md efficace
Vue d'ensemble
Trois lignes sur ce que fait le projet et pour qui. Pas un cours, juste l'essentiel.
Stack technique
Langages, frameworks, services tiers utilisés. La carte d'identité technique.
Commandes
Démarrage, build, tests, déploiement. Les commandes que vous tapez dix fois par jour.
Conventions de code
Formatage, nommage, structure de dossiers. Ce qui doit rester cohérent.
Pièges connus
Les choses qui paraissent évidentes mais qui ne le sont pas.
Ne pas faire
Les modifications interdites, les fichiers à ne pas toucher. Garde-fous explicites.
Créer le fichier
À la racine du projet, fichier nommé CLAUDE.md en majuscules.
Rédiger les 6 rubriques
Dans VS Code. Une page max. Résister à l'exhaustivité.
Lancer claude
Dans le terminal. La session démarre, le CLAUDE.md est lu.
Tester le contexte
« Lance les tests. » Claude propose la commande du CLAUDE.md.
Une règle simple, des variantes utiles
Racine du projet
Fichier CLAUDE.md (majuscules). Claude Code le détecte automatiquement au démarrage.
Sous-dossiers
Vous pouvez en mettre dans des modules. Claude lit le plus proche du fichier édité. Pratique pour conventions différentes par module.
Les Projects
Sur claude.ai, le contenu d'un CLAUDE.md type peut être collé dans le champ Instructions du Project, et les fichiers de référence dans la Knowledge base.
Quatre principes à internaliser
Court avant exhaustif
Un CLAUDE.md de 5 pages que personne ne maintient est moins utile qu'un d'une page tenu à jour.
Versionné dans Git
Le fichier vit avec le code. Toute modification passe par la même revue que le code.
Mis à jour aux jalons
Quand vous changez une convention, ajoutez une dépendance, découvrez un piège. 3 minutes maintenant, 30 minutes économisées plus tard.
Factuel, pas didactique
« Tests : npm test », pas « Pour lancer les tests, ouvrez un terminal et tapez la commande... »