AI-translated from English; not yet reviewed by a fluent editor.

# Claude Code peut ignorer AGENTS.md lorsque la télémétrie est désactivée

> La prise en charge native d’AGENTS.md par Claude Code dépend de la version, de l’accès aux indicateurs de fonctionnalités, du fournisseur et de la priorité des fichiers. Les lignes de télémétrie du plug-in agents-md publié n’incluent ni chemins ni contenu de fichiers.

By BIG CHANGE Editorial

Published: 2026-09-23T13:54:58.721Z
Updated: 2026-09-23T13:54:58.721Z
Canonical: https://bigchange.ai/blog/claude-code-agents-md-telemetry-feature-flags

![A desktop monitor shows a minimal project-instructions view with plain AGENTS.md and CLAUDE.md labels above a keyboard and mouse.](https://bigchange.ai/api/media/file/claude-code-project-instructions-hero-v2.png)
AI-generated conceptual illustration by BIG CHANGE.

Claude Code 2.1.277 a ajouté la prise en charge native des consignes de dépôt dans `AGENTS.md`. La fonctionnalité comporte une limite importante : la documentation actuelle d’Anthropic indique que les sessions qui ne peuvent pas récupérer les indicateurs de fonctionnalités, notamment celles où la télémétrie est désactivée et les nombreuses configurations utilisant des fournisseurs tiers, chargent `CLAUDE.md` uniquement.

Le plug-in publié `agents-md` sépare le chargement des fichiers de ses lignes de télémétrie facultatives. Celles-ci contiennent des nombres et des choix fixes, sans chemins ni contenu de fichiers. La dépendance intervient un niveau plus tôt : un indicateur distant détermine si le chargeur intégré est disponible.

## Le grand changement

- **Ce qui a changé :** Un fichier local de consignes dépend désormais d’un déploiement distant : l’accès aux indicateurs de fonctionnalités détermine si le lecteur intégré qui charge `AGENTS.md` est disponible.
- **Pourquoi c’est important :** Deux développeurs travaillant sur le même commit peuvent recevoir des consignes de projet différentes selon leur version, leur fournisseur ou leurs paramètres de confidentialité, ce qui complique la reproductibilité du comportement des agents au sein d’une équipe.
- **À surveiller :** Les équipes qui utilisent plusieurs fournisseurs ou des environnements verrouillés peuvent traiter le chargement des consignes comme une dépendance d’exécution, le vérifier dans chaque configuration et conserver un import `CLAUDE.md` comme solution portable.

## Ce que la version publiée et le signalement établissent

Les [notes de version 2.1.277](https://github.com/anthropics/claude-code/releases/tag/v2.1.277), datées du 18 septembre, indiquent que Claude Code lit `AGENTS.md` lorsqu’un projet ne contient pas de `CLAUDE.md`. Ces notes excluent également Bedrock, Vertex et Foundry de cette version.

La [documentation actuelle sur la mémoire de projet](https://code.claude.com/docs/en/memory) exclut aussi la première session après l’installation ou la mise à niveau vers une version compatible, ainsi que les sessions où le plug-in intégré est désactivé.

Le [signalement initial de Przemek Szypowski](https://blog.szypowi.cz/p/claude-code-reads-agents.md-only-when-telemetry-is-on) décrit un test canari réalisé avec la version 2.1.280. Il rapporte que `DISABLE_TELEMETRY` et `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` ont empêché son fichier `AGENTS.md` de se charger, tandis qu’un import adjacent de `CLAUDE.md` a fonctionné. BIG CHANGE n’a pas reproduit ce test payant sur un modèle. La documentation d’Anthropic énonce désormais de façon indépendante les mêmes conditions de disponibilité.

## Disponibilité de la fonctionnalité et journalisation de la télémétrie sont deux choses distinctes

La documentation d’Anthropic sur les [variables d’environnement](https://code.claude.com/docs/en/env-vars) indique que toute valeur non vide de `DISABLE_TELEMETRY`, y compris `0` ou `false`, désactive la télémétrie et la récupération des indicateurs de fonctionnalités. `DO_NOT_TRACK`, `DISABLE_GROWTHBOOK` et `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` peuvent également empêcher cette récupération. Les sessions utilisant un fournisseur tiers sont exclues, sauf si l’hôte d’intégration définit `CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST` ; les sessions passant par la passerelle des applications Claude le sont aussi.

Le [README du plug-in publié](https://github.com/anthropics/claude-code/blob/v2.1.280/mods/agents-md/README.md) indique que les appels de télémétrie manquants sont abandonnés sans modifier les autres tâches du plug-in. La vue d’ensemble des [modules du dépôt](https://github.com/anthropics/claude-code/blob/v2.1.280/mods/README.md) identifie la télémétrie et `agents-md` comme deux modules intégrés distincts.

Le code source décrit le fonctionnement du chargeur ; la documentation du produit décrit les sessions qui y ont accès. La journalisation facultative à l’intérieur du module ne supprime pas la condition de disponibilité qui s’applique en amont.

Le 23 septembre, BIG CHANGE a récupéré le README du plug-in `agents-md` et le [module d’enregistrement](https://github.com/anthropics/claude-code/blob/v2.1.280/mods/agents-md/hooks/register.ts) depuis `main` et depuis la balise 2.1.280, publiée le 22 septembre ; chaque paire de fichiers était identique octet pour octet.

## Quand Claude Code charge le fichier

Lorsque le plug-in est disponible et activé, le mode par défaut suit l’ordre de priorité suivant :

| Fichiers de consignes | Résultat par défaut |
| --- | --- |
| `AGENTS.md`, sans fichier de consignes Claude au niveau du projet | `AGENTS.md` charge |
| Projet `CLAUDE.md`, `.claude/CLAUDE.md` ou `CLAUDE.local.md` dans le répertoire de travail ou un répertoire parent | Chargement direct `AGENTS.md` cède la priorité à ces fichiers |
| Au niveau utilisateur ou administrateur : `CLAUDE.md`, ou `.claude/rules/` | Ces fichiers ne remplacent pas `AGENTS.md` |

Modifiez les instructions du projet dans `/config` pour charger les deux types de fichiers. L’option JSON doit figurer dans les paramètres utilisateur, `--settings` ou administrateur ; les fichiers de paramètres du projet et locaux sont ignorés.

## Un seul import explicite comme solution de repli

Pour les sessions sans prise en charge directe, Anthropic recommande de placer un fichier `CLAUDE.md` à côté du fichier partagé et d’y insérer :

`@AGENTS.md`

Cet import inclut le fichier ; demander en prose à Claude de le lire laisse ce choix au modèle.

Vérifiez `claude --version` et les instructions du projet dans `/config`. Dans la version 2.1.280, `/memory` ou `/context` peuvent indiquer qu’un fichier `AGENTS.md` est chargé directement ; les versions compatibles antérieures ne l’affichaient pas à cet endroit.

## Sources

- [Claude Code ne lit AGENTS.md que si la télémétrie est activée](https://blog.szypowi.cz/p/claude-code-reads-agents.md-only-when-telemetry-is-on) — Le récit par Przemek Szypowski de ses tests canari sur Claude Code 2.1.280 et de la solution de contournement. BIG CHANGE n’a pas reproduit le test payant sur un modèle ; l’article distingue ses observations de la documentation officielle du produit et de l’interprétation des sources.
- [Claude Code, notes de version v2.1.277](https://github.com/anthropics/claude-code/releases/tag/v2.1.277) — Annonce officielle de la prise en charge d’AGENTS.md et des restrictions Bedrock, Vertex et Foundry lors de son lancement.
- [Comment Claude mémorise votre projet](https://code.claude.com/docs/en/memory) — Documentation officielle actuelle sur la version minimale, la priorité des fichiers, les modes Instructions du projet, les conditions d’indisponibilité des sessions, les diagnostics et l’import de repli via CLAUDE.md.
- [Variables d’environnement de Claude Code](https://code.claude.com/docs/en/env-vars) — Documentation officielle actuelle précisant que le refus de la télémétrie désactive aussi la récupération des indicateurs de fonctionnalités, ce qui rend impossible le chargement direct d’AGENTS.md, et répertoriant d’autres sessions concernées.
- [Code source et fonctionnement du module intégré agents-md, Claude Code v2.1.280](https://github.com/anthropics/claude-code/blob/v2.1.280/mods/agents-md/README.md) — Description publiée du code source concernant les modes des fichiers de consignes, leur priorité et les lignes de télémétrie facultatives. Elle précise que ces lignes contiennent des nombres et des choix fixes, et non des chemins ou le contenu des fichiers.
- [Modules intégrés de Claude Code, v2.1.280](https://github.com/anthropics/claude-code/blob/v2.1.280/mods/README.md) — Vue d’ensemble publiée établissant que la télémétrie et agents-md sont deux modules intégrés distincts et que le code balisé est livré avec Claude Code.
- [Module d’enregistrement agents-md, Claude Code v2.1.280](https://github.com/anthropics/claude-code/blob/v2.1.280/mods/agents-md/hooks/register.ts) — Code d’enregistrement publié, examiné en parallèle du README. Lors de la vérification du 23 septembre, ses octets correspondaient à ceux du fichier équivalent sur la branche main.