Écrire un CLAUDE.md qui sert vraiment
Un fichier d'instructions trop long ou trop vague est ignoré par l'agent, et l'équipe recommence à corriger les mêmes écarts. Cette leçon vous apprend à rédiger pour votre dépôt un CLAUDE.md concis qui oriente vraiment Claude Code, à ranger chaque consigne au niveau qui convient et à le faire progresser au fil des erreurs observées.
Mis à jour le 29 septembre 2026.
En bref
Un CLAUDE.md est un fichier de consignes chargé automatiquement par Claude Code à l'ouverture de chaque session. Il transmet à l'agent ce que le code seul ne lui apprend pas : commandes du projet, conventions, pièges connus. Pour être suivi, il doit rester court et concret. Pour un PM, c'est le moyen le plus simple d'éviter de corriger sans cesse les mêmes écarts.
Objectif de la leçon
À la fin de cette leçon, vous serez capable de rédiger un CLAUDE.md court et utile pour votre dépôt, de choisir où placer chaque instruction (utilisateur, projet, local, sous-dossier, règle par chemin, import) et de le faire évoluer à partir des erreurs de l'agent.
Les questions auxquelles cette leçon répond
Que mettre dans un fichier CLAUDE.md ?
Ce que la lecture du code ne révèle pas : commandes de build et de test, conventions de l'équipe, zones sensibles, règles métier importantes. Tout ce qui est évident ou générique alourdit le fichier sans l'améliorer.
Où placer ses instructions pour Claude Code : utilisateur, projet ou sous-dossier ?
Au niveau utilisateur pour vos préférences personnelles, au niveau projet pour les règles partagées par l'équipe, et dans un sous-dossier pour les règles propres à un module précis.
Comment faire évoluer son CLAUDE.md quand l'agent se trompe ?
À chaque erreur répétée, on ajoute une consigne courte et précise qui l'aurait évitée, et on retire ce qui ne sert plus. Le fichier évolue avec les erreurs réelles, pas avec des règles théoriques.
Thèmes abordés
- CLAUDE.md
- Claude Code
- instructions pour agent de code
- conventions du dépôt
- mémoire de projet
Dans le glossaire
Guide sur ce thème
- Claude Code pour Product Manager
Ce qu’un PM peut faire avec Claude Code, la méthode et les garde-fous, avec un CLAUDE.md de départ.
Dans quel module
Maîtriser le contexte et le CLAUDE.md
Que sait l'agent de mon projet à chaque instant, et comment lui donner les bonnes informations sans le noyer ?
Leçons du module
- Ce que Claude Code a en tête, et comment le gérer
- Écrire un CLAUDE.md qui sert vraiment (cette leçon)
Ce que vous apprendrez dans la formation
Cette leçon fait partie de la formation Travailler avec Claude Code sur un vrai projet : contexte, plan, revue
Formations liées
- IA & ProductivitéConfirméPratique régulière : vous utilisez déjà l’outil ou êtes confronté à la thématique.
Créer des Claude Skills fiables pour votre travail produit
2 h 30 min
- IA & DéveloppementJuniorQuelques bases utiles : notions de contexte ou du domaine.
Construire et mettre en ligne une app web avec un agent de code IA
2 h 45 min
- IA & DéveloppementConfirméPratique régulière : vous utilisez déjà l’outil ou êtes confronté à la thématique.
Ajouter une base de données, l’authentification et le paiement à son app
4 h