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... »
À tout de suite en leçon 12
Vous savez créer un CLAUDE.md utile, le placer au bon endroit, le tenir à jour. C'est le sésame de Claude Code en environnement projet.
Exercice — appropriation
Choisissez un dossier de votre disque dur sur lequel vous travaillez actuellement — code, documents projet, dossier client. Rédigez son CLAUDE.md avec les six rubriques. Si vous travaillez en équipe, faites-le relire par un collègue qui connaît ce dossier ; sinon, relisez-le vous-même à 24 h d'intervalle.
Quiz · Introduction Claude MD
8 questions · une seule bonne réponse par question · vous pouvez recommencer autant de fois que nécessaire.
Quel est le rôle d'un fichier CLAUDE.md ?
CLAUDE.md est l'onboarding de l'agent : un document à la racine du projet qui décrit le but, les conventions, les commandes utiles, les pièges à éviter.
Où placer CLAUDE.md ?
À la racine du projet, fichier nommé CLAUDE.md en majuscules. Claude Code le détecte automatiquement à chaque démarrage.
Vous pouvez avoir plusieurs CLAUDE.md dans des sous-dossiers d'un même projet.
Vrai. Claude lit celui qui est le plus proche du fichier qu'il édite. Pratique pour avoir des conventions différentes par module (frontend vs backend par exemple).
Quelles sont les 6 rubriques utiles d'un bon CLAUDE.md ?
Six rubriques : Vue d'ensemble (3 lignes), Stack technique, Commandes (build/tests/deploy), Conventions de code, Pièges connus, Ne pas faire. Une à deux pages maximum.
Plus le CLAUDE.md est long et exhaustif, mieux c'est.
Faux. Court avant exhaustif. Un CLAUDE.md de 5 pages que personne ne maintient est moins utile qu'un d'une page tenu à jour. Une à deux pages maximum.
Quel équivalent fonctionnel a CLAUDE.md sur claude.ai ?
Sur claude.ai, l'équivalent s'appelle les Projects. 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.
Faut-il commiter CLAUDE.md dans Git ?
Versionné dans Git. Le fichier vit avec le code. Toute modification passe par la même revue que le code. C'est ce qui en fait un asset d'équipe.
CLAUDE.md doit être rédigé de manière didactique, comme un cours.
Faux. Factuel, pas didactique. « Tests : npm test », pas « Pour lancer les tests, ouvrez un terminal et tapez la commande... ». Le fichier n'est pas un cours, c'est une fiche de référence.