J’ai construit le cerveau de ma forge IA en 10 minutes — voilà mon CLAUDE.md

Il y a deux semaines, je tapais mes instructions à Claude à chaque nouvelle conversation. Chaque fois que j’ouvrais une session, je recommençais à zéro : qui je suis, ce que je construis, comment je veux qu’il me réponde. 10 minutes plus tard, j’avais résolu ce problème définitivement. Voilà exactement ce que j’ai fait.

Le problème que le CLAUDE.md résout

Claude Code ouvre une nouvelle session à chaque conversation. Sans configuration, il ne sait pas que tu es solopreneur, que tu travailles sur un business de formation IA, que tu veux des réponses courtes et directes. Tu dois tout réexpliquer à chaque fois.

Le CLAUDE.md change ça. C’est un fichier texte que tu places à la racine de ton projet. Claude Code le lit automatiquement au démarrage de chaque session. C’est la mémoire permanente de ton IA.

En pratique : j’ouvre Claude Code dans mon dossier projet, il lit le CLAUDE.md, et il sait déjà qui je suis, ce que je construis, et comment se comporter. Je tape directement ma demande sans rien réexpliquer.

Ce que j’ai mis dans mon CLAUDE.md — et pourquoi

J’ai structuré mon fichier en 4 blocs. Chaque bloc répond à une question que Claude Code se poserait s’il débarquait dans mon projet sans contexte.

Bloc 1 — Qui je suis

Pas une bio LinkedIn. Les faits utiles pour que Claude comprenne mon niveau et mes contraintes :

## QUI JE SUIS
- Ingénieur DevOps 13 ans — je sais automatiser
- Formateur naturel — je traduis le technique en simple
- Solopreneur avec 5-10h/semaine disponibles
- Je construis Systemesia : média de formation IA pour solopreneurs
- Site : systemesia.fr

Ces quelques lignes changent tout. Claude sait que je peux lire du code, que je veux des réponses adaptées à un solopreneur avec peu de temps, et quel est l’objectif final.

Bloc 2 — Mon client idéal

C’est la partie que la plupart des gens oublient. Si Claude ne sait pas à qui s’adresse mon contenu, ses suggestions seront génériques. J’ai décrit Lucas — le solopreneur qui me suit :

## CLIENT IDÉAL — LUCAS
Solopreneur 2-5 ans d'expérience. CA 3-8k€/mois.
Il maîtrise son métier mais est débutant en IA.
Sa douleur : il voit que l'IA peut tout automatiser
mais personne ne lui montre comment pour SON cas.
Il cherche quelqu'un qui fait les choses en vrai — pas des slides.

Maintenant quand je demande à Claude d’écrire un post LinkedIn ou un script vidéo, il écrit pour Lucas — pas pour un public imaginaire.

Bloc 3 — Les règles du jeu

Ce que Claude ne doit jamais faire, et ce qu’il doit toujours faire :

## RÈGLES NON NÉGOCIABLES
✗ Jamais de théorie sans démonstration à l'écran
✗ Jamais recommander un outil non testé personnellement
✗ Jamais de promesses vagues

✓ "J'ai fait" avant "tu devrais faire"
✓ Montrer les galères — pas seulement les succès
✓ Réponses courtes et directes

Bloc 4 — Les commandes

Les raccourcis que j’utilise au quotidien dans Claude Code :

## COMMANDES
/brief    → état du business en 10 lignes
/video    → structure + script épisode YouTube
/article  → article blog depuis une vidéo
/adapter  → 5 formats dérivés depuis une vidéo

Au lieu de taper « peux-tu me générer la structure d’un épisode YouTube sur le prompt engineering en tenant compte de mon persona Lucas et du ton pair à pair », je tape juste /video "prompt engineering". Claude sait tout le reste grâce au CLAUDE.md.

Ce qui a galéré — et comment j’ai résolu

J’ai passé 45 minutes sur la structure avant de trouver le bon équilibre. Mon premier CLAUDE.md faisait 800 lignes. Trop long — Claude passait plus de temps à le lire qu’à travailler. Version finale : 150 lignes, tout ce qui est essentiel, rien de superflu.

Deuxième blocage : le format Markdown. Claude Code lit le .md mais certaines formulations créaient de la confusion. J’ai appris à utiliser des blocs de code pour les règles et des tableaux pour les données structurées — ça rend le fichier beaucoup plus lisible pour l’IA.

Le résultat concret après 2 semaines

Depuis que ce fichier tourne, chaque session Claude Code démarre directement au travail. J’estime que je gagne 10-15 minutes par session sur les explications de contexte. Sur 5 sessions par semaine, c’est une heure récupérée sans effort.

Plus important : la qualité des outputs a changé. Claude écrit maintenant dans le ton exact que je cherche — pair à pair, sans jargon non expliqué, avec les galères incluses. Je ne corrige plus le ton, je peaufine juste le fond.

Comment créer ton CLAUDE.md en 10 minutes

1. Ouvre un éditeur de texte dans ton dossier projet
2. Crée un fichier nommé exactement CLAUDE.md
3. Colle les 4 blocs ci-dessus et remplace par tes informations
4. Ouvre Claude Code dans ce dossier — il lira le fichier automatiquement
5. Teste avec /brief ou une demande simple — vérifie que le ton est le bon

Mon CLAUDE.md complet est disponible gratuitement — abonne-toi à la newsletter pour le recevoir directement.

FAQ

Claude Code est-il payant ?

Oui — Claude Code nécessite un abonnement Claude Pro (20€/mois) ou Max (100€/mois). Pour démarrer, le plan Pro est suffisant.

Le CLAUDE.md fonctionne-t-il avec d’autres outils IA ?

Le CLAUDE.md est spécifique à Claude Code d’Anthropic. D’autres outils ont des équivalents (system prompt, memory files) mais la syntaxe et le fonctionnement diffèrent.

Quelle longueur idéale pour un CLAUDE.md ?

Entre 100 et 300 lignes. En dessous, il manque de contexte. Au-dessus, Claude passe trop de tokens à le lire et ses réponses deviennent moins précises. Vise l’essentiel.

Peut-on avoir plusieurs CLAUDE.md pour différents projets ?

Oui — et c’est même recommandé. Claude Code lit le CLAUDE.md du dossier dans lequel il est lancé. Un fichier différent par projet, chacun adapté à son contexte spécifique.

Comment savoir si mon CLAUDE.md est bien lu ?

Tape une demande qui nécessite le contexte du fichier — par exemple le nom de ton client idéal ou une commande définie dans le CLAUDE.md. Si Claude répond avec ces éléments sans que tu les aies mentionnés, le fichier est bien chargé.

Reçois mon CLAUDE.md complet — le fichier exact que j’utilise pour piloter toute la forge Systemesia. Abonne-toi à la newsletter, tu le reçois immédiatement.