Claude Code ne lit AGENTS.md que si la télémétrie est activée

Claude Code ne lit AGENTS.md que lorsque sa télémétrie est activée, selon un rapport de bogue déposé contre l'agent de programmation d'Anthropic le 20 septembre 2026. La fonction est arrivée avec la version 2.1.277. Quiconque a coupé l'envoi des données d'usage, ou utilise l'outil via Amazon Bedrock ou Google Vertex, n'obtient aucun AGENTS.md. Rien ne l'indique à l'écran.

Le rapport est l'issue #95690 du dépôt public de Claude Code. Un billet de blog publié le 23 septembre décrit le même comportement et un contournement.

Ce que devait faire la prise en charge d'AGENTS.md

AGENTS.md est un fichier d'instructions en texte brut que partagent plusieurs agents de programmation. Il indique à un agent comment un projet se compile, se teste et s'organise. Claude Code a son propre fichier pour ce rôle, appelé CLAUDE.md.

La version 2.1.277 promettait une règle simple. Selon les notes de version citées par l'issue, "dans un projet sans CLAUDE.md, Claude Code lit AGENTS.md à la place". Tech AI Wire a couvert ce changement à sa sortie : Claude Code 2.1.277 lit AGENTS.md en solution de repli.

Pourquoi cela ne marche pas sans télémétrie

D'après l'issue, la fonction n'est pas intégrée au chargement normal. C'est un plugin intégré, désactivé par défaut. Un interrupteur distant l'active.

Cet interrupteur est un feature flag nommé tengu_agents_md_mod, servi par Statsig. Statsig est un service externe qui permet à une entreprise d'activer ou de couper des fonctions pour ses utilisateurs sans publier de nouvelle version. Pour vérifier le flag, Claude Code doit joindre ce service.

Il n'y parvient pas dans plusieurs configurations courantes, selon l'issue et le billet.

Configuration	AGENTS.md chargé ?
Installation par défaut, télémétrie active	Oui, une fois le flag activé
DISABLE_TELEMETRY=1 défini	Non
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1 défini	Non
Via Bedrock ou Vertex	Non

Dans chaque cas "non", le fichier est simplement ignoré. L'issue décrit le résultat sans détour : "Aucune erreur. Aucun avertissement. Il ne se charge tout simplement pas." L'auteur du rapport a classé l'impact comme critique.

Le reproche : un fichier local derrière un interrupteur distant

Les deux sources avancent le même argument. Lire un fichier Markdown dans le dossier du projet ne demande aucun réseau. Le lier à un flag côté serveur fait qu'un choix de confidentialité désactive en silence une fonction sans rapport.

L'issue parle de "la lecture d'un fichier Markdown local, un acte qui ne demande aucun réseau", qui "est verrouillée en silence par un interrupteur côté serveur". Le billet en fait une règle : "Un réglage de confidentialité ne devrait jamais couper en silence un comportement local sans rapport."

Le contournement

Le billet donne une solution qui fonctionne dès aujourd'hui. Créez un CLAUDE.md dans le projet et faites-lui importer l'autre fichier en une ligne : @AGENTS.md. Claude Code lit toujours CLAUDE.md, et l'import charge AGENTS.md avec lui. Aucun flag n'intervient.

Ce que cela signifie pour les développeurs

Vérifiez si votre configuration correspond à l'une des lignes "non" ci-dessus. Les équipes qui coupent la télémétrie par politique d'entreprise, et celles qui passent par un fournisseur cloud pour accéder à Claude, sont les cas probables. Si l'un d'eux vous concerne, partez du principe qu'AGENTS.md n'est pas lu, quoi que disent les notes de version.

L'import d'une ligne dans CLAUDE.md est le choix sûr pour l'instant. Il coûte un seul petit fichier et se comporte de la même façon partout. Si vous aviez supprimé un CLAUDE.md après la version 2.1.277, remettez-en un, minimal.

Testez les instructions plutôt que de leur faire confiance. Demandez à l'agent de répéter une règle qui n'existe que dans AGENTS.md, comme votre commande de test. S'il n'y arrive pas, le fichier n'a pas été chargé. Faites-le une fois par environnement utilisé dans votre équipe.

Suivez l'issue #95690 pour un correctif. La leçon plus large est que le comportement d'un outil peut dépendre d'interrupteurs invisibles. Garder ses instructions dans un fichier que l'outil lit toujours reste le choix fiable.