7 templates CLAUDE.md pour Claude Code à copier dans de vrais projets

Beaucoup d’articles sur CLAUDE.md s’arrêtent à “décris ta stack”. Ce n’est pas faux, mais ce n’est pas suffisant quand Claude Code touche un vrai repo.

La bonne question n’est pas “faut-il un CLAUDE.md ?” La bonne question est : qu’est-ce qu’il doit contenir pour que Claude Code arrête de répéter les mêmes erreurs sur ce projet ?

Ce guide comble l’écart entre le guide débutant et CLAUDE.md Best Practices avec sept modèles copiables.

Chemin le plus court :

1. Garde le Claude Code Quick Reference Cheatsheet à portée de main.
2. Copie le template le plus proche de ton repo.
3. Ajoute d’abord trois règles Do Not.
4. Si tu veux plus d’exemples de templates, hooks et permissions, passe à The Complete Claude Code Setup & Configuration Guide.
5. Si tu veux standardiser cela pour une équipe, utilise la consultation page.

Ce qu’un bon CLAUDE.md fait vraiment

Il doit réduire trois échecs :

• Claude Code modifie la bonne zone mais casse la convention locale
• il résout la tâche mais saute la vérification importante
• il explore trop de fichiers parce que les frontières du repo ne sont pas claires

Un bon fichier contient donc en général :

• stack et commandes
• carte des dossiers
• règles spécifiques au projet
• ordre de travail recommandé
• interdictions

Les deux derniers points changent souvent plus le comportement qu’une longue description technique.

Template 1 : application web solo

# Project Overview

Customer-facing Astro site with a small Node API.

## Tech Stack

- Frontend: Astro 5 + TypeScript
- Styling: Tailwind CSS
- Backend: Node.js 22
- Tests: Vitest

## Key Directories

- `site/src/pages/` route entrypoints
- `site/src/components/` reusable UI
- `site/src/content/` blog and docs content
- `scripts/` operational scripts

## Common Commands

- Build: `cd site && npm run build`
- Test: `npm run test`
- Search content: `rg "keyword" site/src/content`

## Working Rules

- Prefer minimal diffs over wide refactors
- Keep copy changes aligned with existing brand tone
- When editing UI, verify mobile width before calling the task done

## Do Not

- Do not rename routes unless required
- Do not delete analytics or SEO fields
- Do not claim deploy success without checking the public URL

La ligne décisive ici n’est pas la stack, mais l’obligation de vérifier le mobile et l’URL publique.

Template 2 : site de contenu avec CTA de revenu

# Project Overview

Multilingual Claude Code content site with free PDF lead magnet, Gumroad products, and consultation funnel.

## Business Goal

- Priority 1: free PDF registration
- Priority 2: Gumroad product clicks and purchases
- Priority 3: consultation inquiries

## Content Rules

- Every new article must include internal links
- Every article must include free PDF, product, and consultation CTA paths
- Use the same slug across all locales when publishing multilingual posts

## Verification Workflow

1. Build the site
2. Deploy the site
3. Open the public URL
4. Check mobile layout
5. Confirm CTA destination links

## Do Not

- Do not publish only one locale when the article requires all locales
- Do not treat build success as release success
- Do not prioritize pageviews over conversion path quality

Si ton site dépend des articles, d’un PDF gratuit, de Gumroad et de prises de contact, ce format est bien plus utile qu’un template technique générique.

Templates 3 à 7

Tu peux reprendre les mêmes modèles que dans la version anglaise pour :

• une API backend avec validation stricte
• un repo d’équipe avec revue exigeante
• un codebase legacy où la compatibilité prime
• un repo d’automatisation avec effets de bord
• un monorepo avec frontières de packages claires

Dans chaque cas, les règles qui comptent le plus sont :

• le plus petit changement sûr
• l’ordre de vérification
• les opérations interdites
• les zones qui demandent une approbation

Échecs à éviter

• transformer CLAUDE.md en wiki d’entreprise
• lister des commandes sans workflow
• oublier les règles d’interdiction
• ne jamais mettre le fichier à jour

Si Claude Code répète trois fois la même erreur, le problème est souvent dans le CLAUDE.md, pas seulement dans le prompt.

Quelle base choisir

• appli produit ou UI : template solo
• site multilingue avec PDF et Gumroad : template contenu
• intégrité et validation : template API
• coordination et limites : template équipe ou monorepo
• coût d’erreur élevé : template legacy ou automatisation

Commence avec un seul modèle, puis ajoute uniquement les règles qui changent vraiment le comportement.

Prochaine étape

1. Copie un template dans CLAUDE.md
2. Ajoute trois règles Do Not
3. Écris la vérification exacte qui définit “terminé”

Pour une référence rapide au quotidien, prends le Claude Code Quick Reference Cheatsheet. Pour des exemples plus complets de CLAUDE.md, de setup, de hooks, de permissions et de workflow, passe à The Complete Claude Code Setup & Configuration Guide. Pour transformer cela en standard d’équipe, utilise la consultation page.