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

# Claude Code lädt AGENTS.md bei deaktivierter Telemetrie möglicherweise nicht

> Die native Unterstützung von AGENTS.md in Claude Code hängt von Version, Zugriff auf Funktionsschalter, Anbieter und Dateipriorität ab. Die Telemetriezeilen des veröffentlichten agents-md-Plugins enthalten weder Pfade noch Dateitext.

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 führte native Unterstützung für Repository-Anweisungen in `AGENTS.md`. Die Funktion hat eine wichtige Einschränkung: Laut aktueller Dokumentation von Anthropic laden Sitzungen, die keine Funktionsschalter abrufen können – darunter Sitzungen mit deaktivierter Telemetrie und viele Konfigurationen mit Drittanbietern –, ausschließlich `CLAUDE.md`.

Das veröffentlichte `agents-md`-Plugin trennt das Laden von Dateien von den optionalen Telemetriezeilen. Diese Zeilen enthalten Zählwerte und feste Auswahlmöglichkeiten, aber keine Pfade oder Dateiinhalte. Die Abhängigkeit liegt eine Ebene davor: Ein entfernter Funktionsschalter entscheidet, ob der integrierte Loader verfügbar ist.

## Die große Veränderung

- **Was sich geändert hat:** Eine lokale Anweisungsdatei hängt nun von einer entfernten Freigabe ab: Der Zugriff auf Funktionsschalter entscheidet, ob der integrierte `AGENTS.md`-Leser in Claude Code verfügbar ist.
- **Warum das wichtig ist:** Zwei Entwickler am selben Commit können unterschiedliche Projektanweisungen erhalten, weil sich Version, Anbieter oder Datenschutzeinstellungen unterscheiden. Dadurch lässt sich das Verhalten eines Agenten im Team schwerer reproduzieren.
- **Worauf zu achten ist:** Teams mit mehreren Anbietern oder abgeschotteten Umgebungen können das Laden von Anweisungen als Laufzeitabhängigkeit behandeln, es in jeder Konfiguration überprüfen und `CLAUDE.md` als portablen Weg beibehalten.

## Was Veröffentlichung und Bericht belegen

