BuildYourSaaS
Guide gratuit

Le fichier CLAUDE.md qui change tout

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.

80%
De crédits économisés
0
Contexte à réexpliquer
∞
Mémoire permanente
Le problème

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.

La solution

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.

Le guide
ÉTAPE 1

Crée le fichier

À la racine de ton projet, crée un fichier nommé exactement CLAUDE.md (majuscules). Claude Code le détecte automatiquement.

touch CLAUDE.md
ÉTAPE 2

La structure qui change tout

Voici les 6 sections à mettre dans ton CLAUDE.md. Copie ce template et adapte-le à ton projet :

📋 Template CLAUDE.md complet

# Mon Projet — Contexte Global ## Qui je suis - Ton nom, ton rôle, ton expertise - Ce que tu fais, pour qui - Tes contraintes (budget, deadline, stack imposée) ## Le projet - Description en 2-3 phrases - L'objectif principal - Les utilisateurs cibles ## Stack technique - Langages : TypeScript, Python, etc. - Framework : Next.js, Express, etc. - Base de données : PostgreSQL, MongoDB, etc. - Hébergement : Vercel, AWS, VPS, etc. - Outils : Docker, PM2, Nginx, etc. ## Structure du projet - /src → code source principal - /api → endpoints backend - /components → composants React - /lib → utilitaires et helpers - /public → fichiers statiques ## Règles pour Claude - Toujours écrire en français dans les commentaires - Ne jamais modifier les fichiers .env - Utiliser des named exports (pas de default) - Tester chaque modification avant de commit - Ne pas créer de fichiers README sauf si demandé ## Commandes utiles - npm run dev → lance le serveur de dev - npm run build → build de production - npm test → lance les tests - ssh user@server → déploiement
ÉTAPE 3

Les sections avancées (optionnel mais puissant)

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
ÉTAPE 4

Les erreurs à éviter

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.

ÉTAPE 5

Le résultat

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.
PRO TIP

Demande à Claude de le créer pour toi

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.

Tu veux automatiser tout ton contenu ?

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.