Sans ce fichier, tu gaspilles 80% de tes crédits Claude Code. Voici la structure exacte pour que Claude connaisse ton projet mieux que toi.
Claude oublie tout à chaque nouvelle conversation. Ton projet, ta structure, tes fichiers — il repart de zéro. Et à chaque session, tu grilles des tokens juste pour lui réexpliquer le contexte. C'est comme embaucher un dev qui a Alzheimer.
Le fichier CLAUDE.md à la racine de ton projet. Claude le lit automatiquement à chaque session. C'est sa mémoire permanente. Tu le remplis une fois, il s'en souvient pour toujours.
À la racine de ton projet, crée un fichier nommé exactement CLAUDE.md (majuscules). Claude Code le détecte automatiquement.
touch CLAUDE.mdVoici les 6 sections à mettre dans ton CLAUDE.md. Copie ce template et adapte-le à ton projet :
Pour aller plus loin, ajoute ces sections :
## Conventions de code - camelCase pour les variables - PascalCase pour les composants - snake_case pour les fichiers Python - Pas de commentaires évidents - Fonctions courtes (max 30 lignes) ## API & Services externes - Stripe : clé dans .env (STRIPE_KEY) - SendGrid : pour les emails transactionnels - Cloudinary : pour les images - API interne sur port 3002 ## Ce qui a déjà été fait - Auth JWT ✅ - Dashboard admin ✅ - Paiements Stripe ✅ - Email de bienvenue ✅ - Landing page → EN COURS ## Bugs connus - Le refresh token expire après 7 jours - Les images > 5MB crashent l'upload - Le dark mode casse sur Safari iOS
Ces erreurs ruinent l'efficacité de ton CLAUDE.md :
❌ Trop long — Claude lit tout à chaque session. Si c'est 500 lignes, tu gaspilles des tokens. Vise 50-100 lignes max.
❌ Trop vague — "C'est un site web" ne sert à rien. Sois spécifique : "SaaS B2B de facturation pour TPE, Next.js + Supabase".
❌ Pas à jour — Mets-le à jour quand ton projet évolue. Un CLAUDE.md obsolète est pire que pas de CLAUDE.md.
❌ Pas de règles — La section "Règles pour Claude" est la plus importante. C'est là que tu lui dis ce qu'il doit et ne doit PAS faire.
Quand tu lances Claude Code, il affiche :
$ claude ╭──────────────────────────────────╮ │ Claude Code │ │ 📄 CLAUDE.md loaded │ │ Context: Mon Projet │ ╰──────────────────────────────────╯ > Il connaît déjà tout. > Pas besoin de réexpliquer. > Tu gagnes 80% de tokens.
Le meilleur moyen de créer un CLAUDE.md parfait, c'est de demander à Claude lui-même :
$ claude > Analyse tout mon projet et crée-moi un fichier CLAUDE.md complet avec la structure, la stack, les conventions et les règles que tu juges importantes pour bosser efficacement avec moi.
Il va scanner ton projet et générer un CLAUDE.md sur mesure. Tu n'as plus qu'à ajuster.
J'ai utilisé Claude Code pour construire un système qui crée, publie et optimise mon contenu automatiquement. Sur 5 plateformes. Tous les jours.