Ficher .md

Le problème qu’il résout

Lorsque vous ouvrez Claude Code sans fichier CLAUDE.md, il recommence à 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. Parfois, cela fait des hypothèses, ce qui rend plus difficile d’orienter Claude dans la bonne direction.

CLAUDE.md résout cela. C’est un fichier Markdown que vous ajoutez à la racine de votre projet, et Claude Code le lit automatiquement à chaque fois que vous démarrez une session. Considérez-le comme un script d’intégration pour votre base de code. Le contenu du fichier CLAUDE.md est ajouté à votre invite.

Un exemple

Voici à quoi ressemble un fichier CLAUDE.md typique :

# Projet

Il s'agit d'une application Next.js 15 utilisant le routeur d'application, Tailwind et Drizzle ORM.

# Commandes
- Serveur de développement:`
- Exécuter des tests:`
- Lint: ` lint`

# Style de code
- Utilisez une indentation à 2 espaces
- Préférez les exportations nommées
- Toutes les routes API vont dans app/api/
- Utilisez les actions du serveur au lieu des routes API lorsque cela est possible

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

CLAUDE.md est pour les équipes

Vous pouvez (et devez) engager votre CLAUDE.md dans le contrôle de version afin que votre équipe en profite. Il existe en fait une hiérarchie de fichiers mémoire en fonction de leur destination :

• Niveau projet CLAUDE.md vit dans le répertoire racine de votre projet. Partagé avec l’équipe.

• Niveau utilisateur CLAUDE.md habite votre dossier de configuration. Celui-ci est réservé à vous et s’applique à tous vos projets. Mettez vos préférences personnelles ici.

Conseils

Enregistrer les corrections dans la mémoire. Si vous vous retrouvez à corriger Claude à plusieurs reprises —, j’aime lui dire de toujours utiliser des actions de serveur au lieu 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.

Projet de référence docs. Si vous avez dans votre projet de la documentation que vous souhaitez que Claude fasse référence, utilisez le @ symbole avec le chemin du fichier :

## README.md

Veuillez lire si vous avez besoin de plus d'informations : @README.md

Commencez sans un. Nous vous recommandons de démarrer un projet sans fichier CLAUDE.md afin que vous puissiez voir où vous devez constamment corriger le cours du modèle. Cela permet de garder votre CLAUDE.md compact et axé uniquement sur les informations nécessaires. Quand tu seras prêt, cours /initialiser 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 se résume souvent au contexte — et le fichier CLAUDE.md est la façon dont vous fournissez ce contexte. Commencez par votre pile, vos préférences et vos commandes, puis construisez à partir de là au fur et à mesure.