CLAUDE.md est le fichier qui determine comment Claude comprend votre projet. Un fichier bien redige signifie moins de corrections, du meilleur code et des agents qui savent vraiment sur quoi ils travaillent.
Ce guide couvre chaque section d'un fichier CLAUDE.md, des declarations de stack technique aux instructions spécifiques par agent. Suivez les étapes et construisez le votre progressivement.
CLAUDE.md est un fichier markdown place a la racine de votre projet. Quand Claude Code demarre une session, il lit ce fichier en premier. Tout ce qu'il contient devient partie du contexte de Claude : votre stack technique, votre arborescence, les conventions de votre équipe et toutes les instructions que vous voulez que chaque agent suive.
Voyez-le comme un briefing. Sans lui, Claude doit deviner comment votre projet est organisé. Avec un bon CLAUDE.md, Claude sait déjà ou se trouvent les fichiers, quels patterns suivre et ce qu'il faut éviter. La différence de qualité dans les résultats est significative.
“Investir 10 minutes dans CLAUDE.md economise des heures de corrections sur du code généré par IA qui ne correspond pas aux patterns de votre projet.”
Observe sur des centaines de projets Claude Code
La structure et la précision de votre CLAUDE.md impactent directement la qualité du travail de Claude sur votre codebase.
Un CLAUDE.md bien structure couvre ces six domaines. Chacun donne a Claude des informations concretes sur lesquelles il peut agir immédiatement.
Listez vos frameworks, bibliotheques et leurs versions explicitement. Incluez votre gestionnaire de paquets, la version de Node et les prerequis d'exécution. Claude utilise ces informations pour generer du code compatible sans avoir a deviner.
Decrivez vos répertoires cles et ce que chacun contient. Composants, stores, services, routes API, types. Un court diagramme en arbre avec une ligne de description par dossier fonctionne bien.
Documentez vos conventions de nommage (camelCase pour les fichiers, PascalCase pour les composants), votre approche de gestion d'erreurs, l'ordre des imports et toute regle spécifique au projet. Cela maintient la coherence entre le code de Claude et votre code existant.
Incluez vos commandes dev, build, test et lint. Quand Claude a besoin de vérifier que quelque chose fonctionne ou de suggerer un script, il utilisera exactement les commandes attendues par votre projet.
Si vous utilisez plusieurs agents (QA, frontend, backend, DevOps), ajoutez une section decrivant le focus de chaque rôle. C'est particulierement utile avec la configuration multi-agents d'AgentsRoom.
Dites a Claude ce qu'il ne doit PAS faire. Ne pas modifier les fichiers de config, ne pas toucher au système d'auth, ne pas refactorer la couche base de donnees. Des limites explicites empêchent les agents de faire des changements non souhaites.
Pas besoin de tout écrire d'un coup. Commencez par les bases et enrichissez au fur et a mesure que vous decouvrez ce que Claude a besoin de savoir.
Ouvrez votre package.json et listez chaque framework, bibliotheque et outil utilise par votre projet. Notez les versions. Verifiez les prerequis d'exécution (version Node, version Python, base de donnees). Cela devient votre section stack technique.
package.json + versions runtime + base de donnees
Lancez un tree rapide de votre répertoire src. Identifiez les dossiers de premier niveau et redigez une description en une ligne pour chacun. Concentrez-vous sur l'emplacement des composants, stores, services, types et routes API.
Arbre src/ avec annotations
Examinez votre code existant et notez les patterns : comment vous nommez les fichiers, comment vous gérez les erreurs, comment vous structurez les imports, si vous utilisez des exports par défaut ou nommes. Écrivez-les sous forme de regles courtes.
Nommage, imports, gestion d'erreurs, exports
Si vous travaillez avec des agents spécialisés, ajoutez des zones de focus pour chaque rôle. L'agent frontend doit connaitre votre bibliotheque de composants. L'agent DevOps doit connaitre votre pipeline de déploiement. L'agent QA doit connaitre votre framework de test.
Zones de focus + zones a éviter par rôle
AgentsRoom est construit autour de CLAUDE.md comme concept central, pas comme un ajout secondaire.
Editez votre CLAUDE.md directement dans AgentsRoom avec coloration syntaxique et sauvegarde en temps réel. Pas besoin de basculer vers votre éditeur de texte ou IDE.
Voyez comment chaque agent interprete votre CLAUDE.md en temps réel. Observez la sortie terminal pour vérifier que les agents suivent vos conventions et respectent vos zones a éviter.
Chaque projet dans AgentsRoom a son propre CLAUDE.md. Passez d'un projet a l'autre et chaque agent charge automatiquement le bon fichier de contexte pour cette codebase.
Les 14 rôles d'agents d'AgentsRoom se combinent directement avec les sections de CLAUDE.md. Definissez des zones de focus et des zones a éviter par rôle, et chaque agent recupere exactement les instructions qui lui sont destinees.
CLAUDE.md is prepended to every Claude turn. A bloated CLAUDE.md silently inflates Claude Code token usage on every message. AgentsRoom puts a per-session token meter on each agent so you can see exactly how much your CLAUDE.md is costing you, with a live cache hit rate to confirm it stays cached.
See the Claude Code token usage trackerTéléchargez AgentsRoom et utilisez l'éditeur CLAUDE.md intégré pour donner a vos agents le contexte dont ils ont besoin. De meilleures instructions, du meilleur code.
App companion : suivez vos agents en déplacement
Utilisez Claude, Codex, Gemini CLI ou un autre fournisseur IA.
Remontez bugs et demandes directement dans votre backlog public.