Le fichier CLAUDE.md

Le problème qu'il résout

Lorsque vous ouvrez Claude Code sans fichier CLAUDE.md, il repart de zéro à chaque fois. Il doit réexplorer votre base de code, déterminer quelles dépendances sont nécessaires et comprendre quelles fonctionnalités sont déjà implémentées. Il fait parfois des suppositions, ce qui rend plus difficile le fait de guider Claude dans la bonne direction.

CLAUDE.md résout ce problème. C'est un fichier Markdown que vous ajoutez à la racine de votre projet, et Claude Code le lit automatiquement à chaque démarrage de session. Considérez-le comme un script d'intégration pour votre base de code. Le contenu du fichier CLAUDE.md est ajouté à la fin de votre prompt.

Un exemple

Voici à quoi ressemble un fichier CLAUDE.md typique :

# Project

This is a Next.js 15 app using the App Router, Tailwind, and Drizzle ORM.

# Commands
- Dev server: `pnpm dev`
- Run tests: `pnpm test`
- Lint: `pnpm lint`

# Code Style
- Use 2-space indentation
- Prefer named exports
- All API routes go in app/api/
- Use server actions instead of API routes where possible

C'est simple. Désormais, si vous demandez à Claude Code de créer un composant React, il sait déjà qu'il doit utiliser Tailwind pour le style et suivre vos conventions de code.



CLAUDE.md est fait pour les équipes

Vous pouvez (et devriez) versionner votre fichier CLAUDE.md afin que votre équipe en bénéficie également. Il existe en fait une hiérarchie de fichiers de mémoire selon les personnes à qui ils s'adressent :

• Le CLAUDE.md au niveau du projet se trouve dans le répertoire racine de votre projet. Partagé avec l'équipe.

• Le CLAUDE.md au niveau de l'utilisateur se trouve dans votre dossier de configuration. Celui-ci est uniquement pour vous et s'applique à tous vos projets. Placez-y vos préférences personnelles.

Conseils

Enregistrez les corrections en mémoire. Si vous vous retrouvez à corriger Claude de manière répétée — par exemple en lui disant de toujours utiliser des server actions plutôt que des routes API — demandez explicitement à Claude d'enregistrer cette règle en mémoire. La prochaine fois que vous ouvrirez le projet, il le saura.



Référencez la documentation du projet. Si vous disposez d'une documentation dans votre projet que vous souhaitez que Claude consulte, utilisez le symbole @ suivi du chemin du fichier :

## README.md

Please read if you need more info: @README.md

Commencez sans en avoir un. Nous recommandons de démarrer un projet sans fichier CLAUDE.md afin de repérer les moments où vous devez constamment recadrer le modèle. Cela permet de garder votre CLAUDE.md compact et centré uniquement sur les informations nécessaires. Lorsque vous êtes prêt, exécutez /init pour que Claude en génère un pour vous.

Récapitulatif

La différence entre une session Claude Code frustrante et une session productive tient souvent au contexte — et le fichier CLAUDE.md est le moyen de fournir ce contexte. Commencez par votre stack technique, vos préférences et vos commandes, puis développez-le au fil du temps.