Chapter 2 · Écrire ton CLAUDE.md
Ce qu'on met dans un bon CLAUDE.md
Follow this course in your space: your progress is saved, and the community answers your questions.
Follow for freePourquoi le contenu compte plus que la longueur
Un CLAUDE.md n'est pas une présentation de ton entreprise. C'est une liste de consignes que Claude relit à chaque conversation. Chaque ligne doit changer son comportement.
Exemple : une prof de yoga écrit « Mon ton est sympa ». Résultat : Claude ne sait pas quoi en faire. Elle remplace par « Tutoiement, phrases courtes, pas de mots en anglais, un seul émoji maximum par post ». Là, Claude applique.
La règle d'or : une règle = une ligne courte et vérifiable. « Phrases de 15 mots maximum » plutôt que « écris bien ».
Les 6 blocs d'un bon CLAUDE.md
1. Qui tu es et ce que fait le projet Une phrase suffit : ton métier, ta zone, ce que fait le projet et pour qui.
2. Ton public Qui sont tes clients, où ils sont, sur quel appareil ils te lisent (souvent le téléphone quand ils viennent d'Instagram).
3. Ton ton et ta façon d'écrire Tutoiement ou vouvoiement, style (chaleureux, expert, drôle, sobre), longueur des phrases, mots à éviter, langue.
4. Ta charte
Tes couleurs (avec leur code, par exemple #0b1832), ta police, tes formats d'image. Sans ça, Claude choisit au hasard.
5. Tes règles de travail Comment tu veux qu'il travaille : proposer un plan avant de modifier plusieurs fichiers, mettre entre crochets ce qu'il ne sait pas, demander avant d'ajouter un outil.
6. Tes interdits et ta sécurité Ce qu'il ne doit jamais faire. Deux règles de sécurité à mettre toujours, même si tu n'y penses pas :
- les clés et mots de passe vivent dans un fichier
.env(un fichier à part, réservé aux secrets), jamais dans le code ; - toujours demander ton accord avant de publier, d'envoyer ou de supprimer quoi que ce soit.
Tu peux ajouter un bloc Commandes si ton projet en a (par exemple la commande pour lancer l'aperçu de ton site). Si tu ne sais pas, laisse-le de côté.
Pas à pas : transformer une idée floue en règle
- Écris ta consigne comme elle te vient : « Je veux un ton pro mais pas froid ».
- Demande-toi : comment Claude pourrait vérifier qu'il la respecte ?
- Réécris-la en règle concrète : « Vouvoiement. Phrases de 20 mots maximum. Pas de jargon technique. Termine chaque texte par une question au lecteur. »
- Si la règle est vraiment critique, tu peux la marquer IMPORTANT. Mais une ou deux au maximum, sinon plus rien n'est important.
Voici quelques règles floues réécrites, à piocher :
Flou : « Écris bien. »
Précis : « Phrases de 15 mots maximum. Un paragraphe = une idée. »
Flou : « Respecte ma marque. »
Précis : « Couleurs : #0b1832 et #f0cd8c uniquement. Police : [nom de ta police]. »
Flou : « Sois prudent. »
Précis : « Propose un plan avant de modifier plusieurs fichiers. »
Flou : « Ne raconte pas n'importe quoi. »
Précis : « N'invente jamais de chiffres, d'avis clients ou de témoignages. Mets entre crochets ce que tu ne sais pas. »
Le cas des interdits
Les interdits sont souvent la partie la plus utile. Pense à ce qui t'a déjà agacé avec une IA :
- inventer des chiffres, des avis ou des citations ;
- toucher à certains dossiers (tes factures, tes photos originales) ;
- ajouter un outil ou une bibliothèque sans demander ;
- publier ou envoyer quelque chose sans ta relecture.
Les erreurs à éviter
- Les évidences. « Écris du code propre » ou « sois utile » ne changent rien. Supprime.
- Les descriptions de fichiers. Claude peut ouvrir tes fichiers lui-même.
- Les règles contradictoires. « Phrases courtes » d'un côté, « textes détaillés et longs » de l'autre : il ne saura pas laquelle suivre.
- Dix règles en IMPORTANT. Une ou deux, pas plus.
- Oublier les deux règles de sécurité. Elles te protègent d'une fuite de mot de passe et d'une publication non voulue.
À toi de jouer
- Prends une feuille et écris une ligne pour chacun des 6 blocs, avec tes mots.
- Pour chaque ligne, applique le pas à pas : rends-la vérifiable.
- Écris au moins trois interdits tirés de ta propre expérience.
- Garde cette feuille : à la leçon suivante, tu la colles dans le modèle.