Anthropics [Versionshinweise zu 2.1.277](https://github.com/anthropics/claude-code/releases/tag/v2.1.277), datiert auf den 18. September, besagen, dass Claude Code `AGENTS.md` liest, wenn ein Projekt keine `CLAUDE.md`-Datei mit Claude-Anweisungen enthält. In den Hinweisen sind Bedrock, Vertex und Foundry ebenfalls von dieser Veröffentlichung ausgenommen.

Auch die aktuelle [Dokumentation zum Projektspeicher](https://code.claude.com/docs/en/memory) schließt die erste Sitzung nach Installation oder Upgrade auf eine unterstützte Version sowie Sitzungen mit deaktiviertem integriertem Plugin aus.

Przemek Szypowskis [Bericht, der das Problem sichtbar machte](https://blog.szypowi.cz/p/claude-code-reads-agents.md-only-when-telemetry-is-on) beschreibt einen Canary-Test mit Version 2.1.280. Er berichtet, dass `DISABLE_TELEMETRY` und `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` das Laden seiner `AGENTS.md` verhinderten, während ein benachbarter `CLAUDE.md`-Import funktionierte. BIG CHANGE hat diesen Test mit dem kostenpflichtigen Modell nicht wiederholt. Anthropics Dokumentation nennt inzwischen unabhängig dieselben Verfügbarkeitsbedingungen.

## Funktionsverfügbarkeit und Telemetrieprotokollierung sind getrennt

Anthropics [Dokumentation zu Umgebungsvariablen](https://code.claude.com/docs/en/env-vars) besagt, dass jeder nicht leere Wert von `DISABLE_TELEMETRY` – darunter `0` oder `false` – die Telemetrie deaktiviert und den Abruf von Funktionsschaltern verhindert. `DO_NOT_TRACK`, `DISABLE_GROWTHBOOK` und `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` können diesen Abruf ebenfalls unterbinden. Sitzungen mit Drittanbieter-Anbietern sind ausgenommen, sofern der einbettende Host nicht `CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST` setzt; auch Sitzungen über das Apps-Gateway von Claude sind ausgenommen.

Die [README des veröffentlichten Plugins](https://github.com/anthropics/claude-code/blob/v2.1.280/mods/agents-md/README.md) besagt, dass fehlende Telemetrieaufrufe verworfen werden, ohne die übrige Arbeit des Plugins zu beeinflussen. Der [Überblick zu den integrierten Mods](https://github.com/anthropics/claude-code/blob/v2.1.280/mods/README.md) führt Telemetrie und `agents-md` als getrennte integrierte Plugins auf.

Der Quellcode beschreibt einen funktionierenden Loader; die Produktdokumentation erklärt, ob eine Sitzung diesen Loader erhält. Optionale Protokollierung innerhalb des Moduls hebt die Verfügbarkeitsbedingung außerhalb des Moduls nicht auf.

Am 23. September rief BIG CHANGE die `agents-md` README und das [Registrierungsmodul](https://github.com/anthropics/claude-code/blob/v2.1.280/mods/agents-md/hooks/register.ts) sowohl von `main` als auch vom Tag 2.1.280 ab, der am 22. September veröffentlicht wurde; beide Dateipaare waren bytegleich.

## Wann Claude Code die Datei lädt

Wenn ein Plugin verfügbar und aktiviert ist, gilt standardmäßig folgende Priorität:

| Anweisungsdateien | Standardergebnis |
| --- | --- |
| `AGENTS.md`, wenn keine Claude-Projektanweisungsdatei vorhanden ist | `AGENTS.md` lädt |
| Projekt-`CLAUDE.md`, `.claude/CLAUDE.md` oder `CLAUDE.local.md` im Arbeitsverzeichnis oder einem übergeordneten Verzeichnis | Das direkte `AGENTS.md`-Laden gibt diesen Dateien Vorrang |
| Nutzer- oder verwaltete `CLAUDE.md`, oder `.claude/rules/` | Diese verdrängen `AGENTS.md` |

Projektanweisungen in `/config` ändern, damit beide Dateitypen geladen werden. Die JSON-Option gehört in die Nutzer-, `--settings`- oder verwalteten Einstellungen; Projekt- und lokale Einstellungsdateien werden ignoriert.

## Der Rückfallweg: ein expliziter Import

Für Sitzungen ohne direkte Unterstützung empfiehlt Anthropic eine `CLAUDE.md` neben der gemeinsam genutzten Datei mit folgendem Inhalt:

`@AGENTS.md`

Der Import bindet die Datei direkt ein; ein Satz, der Claude lediglich zum Lesen auffordert, überlässt diese Entscheidung dem Modell.

Prüfe `claude --version` und die Projektanweisungen in `/config`. In Version 2.1.280 können `/memory` oder `/context` eine direkt geladene `AGENTS.md` auflisten; frühere unterstützte Versionen führten sie dort nicht auf.

## Sources

- [Claude Code lädt AGENTS.md nur bei aktivierter Telemetrie](https://blog.szypowi.cz/p/claude-code-reads-agents.md-only-when-telemetry-is-on) — Bericht über Przemek Szypowskis gemeldete Canary-Tests mit Version 2.1.280 und seinen Workaround. BIG CHANGE hat den Lauf mit dem kostenpflichtigen Modell nicht wiederholt; der Artikel unterscheidet seine Beobachtungen von der offiziellen Produktdokumentation und der eigenen Quelleninterpretation.
- [Claude Code, Version 2.1.277](https://github.com/anthropics/claude-code/releases/tag/v2.1.277) — Offizieller Versionsnachweis für die Einführung der AGENTS.md-Unterstützung und den Ausschluss von Bedrock, Vertex und Foundry bei der Einführung.
- [So merkt sich Claude dein Projekt](https://code.claude.com/docs/en/memory) — Aktuelle offizielle Dokumentation zur Mindestversion, Dateipriorität, den Modi für Projektanweisungen, Bedingungen für nicht verfügbare Sitzungen, Diagnosemöglichkeiten und dem Import als CLAUDE.md-Rückfallweg.
- [Umgebungsvariablen in Claude Code](https://code.claude.com/docs/en/env-vars) — Aktuelle offizielle Dokumentation, wonach der Verzicht auf Telemetrie auch den Abruf von Funktionsschaltern deaktiviert und damit das direkte Laden von AGENTS.md verhindert; außerdem werden weitere betroffene Sitzungstypen aufgeführt.
- [Quellcode und Verhalten des integrierten agents-md-Plugins, Claude Code 2.1.280](https://github.com/anthropics/claude-code/blob/v2.1.280/mods/agents-md/README.md) — Beschreibung des veröffentlichten Quellcodes zu Anweisungsdatei-Modi, Priorität und optionalen Telemetriezeilen. Laut Dokumentation enthalten die Zeilen Zählwerte und feste Auswahlmöglichkeiten, aber keine Pfade oder Dateiinhalte.
- [In Claude Code integrierte Mods, Version 2.1.280](https://github.com/anthropics/claude-code/blob/v2.1.280/mods/README.md) — Veröffentlichter Überblick, der Telemetrie und agents-md als getrennte integrierte Plugins aufführt und bestätigt, dass der markierte Quellcode mit Claude Code ausgeliefert wird.
- [Registrierungsmodul von agents-md, Claude Code 2.1.280](https://github.com/anthropics/claude-code/blob/v2.1.280/mods/agents-md/hooks/register.ts) — Veröffentlichter Registrierungscode, der zusammen mit der README geprüft wurde. Bei der Prüfung am 23. September waren die Bytes identisch mit der entsprechenden Datei im Hauptzweig.