Aller au contenu
Floskool

Chapitre 1 · L'essentiel

À quoi sert le CLAUDE.md

Leçon gratuite 6 minGroupe Claude Code

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

Suivre gratuitement

CLAUDE.md est un fichier texte que Claude Code lit au début de chaque conversation. Tout ce que tu y écris, il le sait avant même ta première demande. C'est la méthode conseillée par l'équipe de Claude Code pour donner un contexte durable à un projet.

Ce qu'il change concrètement

Sans CLAUDE.md, tu écris : « Refais la page contact. Au fait, je suis fleuriste à Lyon, je tutoie mes clients, garde mes couleurs, et ne mets aucun faux avis. » À chaque fois.

Avec un CLAUDE.md, tu écris : « Refais la page contact. » Le reste, Claude Code le sait déjà.

Où le ranger

Il existe trois emplacements, chacun avec son rôle :

  • CLAUDE.md à la racine du projet : les règles de ce projet. C'est celui que tu utiliseras le plus.
  • ~/.claude/CLAUDE.md dans ton dossier personnel : tes préférences pour tous tes projets, par exemple « réponds en français, tutoie-moi, explique sans jargon ».
  • CLAUDE.local.md à la racine du projet : tes notes personnelles, à ne pas partager. Pense à l'ajouter dans .gitignore si tu utilises Git.

Le démarrage le plus rapide

Ouvre Claude Code dans ton dossier et tape /init. Il analyse tes fichiers et rédige un premier CLAUDE.md. S'il en existe déjà un, il propose des améliorations au lieu de l'écraser.

Mais /init ne devine que ce qu'il voit dans tes fichiers. Ton public, ton ton, tes interdits, c'est à toi de les ajouter.

Vérifier qu'il est bien lu

Deux commandes utiles :

  • /context : montre ce que Claude Code a chargé, dont ton CLAUDE.md ;
  • /memory : ouvre le fichier pour le modifier.

Et un test simple, à lancer après avoir créé le fichier :

Sans relire mes fichiers, dis-moi en 5 lignes ce que tu sais de ce projet : activité, public, ton, règles et interdits.
Si une de ces informations te manque, dis-le.

Si la réponse colle à ce que tu as écrit, le fichier fait son travail. Si quelque chose manque, c'est le signe qu'il faut l'ajouter.

À toi de jouer

Ouvre Claude Code dans le dossier d'un de tes projets (même un dossier vide) et tape /init. Lis ce qu'il propose, puis note sur une feuille trois choses qu'il ne pouvait pas deviner : ton public, ton ton, un interdit.