CLAUDE.md et AGENTS.md

IA / LLM 🟢 Junior

Définition

Fichiers Markdown lus par l'agent en début de session pour connaître le projet : commandes de build et de test, conventions, architecture, interdits. AGENTS.md est un format ouvert adopté par plus de 60 000 dépôts et plus de 25 outils (Codex, Cursor, Copilot, Jules, Devin, Zed…). CLAUDE.md est le fichier de Claude Code, hiérarchisé (~/.claude/CLAUDE.md, ./CLAUDE.md, CLAUDE.local.md, .claude/rules/) ; Claude Code lit aussi AGENTS.md.

Analogie

Le README écrit pour le nouveau collègué robot : où sont les choses, comment on teste, ce qu'on ne touche pas.

Exemple de code

# CLAUDE.md (racine du dépôt) — concis, vérifiable, une consigne par ligne
# Projet
- Monorepo pnpm : apps/api (NestJS), apps/web (Next.js), packages/shared
# Commandes
- Tests : `pnpm test` (Vitest) — toujours les lancer avant de proposer un diff
- Lint  : `pnpm lint --fix`
# Conventions
- TypeScript strict, pas de `any`, erreurs métier via `DomainError`
- Migrations SQL dans apps/api/migrations, jamais de `DROP` sans revue
# Interdits
- Ne jamais modifier `.env*` ni committer de secret
@docs/architecture.md

Cas d'usage

Tout dépôt sur lequel travaille un agent : réduit les erreurs répétées et les questions.

Anti-pattern

Un CLAUDE.md de 2 000 lignes qui recopie la doc : l'agent le lit à chaque session, le contexte s'encombre.

Termes liés

#ia#agents#dev#interview

En entretien

C'est quoi un fichier CLAUDE.md ?
C'est un fichier Markdown lu par l'agent en début de session pour connaître le projet : commandes de build et de test, conventions, architecture, interdits. C'est un peu le README écrit pour le nouveau collègue robot.
Quelle différence entre CLAUDE.md et AGENTS.md ?
AGENTS.md est un format ouvert adopté par plus de 60 000 dépôts et 25 outils différents, alors que CLAUDE.md est spécifique à Claude Code et hiérarchisé entre plusieurs emplacements. Claude Code lit d'ailleurs aussi AGENTS.md.
Pourquoi éviter un CLAUDE.md de 2000 lignes ?
Parce que l'agent le lit à chaque session, et un fichier trop long qui recopie toute la doc encombre inutilement le contexte. Il vaut mieux rester concis, avec une consigne par ligne.

Sources

Fiche mise à jour le 2026-09-27