Chapter 2 · Écrire ton CLAUDE.md
Ce qu'on n'y met jamais, et comment le garder à jour
Follow this course in your space: your progress is saved, and the community answers your questions.
Follow for freePourquoi c'est important
CLAUDE.md est relu à chaque conversation. Tout ce qui s'y trouve est donc lu, répété, et parfois partagé avec d'autres personnes si tu partages ton projet. Un secret dans CLAUDE.md, c'est un secret qui circule.
Exemple : un graphiste freelance colle dans son CLAUDE.md le mot de passe de l'hébergement de son site « pour que Claude puisse publier tout seul ». Il partage ensuite son dossier avec un collègue. Le mot de passe part avec.
Ce qu'on n'y met jamais
- Mots de passe. Jamais, sous aucune forme.
- Clés API et jetons (des mots de passe techniques qui permettent à un programme d'utiliser un service). Ils vivent dans un fichier
.env. - Données personnelles de clients : e-mails, téléphones, adresses, factures.
- Coordonnées bancaires.
À la place, écris simplement une mention du type « voir .env ». Claude sait alors où chercher, sans que le secret soit dans le fichier.
Si un secret s'est déjà retrouvé dans CLAUDE.md, dans une conversation ou sur une capture d'écran : considère-le comme perdu. Supprimer le fichier ne suffit pas. Va dans l'espace du service concerné, désactive la clé ou change le mot de passe, puis crée-en un nouveau.
Le garder court
Un CLAUDE.md trop long a deux défauts : il prend de la place dans le contexte à chaque conversation, et les règles importantes se noient dans la masse. La documentation conseille de rester sous 200 lignes. Vise moins de 80 lignes si possible.
Ce qui peut sortir de CLAUDE.md :
- ce que Claude peut lire lui-même dans tes fichiers ;
- les évidences ;
- les savoir-faire occasionnels (écrire une légende Instagram, faire un devis). Ceux-là vont mieux dans un skill, qui ne se charge que quand il sert (chapitre 4) ;
- tes préférences valables partout, qui vont dans
~/.claude/CLAUDE.md.
Le mettre à jour avec /memory
Ton CLAUDE.md doit vivre avec ton projet. Chaque fois que tu corriges Claude sur le même point deux fois, c'est le signe qu'une règle manque.
- Tape
/memory: tu vois tes fichiers de mémoire. - Choisis ton CLAUDE.md pour l'ouvrir et le modifier.
- Ajoute, corrige ou supprime la ligne concernée.
- Tape
/contextpour vérifier qu'il est bien chargé.
Tu peux aussi demander à Claude de te proposer la ligne, en gardant la main :
Contexte : je t'ai corrigé plusieurs fois sur [le point qui revient].
Objectif : ajouter une règle dans CLAUDE.md pour ne plus avoir à le répéter.
Contraintes : une seule ligne, courte et vérifiable. N'ajoute aucune autre modification.
Format attendu : la ligne exacte et la section où la placer.
Validation : attends mon accord avant d'écrire dans le fichier.
Faire le ménage de temps en temps
Au fil des semaines, le fichier grossit. Ce prompt t'aide à le nettoyer sans rien perdre d'utile :
Contexte : mon CLAUDE.md a grossi au fil des semaines.
Objectif : le raccourcir sans perdre de règle utile.
Contraintes : classe chaque ligne : utile, inutile (tu la devines dans mes fichiers), floue, contradictoire. Ne retire aucune règle de sécurité. Signale tout mot de passe, clé ou donnée personnelle sans le répéter.
Format attendu : la liste de classement, puis la nouvelle version complète.
Validation : ne modifie rien avant mon accord.
Les erreurs à éviter
- Coller un secret « juste pour tester ». Ce test devient vite permanent.
- Ne jamais relire son fichier. Une règle périmée (ancienne couleur, ancien tarif) induit Claude en erreur.
- Laisser Claude modifier CLAUDE.md sans validation. C'est ton fichier de consignes : chaque ligne passe par toi.
- Retirer les règles de sécurité pour gagner de la place. Ce sont les deux dernières à supprimer.
À toi de jouer
- Relis ton CLAUDE.md ligne par ligne. Y a-t-il un mot de passe, une clé, un e-mail client ? Si oui, remplace par « voir .env » et change le secret concerné.
- Compte tes lignes. Plus de 80 ? Lance le prompt de ménage.
- Repère une correction que tu fais souvent et transforme-la en règle avec
/memory.