Qu'est-ce que CLAUDE.md ?
CLAUDE.md est un fichier de configuration en markdown placé à la racine de votre projet. Il sert de mémoire persistante et d'instructions pour Claude Code, orientant ses réponses et actions selon le contexte de votre codebase.
Où placer vos fichiers CLAUDE.md
- Racine du projet : Instructions partagées par toute l'équipe (committé dans git)
- ~/.claude/CLAUDE.md : Instructions personnelles globales (tous projets)
- Sous-dossiers : Instructions spécifiques à un module ou package
Claude Code charge automatiquement le CLAUDE.md le plus proche du contexte de travail, avec héritage du parent.
Structure recommandée
1. Contexte du projet
Commencez par décrire brièvement le projet :
# Mon Projet
Application SaaS de gestion de factures.
Stack : Next.js 14, TypeScript, Prisma, PostgreSQL.2. Conventions de code
Définissez vos standards :
## Conventions
- Utiliser des named exports (pas de default export)
- Composants React en PascalCase, hooks en camelCase avec prefix "use"
- Tests colocalisés avec le code source (fichier.test.ts)3. Commandes utiles
Listez les commandes que Claude Code doit connaître :
## Commandes
- `pnpm dev` : Lancer le serveur de développement
- `pnpm test` : Lancer les tests
- `pnpm lint` : Vérifier le linting4. Règles métier
Ajoutez les contraintes spécifiques à votre domaine :
## Règles métier
- Les montants sont toujours en centimes (integer)
- Les dates utilisent le format ISO 8601
- Toute modification de prix nécessite un audit logBonnes pratiques
- Soyez concis : Claude Code lit ce fichier à chaque interaction. Évitez les pavés.
- Soyez spécifique : "Utiliser zod pour la validation" est mieux que "valider les entrées".
- Itérez : Mettez à jour votre CLAUDE.md au fil du projet.
- Utilisez des références : Pointez vers des fichiers existants plutôt que de dupliquer.
Astuce avancée
Vous pouvez inclure d'autres fichiers avec la syntaxe @ :
@docs/architecture.md
@.cursor/rules.mdCela permet de réutiliser de la documentation existante sans duplication.