Aller au contenu
Floskool

Chapitre 3 · Ta première session

/init et CLAUDE.md : les règles de ton projet

Leçon gratuite 8 minGroupe Claude Code & IA

Suis cette formation dans ton espace : ta progression est gardée, et la communauté répond à tes questions.

Suivre gratuitement

Ne 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.md dans 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 /init tel 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

  1. Tape /init dans ton dossier de projet et accepte la création après lecture.
  2. Ouvre le fichier avec /memory et ajoute tes sections « Mon public », « Mon ton » et « Sécurité ».
  3. Tape /clear, puis /context, et vérifie que ton CLAUDE.md est bien chargé.