---
title: "Utiliser AGENTS.md dans Claude Code et Codex"
description: "Codex lit AGENTS.md par défaut. Claude Code 2.1.277 ou plus récent le lit quand votre projet n’a pas de CLAUDE.md. Pour garder les deux, mettez @AGENTS.md dans votre CLAUDE.md."
canonical: "https://logbrew.co/fr/guides/agents-md"
last_updated: "2026-11-10"
---

# Utiliser AGENTS.md dans Claude Code et Codex

Codex lit `AGENTS.md` par défaut. Claude Code 2.1.277 ou plus récent le lit quand votre projet n’a pas de `CLAUDE.md`. Pour garder les deux, mettez `@AGENTS.md` dans votre `CLAUDE.md`.

Testé le 10 novembre 2026 avec Claude Code 2.1.319 et Codex CLI 0.167.0

Par [Furkan Erday](https://github.com/furkanerday). Furkan Erday est le fondateur de LogBrew. Il développe LogBrew avec Claude Code et Codex tous les jours.

Canonical: https://logbrew.co/fr/guides/agents-md

## Quand chaque agent charge `AGENTS.md`

| Votre projet contient | Claude Code | Codex |
| --- | --- | --- |
| Seulement `AGENTS.md` | Chargé | Chargé |
| `AGENTS.md` et `CLAUDE.md` | Ignoré | Chargé |
| Un `CLAUDE.md` qui importe `@AGENTS.md` | Chargé | Chargé |
| Un `CLAUDE.md` en lien symbolique vers `AGENTS.md` | Chargé | Chargé |
| `AGENTS.md` et `CLAUDE.local.md` | Ignoré | Chargé |

Nous avons lu les instructions que chaque agent envoyait avec sa première requête.

## Configurer 1 fichier pour les deux agents

### Écrire AGENTS.md à la racine du projet

Mettez vos commandes de build, vos commandes de test et vos règles de code dans 1 fichier. Les deux agents le lisent depuis la racine de votre dépôt Git jusqu’à votre dossier courant.

### Mettre à jour Claude Code

Claude Code lit `AGENTS.md` lui-même depuis la version 2.1.277. Les versions plus anciennes ont besoin de l’import de l’étape suivante.

```bash
claude update
```

### Importer AGENTS.md depuis votre CLAUDE.md

Un `CLAUDE.md`, `.claude/CLAUDE.md` ou `CLAUDE.local.md` dans votre dossier ou au-dessus empêche Claude Code de lire `AGENTS.md`. Ajoutez cette ligne à votre `CLAUDE.md` pour charger les deux.

```bash
@AGENTS.md
```

### Ou lier CLAUDE.md à AGENTS.md

Si votre `CLAUDE.md` ne contiendrait que l’import, faites-en plutôt un lien symbolique.

```bash
ln -s AGENTS.md CLAUDE.md
```

### Ou charger les deux avec un paramètre

Pour garder un `CLAUDE.local.md` tout en chargeant `AGENTS.md`, ajoutez ceci à `~/.claude/settings.json`. Dans une session, l’option des instructions du projet dans `/config` définit la même valeur.

```bash
{
  "pluginConfigs": {
    "cc-plugin-agents-md@builtin": {
      "options": { "instructionFiles": "claude-md-and-agents-md" }
    }
  }
}
```

### Vérifier ce que Codex a chargé

Lancez cette commande depuis le dossier où vous travaillez. La documentation de Codex la donne pour que Codex répète les instructions qu’il a chargées.

```bash
codex --ask-for-approval never "Summarize the current instructions."
```

## Ce que nous avons constaté en testant

Nous avons pointé les deux agents vers un serveur de test local et lu les instructions que chacun envoyait avec sa première requête. On voit ainsi exactement quels fichiers chaque agent charge.

Claude Code a chargé `AGENTS.md` quand le projet n’avait pas de `CLAUDE.md`, et son log de débogage indiquait `no CLAUDE.md found; AGENTS.md loaded`. Avec un `CLAUDE.md` à côté, Claude Code a laissé `AGENTS.md` de côté. Avec l’import `@AGENTS.md` ou le lien symbolique, le texte de `AGENTS.md` est apparu exactement une fois.

Le paramètre `pluginConfigs` ci-dessus a chargé les deux fichiers, y compris avec un `CLAUDE.local.md` dans le projet.

Codex a chargé d’abord `~/.codex/AGENTS.md`, puis le `AGENTS.md` racine, puis le fichier du dossier courant. Un `AGENTS.override.md` a remplacé le `AGENTS.md` de son dossier. Codex a ignoré un `CLAUDE.md` jusqu’à ce que nous l’ajoutions à `project_doc_fallback_filenames`. Quand les deux fichiers existaient, Codex n’a chargé que `AGENTS.md`, même avec le fichier de secours défini.

## AGENTS.md vs CLAUDE.md

Codex lit `AGENTS.override.md` ou `AGENTS.md` dans chaque dossier, plus le fichier global `~/.codex/AGENTS.md`, jusqu’à 32 Kio au total par défaut. Il ne lit `CLAUDE.md` que si vous l’ajoutez à `project_doc_fallback_filenames`.

Claude Code lit d’abord `CLAUDE.md`. Il ne lit `AGENTS.md` et `.claude/AGENTS.md` que si aucun `CLAUDE.md` de projet ne s’applique. Votre `~/.claude/CLAUDE.md` personnel ne compte pas, il se charge donc à côté de `AGENTS.md`.

## Ce que disent les tickets GitHub

Le ticket #6235, avec 409 commentaires, demandait que Claude Code prenne en charge AGENTS.md. Le 17 août 2026, un ingénieur d’Anthropic l’a fermé avec l’import et le lien symbolique ci-dessus. Claude Code lit désormais le fichier lui-même. #31005 demande aussi la prise en charge de `.agents/skills/` et reste ouvert.

## Questions fréquentes

### Claude Code lit-il AGENTS.md ?

Oui, depuis la version 2.1.277, quand aucun `CLAUDE.md`, `.claude/CLAUDE.md` ou `CLAUDE.local.md` n’existe dans votre dossier ou au-dessus. Nous l’avons confirmé sur la 2.1.319.

### Faut-il utiliser AGENTS.md ou CLAUDE.md ?

Utilisez `AGENTS.md` si quelqu’un dans votre équipe utilise Codex ou un autre agent. Gardez un `CLAUDE.md` seulement pour les règles propres à Claude Code, et importez-y `@AGENTS.md`.

### Peut-on faire de CLAUDE.md un lien symbolique vers AGENTS.md ?

Oui. Dans notre test, Claude Code a chargé le fichier lié une seule fois, comme avec l’import.

### Codex lit-il CLAUDE.md ?

Pas par défaut. Ajoutez `project_doc_fallback_filenames = ["CLAUDE.md"]` à `~/.codex/config.toml`.

## Donnez vos erreurs de production à votre agent

Connectez le serveur MCP de LogBrew et Claude Code ou Codex lira les erreurs, logs et traces des projets que vous approuvez. Commencez avec le forfait Free généreux, sans carte bancaire.

[Connecter votre agent](https://logbrew.co/fr/agents)

## Sources

- [Claude Code docs, How Claude remembers your project](https://code.claude.com/docs/en/memory#agents-md)
- [Codex docs, Custom instructions with AGENTS.md](https://learn.chatgpt.com/docs/agent-configuration/agents-md)
- [anthropics/claude-code#6235](https://github.com/anthropics/claude-code/issues/6235)
- [anthropics/claude-code#31005](https://github.com/anthropics/claude-code/issues/31005)

## Autres guides pour les agents de code IA

- [Ajouter un serveur MCP à Claude Code et Codex](https://logbrew.co/fr/guides/mcp-server-claude-code-codex)
- [Corriger l’erreur Claude overloaded 529 et l’erreur rate limit 429](https://logbrew.co/fr/guides/claude-overloaded-rate-limit-error)
- [Corriger les erreurs dans Claude Code, Codex et le JavaScript du navigateur](https://logbrew.co/fr/guides)