# Claude Code 2.1.277 : charger directement AGENTS.md > Le 18 septembre 2026, Claude Code 2.1.277 a bénéficié d’une prise en charge directe de AGENTS.md : dans quels cas le fichier est chargé, comment choisir l’un des 4 modes et que faire des imports. Source: https://ailoot.ai/blog/fr/claude-code-agents-md-support/ Canonical: https://ailoot.ai/blog/fr/claude-code-agents-md-support/ Language: fr Publisher: Ailoot (https://ailoot.ai/) Translation: guide-041 Revision: sha256-55e50ebb102dfe2350be271875ff9377bbafdaeae6b3a0539d472570ed9e8c32 Le 18 septembre 2026, la prise en charge de `AGENTS.md` a été ajoutée à Claude Code 2.1.277. Si la fonctionnalité est disponible dans la session et dans le répertoire de travail, et qu’il n’y a aucun `CLAUDE.md`, `.claude/CLAUDE.md` ou `CLAUDE.local.md` dans la chaîne de répertoires située au-dessus, Claude Code lit `AGENTS.md` par défaut, sans import manuel. Auparavant, cela se faisait au moyen d’un import `@AGENTS.md` dans `CLAUDE.md` ou d’un lien symbolique de `CLAUDE.md` vers `AGENTS.md` — pour en savoir plus, consultez l’article [sur un fichier d’instructions commun à plusieurs agents](https://ailoot.ai/blog/fr/agents-md-claude-md-one-instruction-file/). Si vous utilisez Claude Code et un ou deux autres outils dans le même dépôt, le mode Project instructions que vous choisissez détermine les fichiers d’instructions lus par Claude Code. Vous trouverez ci-dessous les conditions propres à chacun des quatre modes et les étapes à suivre pour passer de l’ancienne configuration à la nouvelle. D’autres ressources sur la configuration des outils sont disponibles dans la [documentation Ailoot](https://ailoot.ai/docs/).
[Guides Ailoot](https://ailoot.ai/docs/)
## Comment Claude Code 2.1.277 charge-t-il AGENTS.md ?
À retenir Depuis le 18 septembre 2026, Claude Code lit `AGENTS.md` par défaut s’il n’y a aucun `CLAUDE.md`, `.claude/CLAUDE.md` ou `CLAUDE.local.md` dans la chaîne de répertoires, du dossier de travail vers le haut. Si l’un de ces fichiers existe, la lecture automatique de `AGENTS.md` via Project instructions n’est pas activée. Un import explicite `@AGENTS.md` depuis `CLAUDE.md` continue de fonctionner. Le fichier utilisateur `~/.claude/CLAUDE.md`, le `CLAUDE.md` géré par l’organisation et les fichiers `.claude/rules/` sont chargés indépendamment du choix entre les fichiers du projet. Le mode se règle avec `/config`. La fonctionnalité n’est pas encore disponible sur Bedrock, Vertex ou Foundry.
Le CHANGELOG.md officiel du projet Claude Code sur GitHub le formule ainsi :

Prise en charge de AGENTS.md ajoutée : dans un projet sans CLAUDE.md, Claude Code lit AGENTS.md à la place ; le réglage se modifie dans « Project instructions » sous /config (pas encore disponible sur Bedrock, Vertex ou Foundry)

— Anthropic, commit du CHANGELOG.md de claude-code, ca02e7d, https://github.com/anthropics/claude-code/commit/ca02e7deeb0707f558b0afd7e9e5d67a382e12b3
Traduction : la prise en charge de `AGENTS.md` a été ajoutée — dans un projet sans `CLAUDE.md`, Claude Code lit désormais `AGENTS.md` à la place ; ce réglage peut être modifié dans « Project instructions », sous `/config` (pas encore disponible sur Bedrock, Vertex ou Foundry). Avant cette version, l’absence de `CLAUDE.md`, `.claude/CLAUDE.md` et `CLAUDE.local.md` dans le dossier de travail et au-dessus ne suffisait pas, à elle seule, à activer la lecture de `AGENTS.md`. Il fallait un import explicite, un lien symbolique ou un hook manuel. Désormais, lorsque la fonctionnalité est disponible, l’agent récupère automatiquement le fichier. ## Quels fichiers empêchent la lecture automatique de AGENTS.md ?
À retenir En mode par défaut, les fichiers `CLAUDE.md`, `.claude/CLAUDE.md` et `CLAUDE.local.md` sont vérifiés dans le répertoire de travail et au-dessus. Le fichier personnel `~/.claude/CLAUDE.md`, le `CLAUDE.md` géré par l’organisation et les fichiers `.claude/rules/` n’empêchent pas la lecture de `AGENTS.md` et sont chargés en parallèle.
Si vous avez un fichier personnel `~/.claude/CLAUDE.md` contenant des paramètres de style de codage, il n’empêchera pas Claude Code de lire le `AGENTS.md` du projet. En revanche, tout fichier `CLAUDE.local.md` dans le dossier de travail — même s’il n’est pas ajouté à Git et sert à des notes personnelles — bloque la lecture automatique de `AGENTS.md` en mode par défaut. Un import explicite continue de fonctionner ; pour lire directement les deux fichiers, vous devez changer de mode. Si un mode de lecture directe est sélectionné dans Project instructions (voir « 4 modes Project instructions : lequel choisir ? » ci-dessous) et qu’il n’y a aucun `CLAUDE.md`, `.claude/CLAUDE.md` ou `CLAUDE.local.md` dans le répertoire de travail ou au-dessus, Claude Code lit au démarrage de la session tous les fichiers `AGENTS.md` et `.claude/AGENTS.md` présents dans ces répertoires. En l’absence de fichiers bloquants, la documentation montre une ligne de ce type dans une session interactive : ``` no CLAUDE.md found; AGENTS.md loaded: /home/you/repo/AGENTS.md ``` Un fichier `AGENTS.md` dans un sous-répertoire est chargé lorsque Claude y ouvre un fichier avec l’outil Read. En mode `claude-md-or-agents-md`, cela ne se produit que si ce sous-répertoire ne contient pas son propre `CLAUDE.md`, `.claude/CLAUDE.md` ou `CLAUDE.local.md`. Pour `claude-md-and-agents-md`, la documentation décrit la règle générale : `CLAUDE.md` et `AGENTS.md` sont lus ensemble, avec `CLAUDE.md` en premier, puis `AGENTS.md` dans chaque répertoire. `AGENTS.local.md`, `AGENTS.override.md` et tout ce qui se trouve dans le répertoire `.agents/` ne sont pas lus automatiquement. Vous trouverez dans la [documentation Ailoot](https://ailoot.ai/docs/) des ressources sur la configuration de l’espace de travail d’un agent IA, notamment les fichiers d’instructions contenant le contexte du projet.
[Guides Ailoot](https://ailoot.ai/docs/)
## 4 modes Project instructions : lequel choisir ?
À retenir Dans la section Project instructions de la commande `/config`, quatre valeurs sont possibles : `claude-md-or-agents-md` (par défaut — l’un des deux fichiers), `claude-md-and-agents-md` (les deux ensemble), `claude-md` (seul `CLAUDE.md` est lu automatiquement, même si le projet ne contient que `AGENTS.md`) et `managed-only` (au démarrage, uniquement le `CLAUDE.md` géré par l’organisation et la mémoire automatique, sans fichiers du projet ni fichiers personnels). Le changement prend effet au prochain message envoyé et dans chaque nouvelle session.
Le comportement des modes du tableau est décrit dans la documentation d’Anthropic. La colonne de droite propose des recommandations pour choisir un mode : | Valeur | Fichiers lus par Claude Code | Quand utiliser ce mode | |----|----|----| | `claude-md-or-agents-md` | `CLAUDE.md`, ou `AGENTS.md` s’il n’y a aucun `CLAUDE.md`, `.claude/CLAUDE.md` ou `CLAUDE.local.md` dans le répertoire de travail ou au-dessus | Mode par défaut si le dépôt n’utilise qu’un seul des deux fichiers et qu’aucun fichier bloquant ne se trouve au-dessus | | `claude-md-and-agents-md` | Les deux fichiers ensemble : dans chaque répertoire, d’abord `CLAUDE.md`, puis `AGENTS.md` | Vous avez besoin d’un `AGENTS.md` commun à tous les outils et d’un `CLAUDE.md` succinct réservé à Claude ; ou vous devez lire `AGENTS.md` quand `CLAUDE.local.md` existe | | `claude-md` | Seul `CLAUDE.md` ; la lecture automatique de `AGENTS.md` via Project instructions est désactivée, même si `AGENTS.md` est le seul fichier (un import explicite `@AGENTS.md` depuis `CLAUDE.md` fonctionne toujours) | `AGENTS.md` est rédigé pour un autre outil et risque de perturber Claude | | `managed-only` | Au démarrage de la session, uniquement le `CLAUDE.md` géré par l’organisation et la mémoire automatique ; les fichiers `CLAUDE.md` du projet, locaux et utilisateur, les fichiers `.claude/rules/` et tous les fichiers `AGENTS.md` sont exclus de l’ensemble initial. Toutefois, les fichiers `CLAUDE.md` et `.claude/rules/` des sous-répertoires sont toujours chargés plus tard lorsque Claude y ouvre un fichier. Ce mode limite l’ensemble initial, mais n’isole pas complètement des fichiers du projet | Pour les organisations qui veulent contrôler l’ensemble d’instructions utilisé par Claude Code au début d’une session, que le projet contienne ou non `CLAUDE.md` ou `AGENTS.md` | Vous pouvez aussi choisir le mode sans passer par l’interface, dans `settings.json` : ```json { "pluginConfigs": { "agents-md@builtin": { "options": { "instructionFiles": "claude-md-and-agents-md" } } } } ``` Claude Code ignore cette valeur dans les paramètres `project` et `local`. Selon la documentation d’Anthropic, elle peut être définie dans `~/.claude/settings.json`, dans un fichier `--settings` ou dans les paramètres gérés par l’organisation. Si vous avez déjà configuré un fichier d’instructions commun à plusieurs outils d’IA dans un dépôt, les [instructions pour les versions antérieures à 2.1.277](https://ailoot.ai/blog/fr/agents-md-claude-md-one-instruction-file/) expliquent le fonctionnement de l’import `@`. Cette méthode fonctionne toujours. ## Pourquoi la section Project instructions n’apparaît-elle pas dans /config ?
À retenir Selon la documentation d’Anthropic, la section Project instructions peut être absente pour les raisons suivantes : - Claude Code est dans une version antérieure à 2.1.277. - La session ne reçoit pas les feature flags d’Anthropic — par exemple, lors de l’utilisation de Bedrock, d’un autre fournisseur tiers ou lorsque la télémétrie est désactivée. - Il s’agit de la première session juste après l’installation ou la mise à jour depuis une version antérieure. Si c’est la seule raison, la fonctionnalité apparaîtra lors de la prochaine session. `AGENTS.md` ne sera chargé que si les conditions du mode sélectionné sont réunies. - Le plugin intégré `agents-md` est désactivé dans `/plugin`.
Commencez par vérifier la version à l’aide de la commande `claude --version`. Si elle est antérieure à 2.1.277, mettez Claude Code à jour. Si la version convient mais que la section n’apparaît toujours pas, vérifiez les autres raisons indiquées ci-dessus. Tant que la fonctionnalité n’est pas disponible, l’import de `@AGENTS.md` dans `CLAUDE.md` reste une solution de repli qui fonctionne. ## Que faire de l’ancien import @AGENTS.md ?
À retenir Vous pouvez conserver l’import `@AGENTS.md` dans `CLAUDE.md` ainsi que le lien symbolique : le fichier ne sera lu deux fois dans aucun mode. Si vous gardez `CLAUDE.md`, remplacez une consigne textuelle demandant de « lire AGENTS.md » par un import. Avant de supprimer un fichier, sauvegardez toutes les instructions nécessaires et vérifiez les conditions du mode sélectionné. Si vous passez à la lecture directe, supprimez tout hook `SessionStart` qui affichait manuellement le contenu de `AGENTS.md` ; sinon, une deuxième copie du fichier sera ajoutée au contexte. Vérifiez ensuite le chargement dans une nouvelle session ; la méthode dépend de la version et de la présence éventuelle de fichiers bloquants.
Les étapes suivantes dépendent de votre ancienne configuration. Commencez par vérifier que la fonctionnalité est disponible dans votre session, comme indiqué dans la section précédente. - **`CLAUDE.md` avec un import `@AGENTS.md`.** Vous pouvez le laisser tel quel : Claude Code ne lira pas le fichier deux fois, quelle que soit la valeur de Project instructions. La suppression de `CLAUDE.md` est facultative : l’import donne déjà à Claude accès au contenu de `AGENTS.md`. Continuez à vérifier le chargement via l’import avec `/memory` ; demander directement à Claude le contenu des instructions ne constitue qu’une vérification peu fiable. - **`CLAUDE.md` qui demande en toutes lettres de lire `AGENTS.md`.** Une telle demande n’est pas un import et ne garantit pas, à elle seule, que le fichier sera chargé. Remplacez cette formulation par un import `@AGENTS.md` si vous souhaitez conserver `CLAUDE.md` (par exemple, pour les outils qui le lisent aussi). Si vous décidez de supprimer entièrement `CLAUDE.md` et que le mode `claude-md-or-agents-md` est sélectionné, vérifiez d’abord que `CLAUDE.md` ne contient aucune instruction unique et qu’il n’y a pas d’autre `CLAUDE.md`, `.claude/CLAUDE.md` ou `CLAUDE.local.md` dans le répertoire de travail ou au-dessus ; sinon, Claude Code continuera de lire le fichier restant au lieu de `AGENTS.md`. Après l’avoir supprimé, vérifiez que la transition a bien eu lieu : lorsqu’il ne reste aucun fichier bloquant, la ligne `AGENTS.md loaded` apparaît dans une session interactive. Si `CLAUDE.md` reste en place et que les deux fichiers sont lus en mode `claude-md-and-agents-md`, vérifiez `/memory` (à partir de la version 2.1.280). Une question directe à Claude ne permet pas de distinguer le chargement direct d’un import. - **Lien symbolique de `CLAUDE.md` vers `AGENTS.md`.** Vous pouvez le conserver : aucun mode ne provoquera une double lecture. Avant de supprimer le lien en mode `claude-md-or-agents-md`, vérifiez que les instructions nécessaires sont préservées et qu’il n’y a pas d’autre `CLAUDE.md`, `.claude/CLAUDE.md` ou `CLAUDE.local.md` dans le répertoire de travail ou au-dessus. Vérifiez le chargement de la même manière : avec la ligne `AGENTS.md loaded` au démarrage lorsqu’il n’y a aucun fichier bloquant, ou avec `/memory` (version 2.1.280+). Si `CLAUDE.md` reste en place en mode `claude-md-and-agents-md`, demander directement à Claude ne constitue qu’une vérification peu fiable. L’absence d’erreur ne suffit pas à confirmer le chargement. - **Un hook `SessionStart` qui affichait manuellement le contenu de `AGENTS.md`.** Lorsque le fichier est lu directement, un tel hook ajoute une deuxième copie au contexte. Tant que le hook fonctionne, la question « que contiennent tes instructions ? » ne confirme pas le chargement direct : Claude peut répondre à partir du texte ajouté par le hook. Procédez dans cet ordre : 1. Vérifiez que la fonctionnalité est disponible : version 2.1.277 ou ultérieure, session recevant les feature flags, plugin activé et première session après installation ou mise à jour terminée. Choisissez un mode de lecture directe — ni `claude-md` ni `managed-only`. En mode par défaut, vérifiez également qu’il n’y a aucun fichier bloquant. 2. Supprimez le hook. 3. Fermez la session et ouvrez-en une nouvelle. Le hook `SessionStart` ajoute son texte au démarrage ; son contenu reste donc dans le contexte d’une session déjà ouverte. Dans une telle session, la réponse de Claude sur le contenu des instructions ne confirmera pas le chargement direct. 4. Vérifiez le chargement dans la nouvelle session. À partir de la version 2.1.280, le chemin vers `AGENTS.md` est visible dans `/memory`. Dans les versions 2.1.277–2.1.279, s’il n’y a aucun fichier bloquant, cherchez au démarrage la ligne `AGENTS.md loaded` : la documentation la décrit spécifiquement pour le cas où aucun `CLAUDE.md` n’a été trouvé. Si vous gardez `CLAUDE.md` et utilisez le mode `claude-md-and-agents-md`, la vérification est limitée : `/memory` n’affiche pas `AGENTS.md` dans ces versions, la documentation ne décrit aucune ligne de chargement pour ce cas et une paraphrase des instructions ne permet pas de distinguer une lecture directe d’un import `@` dans `CLAUDE.md`. Dans ce cas, passez à la version 2.1.280+ et vérifiez avec `/memory`. ## Comment vérifier que AGENTS.md a été chargé
À retenir À partir de la version 2.1.280, `AGENTS.md` chargé via Project instructions apparaît dans `/memory` et dans la liste des fichiers Memory de la commande `/context`. Dans les versions 2.1.277–2.1.279, il n’y apparaît pas, même si les commandes fonctionnent et affichent les fichiers `CLAUDE.md` et autres fichiers mémoire chargés. Dans ces versions, s’il n’y a aucun fichier bloquant, vérifiez au démarrage de la session que la ligne `AGENTS.md loaded` apparaît. Demander à Claude le contenu des instructions ne constitue qu’une vérification peu fiable : la réponse ne permet pas de distinguer une lecture directe d’un import `@` et peut s’appuyer sur le texte ajouté par un hook `SessionStart`. Il est donc préférable de poser cette question uniquement dans une nouvelle session, après avoir supprimé un tel hook.
Deux autres différences par rapport à un `CLAUDE.md` ordinaire : les hooks `InstructionsLoaded` ne se déclenchent pas pour ce type de `AGENTS.md` (ils fonctionnent bien pour un `AGENTS.md` importé avec la syntaxe `@` depuis `CLAUDE.md` ou relié par un lien symbolique `CLAUDE.md`) ; les répertoires ajoutés avec l’option `--add-dir` et la variable `CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD` ne chargent que le `CLAUDE.md` de ce répertoire — son `AGENTS.md` n’est pas inclus. Si vous devez examiner le contenu d’un fichier d’instructions volumineux, consultez l’analyse distincte [sur la configuration de CLAUDE.md sans le rendre trop volumineux](https://ailoot.ai/blog/fr/claude-md-template/). Elle traite de la structure des instructions ; les conditions de chargement de `AGENTS.md` sont décrites ci-dessus. Pour les notes de travail entre les sessions, consultez l’analyse sur [une seconde mémoire dans Claude Code](https://ailoot.ai/blog/fr/claude-code-second-brain/) — consacrée à la mémoire personnelle qui s’ajoute aux instructions du projet. ## Et ensuite ? La fonctionnalité a été publiée le 18 septembre 2026 dans la version 2.1.277. Anthropic pourrait préciser le fonctionnement des modes dans de futures versions ; avant de modifier les paramètres d’un projet important, comparez donc cet article avec la version actuelle de `/config` et le changelog officiel.
### Sources - [Claude Code, commit du CHANGELOG.md contenant l’entrée 2.1.277 sur GitHub (18 septembre 2026)](https://github.com/anthropics/claude-code/commit/ca02e7deeb0707f558b0afd7e9e5d67a382e12b3) - [Documentation Claude Code : comment Claude mémorise votre projet — section AGENTS.md](https://code.claude.com/docs/en/memory)
[Guides Ailoot](https://ailoot.ai/docs/)
[Accéder à Ailoot](https://ailoot.ai/)
## Questions fréquentes : Claude Code 2.1.277 : charger directement AGENTS.md ### Pourquoi AGENTS.md n’est-il pas chargé alors qu’il existe ? En mode par défaut, CLAUDE.md, .claude/CLAUDE.md ou CLAUDE.local.md dans le dossier courant ou un parent bloque la sélection automatique d’AGENTS.md. Vérifiez aussi version, disponibilité de la fonction et mode Project instructions dans /config. ### Comment vérifier le chargement direct après retrait d’un hook manuel ? Ouvrez une nouvelle session pour exclure l’ancienne sortie SessionStart. À partir de 2.1.280, consultez /memory ou Memory files dans /context. En 2.1.277–2.1.279, la ligne de chargement initial s’applique sans CLAUDE.md bloquant. Une paraphrase de Claude seule est une preuve faible. ## Ailoot · L’entreprise et son portefeuille de projets Ailoot s’appuie sur une expérience opérationnelle éprouvée, une large clientèle, un service stable et un suivi continu des KPI. L’entreprise et son portefeuille de projets : des millions de clients ; des ventes qui se chiffrent en milliards chaque mois. Ailoot met cette expérience opérationnelle au service de l’accès API aux fonctions d’IA dans les produits des clients, leurs agents, applications et automatisations.