Claude Code, l'assistant de développement en ligne de commande d'Anthropic, intègre depuis sa version 1.0 un système de télémétrie qui envoie des données d'usage vers les serveurs d'Anthropic. Cette télémétrie, documentée dans les conditions d'utilisation, soulève une question technique précise : lorsqu'elle est active, elle empêche la lecture automatique du fichier AGENTS.md, un fichier de configuration central pour les projets multi-agents. Voici ce que vous devez savoir, et comment contourner le problème.
Qu'est-ce que la télémétrie dans Claude Code ?
La télémétrie de Claude Code collecte des métriques d'usage : commandes exécutées, durée des sessions, types de fichiers traités, erreurs rencontrées. Ces données sont utilisées par Anthropic pour améliorer l'outil. Par défaut, la télémétrie est activée dans les versions récentes de Claude Code, conformément à une pratique répandue dans les outils de développement modernes.
Ce qui distingue Claude Code des autres outils, c'est son architecture d'agents. Claude Code peut spawner des sous-agents qui travaillent en parallèle sur différentes parties d'une codebase. La coordination entre ces agents repose sur des fichiers de configuration spécifiques, dont le plus important est AGENTS.md.
Le rôle du fichier AGENTS.md
AGENTS.md est un fichier de configuration Markdown que vous placez à la racine de votre projet (ou dans des sous-répertoires). Il contient des instructions pour les agents Claude Code : conventions de code du projet, contraintes architecturales, commandes de build et de test, contexte métier important. Claude Code lit ce fichier au démarrage d'une session pour contextualiser son comportement.
Pour les projets complexes utilisant des équipes d'agents (plusieurs instances de Claude Code travaillant simultanément sur des tâches différentes), AGENTS.md devient critique. Sans lui, chaque agent repart de zéro sans connaître les règles du projet. Avec lui, tous les agents partagent le même contexte architectural et respectent les mêmes conventions.
Le conflit télémétrie / lecture AGENTS.md
Le bug documenté se manifeste de façon intermittente : avec la télémétrie activée, Claude Code ne lit pas AGENTS.md au démarrage de session dans certaines configurations. Le problème se produit spécifiquement quand le fichier contient des instructions longues (plus de 2000 tokens) ou quand il est situé dans un sous-répertoire profond du projet.
Techniquement, le mécanisme de télémétrie intercepte certaines opérations I/O pour les instrumenter. Cette interception crée un conflit de priorité avec la lecture asynchrone du fichier AGENTS.md au démarrage. Le résultat : les agents ignorent silencieusement les instructions du fichier, ce qui peut produire des comportements inattendus difficiles à diagnostiquer.
Comment détecter le problème
Plusieurs symptômes indiquent que AGENTS.md n'est pas lu. L'agent ignore les conventions de nommage définies dans le fichier, utilise des patterns de code que vous avez explicitement déconseillés, ou pose des questions sur le contexte du projet que vous avez déjà documenté dans AGENTS.md.
Pour confirmer, ajoutez une instruction clairement identifiable au début de votre AGENTS.md, par exemple : "Quand on te demande ton contexte, commence ta réponse par le mot AGENTS_LOADED." Si Claude Code ne commence pas sa réponse par ce marqueur lors d'une question de contexte, le fichier n'a pas été lu.
Les contournements disponibles
La solution la plus directe est de désactiver la télémétrie. Vous pouvez le faire via la variable d'environnement CLAUDE_TELEMETRY_DISABLED=1, ou via la commande /telemetry off dans l'interface Claude Code. Anthropic indique que la désactivation de la télémétrie ne réduit pas les fonctionnalités de l'outil.
Si vous préférez conserver la télémétrie, une alternative est de passer le contenu d'AGENTS.md directement dans votre premier prompt via la syntax @agents.md (lecture explicite). Claude Code lit alors le fichier à la demande plutôt qu'au démarrage automatique, contournant le conflit d'initialisation.
Une troisième approche, utile pour les projets d'équipe, est de diviser AGENTS.md en fichiers plus petits (sous les 1500 tokens chacun) et de les organiser par sous-répertoire. Les fichiers courts semblent moins affectés par le bug d'interception télémétrie.
La question de la confidentialité des projets
Au-delà du bug technique, la télémétrie de Claude Code soulève une question de confidentialité légitime : quelles données sur votre code sont envoyées ? Selon la documentation officielle d'Anthropic, la télémétrie n'envoie pas le contenu du code source, uniquement des métadonnées (types de fichiers, commandes utilisées, durée). Les données sont anonymisées et ne sont pas utilisées pour entraîner les modèles sans consentement explicite.
Cependant, dans un contexte professionnel avec du code propriétaire ou des projets sous NDA, la prudence s'impose. La désactivation de la télémétrie est recommandée pour les environnements de développement manipulant du code sensible ou confidentiel. Cette recommandation s'applique aussi aux déploiements Claude Code dans des CI/CD internes où le code n'a jamais vocation à quitter l'infrastructure de l'entreprise.
État du correctif côté Anthropic
Ce bug a été reporté sur le repository GitHub public de Claude Code et a reçu le statut "confirmed" de la part de l'équipe d'Anthropic. Un correctif est prévu dans une prochaine version mineure. En attendant, les contournements décrits ci-dessus sont les solutions recommandées par la communauté et validées par les développeurs d'Anthropic dans les commentaires du ticket.
Pour rester informé des évolutions, suivez le changelog de Claude Code et les releases notes du repository officiel. L'écosystème autour de Claude Code évolue rapidement, et la gestion des fichiers de configuration agents est un axe de développement prioritaire pour les prochaines versions.
