Qu'est-ce qu'un fichier CLAUDE.md ?
Le fichier CLAUDE.md est le coeur de la personnalisation de Claude Code. Il permet de définir des instructions persistantes qui guident le comportement de l'assistant IA dans votre projet. Contrairement aux prompts classiques que vous tapez à chaque conversation, le CLAUDE.md reste en mémoire et s'applique automatiquement.
Pourquoi c'est important
Imaginez devoir expliquer à chaque fois à votre assistant :
- Quel framework vous utilisez
- Vos conventions de code
- Les fichiers à ne jamais modifier
- Le style de commentaires préféré
Avec un CLAUDE.md bien rédigé, tout cela est configuré une seule fois.
Créer votre premier CLAUDE.md
Étape 1 : Créer le fichier à la racine du projet
Placez un fichier .claude/CLAUDE.md ou CLAUDE.md à la racine de votre dépôt Git. Claude Code le détectera automatiquement.
mkdir -p .claude
touch .claude/CLAUDE.md
Étape 2 : Définir le contexte du projet
Commencez par décrire votre projet en quelques lignes :
# Mon Projet
## Stack technique
- Frontend : React 18 + TypeScript
- Backend : Node.js + Express
- Base de données : PostgreSQL
- ORM : Drizzle
Étape 3 : Ajouter des conventions de code
Précisez vos préférences de développement :
## Conventions
- Utiliser des fonctions fléchées pour les composants React
- Nommer les fichiers en kebab-case
- Toujours typer les props avec des interfaces
- Pas de any, utiliser unknown si nécessaire
Étape 4 : Définir les interdictions
Ce qui est tout aussi important, c'est ce que Claude ne doit pas faire :
## Interdictions
- Ne jamais modifier les fichiers de migration existants
- Ne pas ajouter de dépendances sans demander
- Ne pas supprimer les commentaires TODO existants
Structurer efficacement votre CLAUDE.md
La structure recommandée
Un bon CLAUDE.md suit cette structure :
- Description du projet (2-3 lignes)
- Stack technique (liste des technologies)
- Architecture (structure des dossiers importants)
- Conventions de code (style, nommage, patterns)
- Commandes utiles (build, test, deploy)
- Interdictions (ce qu'il ne faut pas faire)
Exemple complet
Voici un exemple de CLAUDE.md pour une application SaaS :
# TaskFlow - Application de gestion de tâches
## Stack
- Next.js 14 (App Router)
- Tailwind CSS + shadcn/ui
- Supabase (auth + DB)
- Stripe (paiements)
## Architecture
- /app : Routes et pages
- /components : Composants réutilisables
- /lib : Utilitaires et configurations
- /hooks : Custom hooks React
## Conventions
- Composants en PascalCase
- Hooks préfixés par use
- Server Components par défaut
- Client Components uniquement si nécessaire
## Commandes
- npm run dev : Serveur de développement
- npm run build : Build production
- npm run test : Tests unitaires
## Ne pas faire
- Ne pas utiliser getServerSideProps (App Router)
- Ne pas installer de package CSS supplémentaire
- Ne pas modifier le schema Supabase directement
Bonnes pratiques avancées
Utiliser des skills partagés
Votre CLAUDE.md peut référencer des skills de la communauté avec la directive @ :
@typescript-strict.md
@react-best-practices.md
Cela permet de combiner vos instructions personnelles avec des skills maintenus par la communauté.
Versionner votre CLAUDE.md
Ajoutez votre CLAUDE.md à Git. Cela permet à toute l'équipe de bénéficier des mêmes instructions et de suivre les évolutions.
Itérer et améliorer
Votre CLAUDE.md n'est pas figé. Améliorez-le au fur et à mesure :
- Ajoutez des règles quand Claude fait une erreur récurrente
- Supprimez les règles devenues inutiles
- Demandez à Claude de vous aider à l'optimiser
Astuce : Demandez à Claude "Analyse mon CLAUDE.md et suggère des améliorations" pour obtenir des recommandations.
Les erreurs courantes à éviter
1. Être trop vague
Mauvais : "Écris du bon code" Bon : "Utilise des noms de variables descriptifs en camelCase, ajoute des types TypeScript explicites"
2. Être trop restrictif
Un CLAUDE.md trop long avec trop de règles peut devenir contre-productif. Gardez les instructions essentielles et faites confiance au modèle pour le reste.
3. Ne pas maintenir le fichier
Un CLAUDE.md obsolète est pire que pas de CLAUDE.md du tout. Revoyez-le régulièrement.
Conclusion
Le fichier CLAUDE.md est votre meilleur allié pour tirer le maximum de Claude Code. En investissant 30 minutes dans sa création, vous gagnerez des heures de productivité sur chaque session de développement.
Explorez notre bibliothèque de skills pour trouver des modèles prêts à l'emploi et découvrez les guides avancés pour aller plus loin.