Chapter 3 · Ta première session
/init et CLAUDE.md : les règles de ton projet
Follow this course in your space: your progress is saved, and the community answers your questions.
Follow for freeNe 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é.