Home / Glossary / CLAUDE.md

Definition

CLAUDE.md

CLAUDE.md est un fichier de configuration markdown placé à la racine de votre projet qui fournit à Claude Code des instructions persistantes et spécifiques au projet. Il indique à l'agent vos conventions de codage, votre architecture, vos commandes courantes et vos règles — servant de forme de mémoire à long terme qui s'applique à chaque session dans ce projet.

Comment fonctionne CLAUDE.md

Quand Claude Code démarre une session, il lit automatiquement le fichier CLAUDE.md à la racine de votre projet (ainsi que tout fichier CLAUDE.md dans les répertoires parents ou sous-répertoires). Le contenu fait partie du contexte système de l'agent, qui suit ainsi vos instructions sans avoir besoin d'être rappelé à chaque session. Cela rend l'agent cohérent avec les conventions de votre équipe.

Que mettre dans CLAUDE.md

  • +Vue d'ensemble de l'architecture du projet et emplacements des fichiers clés
  • +Conventions de codage (nommage, formatage, patterns à utiliser ou éviter)
  • +Commandes courantes pour les tests, le build et le déploiement
  • +Règles comme « toujours écrire des tests pour les nouvelles fonctions » ou « ne jamais modifier le module d'authentification directement »
  • +Détails de la stack technique dont l'agent doit avoir connaissance
markdown
# CLAUDE.md

## Project
Next.js 14 app with App Router, TypeScript, Tailwind CSS.

## Commands
- `npm run dev` — start dev server
- `npm test` — run Jest tests
- `npm run lint` — ESLint check

## Conventions
- Use server components by default
- Client components go in `components/client/`
- All API routes must validate input with Zod
- Write tests for every new utility function

## Do NOT
- Modify files in `lib/core/` without explicit approval
- Use `any` type in TypeScript
- Add new dependencies without justification

Gardez CLAUDE.md concis. L'agent le lit à chaque session, donc n'incluez que les informations pertinentes pour plusieurs tâches. Déplacez les détails spécifiques aux tâches dans vos prompts.

Où placer le fichier CLAUDE.md ?+
Placez-le à la racine de votre répertoire de projet. Claude Code supporte aussi les fichiers CLAUDE.md dans les sous-répertoires pour des instructions spécifiques aux modules, et dans les répertoires parents pour des règles à l'échelle de l'organisation. Tous les fichiers applicables sont fusionnés ensemble.
CLAUDE.md fonctionne-t-il avec d'autres outils IA ?+
CLAUDE.md est spécifique à Claude Code. Cependant, certains autres outils ont adopté des concepts similaires. Cursor utilise .cursorrules, et d'autres agents peuvent lire des fichiers de configuration personnalisés. Le concept d'instructions IA au niveau du projet devient un pattern courant.
Quelle doit être la longueur de CLAUDE.md ?+
Gardez-le sous les 500 lignes. Concentrez-vous sur les conventions et règles les plus importantes. L'agent peut toujours lire des fichiers individuels pour les détails — CLAUDE.md doit fournir le contexte de haut niveau qui s'applique à travers les tâches.

Related terms

Codage AgentiqueClaude CodePrompt Engineering pour le code

Master Claude Code in days, not months

37 hands-on lessons from beginner to CI/CD automation. Module 1 is free.

START FREE →
← ALL TERMS