Claude Code ignore AGENTS.md sans télémétrie
Original : Claude Code reads AGENTS.md only when telemetry is on [fixed]
Pourquoi c'est important
Un outil de dev qui ignore silencieusement ses fichiers de config érode la confiance des développeurs.
Claude Code 2.1.277 supporte AGENTS.md, mais le chargement du fichier dépend d'un flag réseau distant. Avec DISABLE_TELEMETRY=1 ou CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1, le fichier est ignoré sans aucun avertissement.
Le plugin agents-md, introduit dans Claude Code 2.1.277, est désactivé par défaut (isOnByDefault = false). Son activation dépend d'un flag distant appelé tengu_agents_md_mod. Si Claude Code ne peut pas joindre le serveur de flags — notamment quand la télémétrie est coupée — le plugin reste inactif et AGENTS.md n'est jamais lu.
L'ingénieur Przemek Szypowski a reproduit le problème avec un test simple : un répertoire contenant uniquement un AGENTS.md avec un mot-clé unique, interrogé via claude -p. Résultat : avec DISABLE_TELEMETRY=1 ou CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1, le modèle répond systématiquement comme si aucune instruction projet n'existait. Pire, mettre ces variables à 0 ne suffit pas à réactiver la fonctionnalité.
Même constat pour Bedrock et Vertex : les passerelles tierces ne peuvent pas résoudre le flag à true. Le problème est confirmé dans le ticket GitHub #95690.
Contournement : créer un fichier CLAUDE.md contenant une seule ligne (@AGENTS.md). Ce mécanisme d'import ne dépend pas du flag distant. Cela fonctionne, mais annule l'intérêt même du support d'AGENTS.md, censé justement rendre CLAUDE.md superflu.