Chapitre 3 · Ta première session
/init et CLAUDE.md : les règles de ton projet
Suis cette formation dans ton espace : ta progression est gardée, et la communauté répond à tes questions.
Suivre gratuitementNe plus jamais réexpliquer ton projet
Chaque nouvelle conversation avec Claude Code démarre sans souvenir de la précédente. La solution : un fichier CLAUDE.md, que Claude relit au début de chaque conversation.
Pourquoi c'est la meilleure demi-heure que tu puisses investir
Camille est coach sportive. Chaque jour, elle répétait : « tutoie mes clients, phrases courtes, jamais de promesse de résultat ». Depuis qu'elle a écrit ces trois règles dans son CLAUDE.md, elle ne les répète plus. Claude les applique à chaque conversation.
Ce qu'est CLAUDE.md
D'après la page officielle https://code.claude.com/docs/en/memory, CLAUDE.md est un fichier d'instructions que tu écris pour donner à Claude un contexte durable. Il peut vivre à plusieurs endroits :
CLAUDE.md(ou.claude/CLAUDE.md) à la racine de ton projet : les règles de ce projet.~/.claude/CLAUDE.mddans ton dossier personnel : tes préférences pour tous tes projets (par exemple « réponds en français, tutoie-moi »). Le signe~désigne ton dossier personnel :C:\Users\[ton nom]sur Windows,/Users/[ton nom]sur Mac.CLAUDE.local.mdà la racine du projet : tes notes personnelles pour ce projet, à ne pas partager.
Étape 1 : génère un premier brouillon avec /init
Dans Claude Code, tape :
/init
D'après la documentation, Claude analyse ton dossier et crée un premier CLAUDE.md avec ce qu'il découvre. S'il en existe déjà un, /init propose des améliorations au lieu de l'écraser. Comme d'habitude, lis la demande de permission avant qu'il écrive le fichier.
Étape 2 : complète avec ce qu'il ne peut pas deviner
/init voit tes fichiers, pas ta tête. Ajoute toi-même ton public, ton ton et tes interdits. Voici un modèle à adapter :
# Projet : [nom du projet]
## Qui je suis
[Ton métier] à [ta ville]. Je ne sais pas coder : explique simplement.
## Mon public
[Qui sont tes clients, en une phrase.]
## Mon ton
Tutoiement. Phrases courtes. Aucun jargon non expliqué.
## Règles
- Mets entre crochets toute information que tu ne peux pas savoir (prix, horaires, adresse).
- N'invente jamais de chiffre, d'avis client ou de témoignage.
## Sécurité
- Les clés et mots de passe vivent dans un fichier .env qui n'est jamais envoyé sur Git ni collé dans une conversation.
- Demande-moi toujours avant de publier, d'envoyer ou de supprimer quoi que ce soit.
Étape 3 : vérifie qu'il est bien chargé
/memory: liste tes fichiers CLAUDE.md et te permet d'en ouvrir un pour le modifier./context: d'après la documentation, montre notamment les fichiers d'instructions chargés au démarrage.
Les conseils de la documentation
- Court : moins de 200 lignes par fichier. Un fichier trop long se suit moins bien.
- Précis : « phrases de 15 mots maximum » marche mieux que « écris bien ».
- Utile : pour chaque ligne, demande-toi si Claude ferait une erreur sans elle.
La documentation explique aussi que Claude Code peut prendre ses propres notes au fil de tes corrections (la « mémoire automatique »). Retiens la différence : CLAUDE.md, ce sont tes consignes ; la mémoire, ce sont ses notes. Une règle importante, écris-la toi-même dans CLAUDE.md.
Un prompt pour relire ton CLAUDE.md
Contexte : voici le CLAUDE.md de mon projet [nom du projet]. S'il n'existe pas, dis-le et arrête-toi.
Objectif : le rendre plus court, plus précis et plus sûr.
Contraintes : ne modifie pas le fichier. N'ajoute aucune information que je ne t'ai pas donnée.
Format attendu : 3 listes (règles floues avec leur version précise, lignes inutiles, ce qui manque : public, ton, interdits, sécurité), puis le nouveau texte complet.
Validation : attends mon accord avant d'écrire, puis rappelle-moi de taper /context.
Les erreurs à éviter
- Garder le brouillon de
/inittel quel. Il ne connaît ni ton public ni ton ton. - Écrire un roman. Un CLAUDE.md d'une page est plus efficace qu'un long règlement.
- Y mettre une clé ou un mot de passe. Jamais. Ce fichier peut être partagé.
À toi de jouer
- Tape
/initdans ton dossier de projet et accepte la création après lecture. - Ouvre le fichier avec
/memoryet ajoute tes sections « Mon public », « Mon ton » et « Sécurité ». - Tape
/clear, puis/context, et vérifie que ton CLAUDE.md est bien chargé.