Depuis la version 2.1.277, Claude Code sait lire nativement les fichiers AGENTS.md, utilisés pour transmettre aux assistants de développement les conventions et instructions propres à un dépôt. Mais cette fonction dépendrait d’un paramètre distant, ce qui crée un effet inattendu : certains réglages destinés à réduire la télémétrie empêchent également son activation.
Les variables DISABLE_TELEMETRY, CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC ou DO_NOT_TRACK peuvent couper les appels nécessaires à la récupération du feature flag tengu_agents_md_mod. Claude Code continue alors de fonctionner, mais ignore silencieusement AGENTS.md.
Pourquoi ce comportement pose problème
Un fichier AGENTS.md peut contenir des règles essentielles : commandes de test, architecture du projet, conventions de code, restrictions de sécurité ou procédures de déploiement. S’il n’est pas chargé, l’assistant peut produire des modifications incompatibles sans que l’utilisateur comprenne immédiatement pourquoi.
Le problème vient moins de l’existence d’un déploiement progressif que du couplage entre une préférence de confidentialité et une fonction locale. L’absence d’avertissement rend le diagnostic difficile, notamment dans les environnements d’entreprise où les connexions non essentielles sont bloquées par politique.
Comment vérifier et contourner le problème
- confirmer la version de Claude Code utilisée ;
- contrôler les variables d’environnement liées à la télémétrie ;
- tester explicitement si les instructions d’AGENTS.md sont prises en compte ;
- éviter de supposer qu’un fichier présent dans le dépôt est automatiquement chargé.
Le contournement proposé consiste à créer un fichier CLAUDE.md contenant simplement @AGENTS.md. Cet import suit un autre mécanisme et reste fonctionnel même lorsque les communications non essentielles sont désactivées.
Un enjeu de prévisibilité pour les outils d’IA
Les assistants de code deviennent une partie de la chaîne de développement. Leurs fonctions structurantes doivent donc être déterministes, documentées et observables. Une option de confidentialité ne devrait pas modifier silencieusement l’interprétation du dépôt.
Les équipes peuvent intégrer un test de démarrage demandant à l’agent de résumer les règles actives. Elles devraient également versionner CLAUDE.md et AGENTS.md, éviter d’y placer des secrets et considérer ces fichiers comme du code de configuration soumis à revue.
