Claude Code 2.1.277 : charger directement AGENTS.md

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.

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.

Comment Claude Code 2.1.277 charge-t-il AGENTS.md ?#

Le CHANGELOG.md officiel du projet Claude Code sur GitHub le formule ainsi :

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 ?#

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 des ressources sur la configuration de l’espace de travail d’un agent IA, notamment les fichiers d’instructions contenant le contexte du projet.

4 modes Project instructions : lequel choisir ?#

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 :

Vous pouvez aussi choisir le mode sans passer par l’interface, dans settings.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 expliquent le fonctionnement de l’import @. Cette méthode fonctionne toujours.

Pourquoi la section Project instructions n’apparaît-elle pas dans /config ?#

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 ?#

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é#

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. 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 — 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.