Leçon 3 sur 15
Le fichier CLAUDE.md
12 min de lecture
Points clés de cette leçon
- CLAUDE.md fournit à Claude Code le contexte permanent du projet.
- Il décrit conventions, commandes et contraintes à respecter.
- Un bon CLAUDE.md est concis, à jour et orienté action.
Le fichier CLAUDE.md est la mémoire de projet de Claude Code. Placé à la racine du dépôt, il est lu automatiquement et fournit le contexte que l'assistant ne peut pas deviner.
Pourquoi ce fichier est essentiel
Sans contexte, l'assistant fait des hypothèses. CLAUDE.md remplace ces suppositions par des faits : votre gestionnaire de paquets, vos conventions, vos commandes de test.
Ce qu'il doit contenir
Listez les commandes utiles, les conventions de nommage, les pièges connus et les contraintes du projet. Restez factuel et orienté action.
Le garder utile dans le temps
Un CLAUDE.md obsolète induit l'assistant en erreur. Mettez-le à jour comme vous mettriez à jour une documentation : régulièrement et sans accumuler le superflu.
Erreur fréquente
Un CLAUDE.md trop long dilue l'information importante. Préférez quelques règles claires à un document exhaustif jamais relu.