DIE WELT BLEIBT NICHT STEHEN.RSS
BIG CHANGE.
BIG CHANGE, nur einen Fingertipp entfernt
BIG CHANGE, nur einen Fingertipp entfernt

Raum für den großen Überblick schaffen.

Fügen Sie BIG CHANGE Ihrem Home-Bildschirm oder Desktop hinzu. Es öffnet sich in einem eigenen Fenster und zeigt die neuesten Storys an, wenn Sie online sind.

iPhone und iPad
Öffnen Sie bigchange.ai in Safari. Tippen Sie auf Teilen und dann auf Zum Home-Bildschirm. Aktivieren Sie Als Web-App öffnen, falls angezeigt, und tippen Sie dann auf Hinzufügen.
Android
Öffnen Sie bigchange.ai in Chrome. Wählen Sie im Browsermenü „App installieren“ oder „Zum Startbildschirm hinzufügen“.
Desktop
Verwenden Sie in Chrome oder Edge das Installationssymbol in der Adressleiste oder das App-Menü des Browsers. Wählen Sie in Safari auf dem Mac Ablage → Zum Dock hinzufügen.

Markdown-Ausgabe

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.