Introduction Claude MD
À l'issue de cette leçon, le stagiaire comprend le rôle d'un fichier CLAUDE.md et sait en rédiger un, propre à son projet, qui rend l'agent immédiatement productif.
Pourquoi un fichier de contexte projet
Un agent IA, comme un nouveau collaborateur, a besoin d'un contexte pour être utile. Un nouveau salarié reçoit un onboarding ; un agent reçoit un fichier CLAUDE.md. C'est un document texte, à la racine d'un projet, qui décrit l'essentiel : le but du projet, les conventions de l'équipe, les commandes utiles, les pièges à éviter.
Sans CLAUDE.md, Claude redécouvre votre projet à chaque session. Il devine vos conventions, parfois bien, parfois mal. Avec un CLAUDE.md tenu à jour, il démarre informé. Le gain est immédiat sur les tâches répétées et structurantes — refactos, ajouts de feature, corrections de bug.
Que mettre dans un CLAUDE.md
Un bon CLAUDE.md tient en une à deux pages. Au-delà, on noie le signal. Les rubriques utiles :
Vue d'ensemble : trois lignes sur ce que fait le projet et pour qui.
Stack technique : langages, frameworks, services tiers utilisés.
Commandes : démarrage, build, tests, déploiement (les commandes que vous tapez dix fois par jour).
Conventions de code : formatage, nommage, structure de dossiers.
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.
Où le placer
Avec Claude Code : à la racine du projet, fichier nommé CLAUDE.md. Claude Code le détecte automatiquement à chaque démarrage. Vous pouvez aussi en mettre dans des sous-dossiers ; Claude lit celui qui est le plus proche du fichier qu'il édite.
Sur claude.ai : équivalent dans la fonctionnalité 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. Même logique, interface différente.
Bonnes pratiques
Court avant exhaustif. Un CLAUDE.md de cinq 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 moments-clés. Quand vous changez une convention, ajoutez une dépendance, ou découvrez un piège : trois minutes pour mettre à jour, qui économisent trente minutes plus tard.
Factuel, pas didactique. Le fichier n'est pas un cours. « Tests : npm test », pas « Pour lancer les tests, ouvrez un terminal et tapez la commande... ».
Créer votre premier CLAUDE.md
L'objectif est de produire un fichier minimal mais utile pour un projet existant. Comptez quinze minutes.
-
Choisir un projet réel sur votre machine. Peu importe le langage. Ouvrir le dossier dans Finder ou l'Explorateur.
-
Créer un fichier nommé
CLAUDE.mdà la racine du projet.macOS Clic droit dans le dossier → Nouveau document → renommer en CLAUDE.md. Si le système refuse l'extension, créer d'abord un .txt et renommer ensuite.Windows Clic droit → Nouveau → Document texte → renommer en CLAUDE.md. Activer l'affichage des extensions dans l'Explorateur si nécessaire. -
Ouvrir le fichier dans un éditeur texte (TextEdit, Notepad, VS Code). Y rédiger les six rubriques vues plus haut. Visez une page maximum.
-
Lancer Claude Code dans le projet :
claude. Vérifier dans le premier message qu'il signale avoir lu le CLAUDE.md. -
Tester en lui demandant une tâche dont la réussite dépend du CLAUDE.md : « Lance les tests », par exemple. Si la commande qu'il propose correspond à ce que vous avez écrit, le contexte est bien chargé.
Rédiger le CLAUDE.md d'un de vos projets
Choisissez un projet réel et rédigez son CLAUDE.md complet. Faites-le relire par un collègue qui connaît le projet : ce qui lui semble manquer, manque réellement.
- code.claude.com documentation Claude Code
- docs.claude.com documentation produit, chemin précis à vérifier au moment de la consultation
- github.com exemples de CLAUDE.md publics dans des projets open source
Vous savez rédiger un CLAUDE.md utile pour votre projet ?