Chapter 1 · L'essentiel
À quoi sert le CLAUDE.md
Follow this course in your space: your progress is saved, and the community answers your questions.
Follow for freeCLAUDE.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.mddans 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.gitignoresi 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.