Claude Code vous fait choisir entre vie privée et AGENTS.md
Depuis sa version 2.1.277, Claude Code sait parfaitement lire les fichiers AGENTS.md. Ainsi, quand un projet n’a pas de CLAUDE.md, il prend l’AGENTS.md à la place, ce qui est super confortable pour tous ceux qui jonglent entre plusieurs agents. Enfin… sauf si vous avez coupé sa télémétrie, parce que dans ce cas-là, bizarrement, votre fichier AGENTS.md est totalement ignoré !
AGENTS.md, pour ceux qui débarquent, c’est un fichier Markdown que les agents de code lisent pour comprendre un projet. Codex, Amp ou Cursor s’y mettaient déjà en août 2025 (souvenez-vous de
). Alors que chez Anthropic, la demande a traîné durant 1 an sur GitHub, jusqu’à ce que Boris Cherny, qui bosse sur Claude Code, ferme le ticket en août en conseillant une astuce, un CLAUDE.md qui contient juste @AGENTS.md, pour que Claude Code importe le fichier.
Puis la 2.1.277 est arrivée avec une vraie lecture native d’AGENTS.md, sans CLAUDE.md du tout, et c’est elle qui pose problème…
Parce que cette lecture native passe en réalité par un plugin intégré, qui est off par défaut et qui ne s’allume que si un feature flag récupéré chez Anthropic, tengu_agents_md_mod, lui dit oui. Et si ce flag ne répond pas, bah c’est "niet", et le fichier n’est jamais lu. Hé oui c’est bizarre qu’un accès à un fichier local nécessite un tel appel réseau…
Et ce « non », on l’obtient sans même le savoir, puisqu’il suffit d’activer DISABLE_TELEMETRY, CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC ou même DO_NOT_TRACK, ou encore de passer par Bedrock et les autres fournisseurs tiers.
Attention, même à 0 (donc activé), DISABLE_TELEMETRY coupera la télémétrie. En fait, n’importe quelle valeur non vide compte.
Le pire, c’est que rien ne vous avertit. C’est vrai que quand AGENTS.md est chargé, Claude Code l’annonce avec une petite ligne dans la session, mais quand il est ignoré, hé bien y’a rien du tout. Et c’est assez impactant car ensuite le modèle répond sans vos consignes, et vous vous tapez à reformuler vos prompts en boucle en croyant que l’IA vous ignore, alors que le fichier ne lui est tout simplement jamais parvenu.
Et le comble, c’est que c’est documenté, et
la page des variables d’environnement
liste même tout ce qu’on perd quand les flags ne sont pas récupérés, lecture d’AGENTS.md comprise. Pourtant, y’a aucun rapport logique… Couper la télémétrie, de mon point de vue, ça reste un choix légitime et ça ne devrait couper que l’envoi de statistiques à Anthropic et pas la lecture d’un stupide fichier texte. Bref, ça me dépasse, ce genre de bug ou de "fonctionnalité".
En attendant, la parade est celle que conseillait Boris Cherny… À côté de chaque AGENTS.md, posez un bon vieux CLAUDE.md qui contient une seule ligne, @AGENTS.md. Par défaut, dès qu’un CLAUDE.md existe, la lecture native ne s’en mêle même plus, et c’est l’import qui fait le boulot. Et comme les imports de CLAUDE.md ne dépendent d’aucun flag, hé bien ça passe tranquillou, télémétrie coupée ou pas.
Comme ça vous préservez votre vie privée ET vos consignes.
Source :
Source : korben.info