Un fichier CLAUDE.md est un fichier markdown que Claude Code lit automatiquement au début de chaque session. Il contient le contexte permanent de ton projet : conventions, commandes, notes d’architecture et règles, pour que tu n’aies pas à les répéter dans chaque prompt. Tu le places à la racine de ton dépôt, et Claude le charge comme des instructions avant même de lire la moindre ligne de ton code.
Pourquoi CLAUDE.md est-il si important ?
L’essentiel des frictions avec un assistant IA vient du fait de réexpliquer les mêmes choses : comment lancer les tests, quels patterns suivre, ce à quoi ne jamais toucher. CLAUDE.md, c’est l’endroit où tu écris ça une seule fois. Comme Claude le lit à chaque session, un bon CLAUDE.md améliore discrètement chaque réponse que tu obtiens, sans que tu lèves le petit doigt.
C’est, de loin, le fichier le plus stratégique d’une configuration Claude Code. Quelques lignes précises font souvent plus qu’un long prompt astucieux.
Où le placer ?
CLAUDE.md fonctionne à trois niveaux, et ils se cumulent :
| Emplacement | Portée |
|---|---|
| Racine du dépôt | Tout le projet (commite-le, l’équipe le partage) |
| Un sous-dossier | Chargé quand Claude travaille dans ce dossier |
~/.claude/CLAUDE.md | Tes préférences personnelles, valables sur tous les projets |
Que mettre dans un bon CLAUDE.md ?
Garde-le court et concret. Les meilleurs couvrent :
- Les commandes qui comptent : build, test, lint, exécution.
- Les conventions : style de code, nommage, les patterns que tu utilises réellement.
- Les notes d’architecture : où se trouvent les choses, ce qui dépend de quoi.
- Ce qu’il faut éviter : les pièges, les fichiers à ne pas toucher, les anti-patterns.
- Des exemples plutôt que des règles : montre un bon exemple au lieu de le décrire.
Un CLAUDE.md long et vague est pire qu’un court et précis. S’il se transforme en pavé de texte, élague-le.
Comment en créer un ?
Lance /init dans ton projet. Claude parcourt la base de code et te rédige un premier CLAUDE.md, que tu réduis ensuite à ce qui compte vraiment. Ensuite, chaque fois que tu corriges Claude deux fois sur la même chose, ajoute une ligne.
À retenir
CLAUDE.md, c’est la façon de donner à Claude Code une mémoire de ton projet. Écris-le une fois, garde-le court et concret, et chaque session démarre en connaissant déjà tes conventions, tes commandes et tes pièges.
Tu veux passer d’un bon CLAUDE.md à un workflow complet, hooks, MCP, sous-agents et configuration en équipe ? La formation Harness Engineering t’y emmène. Le premier module est gratuit, sans carte bancaire.