Claude Code liest AGENTS.md nur mit eingeschalteter Telemetrie

Claude Code liest AGENTS.md nur, wenn die Telemetrie eingeschaltet ist. Das zeigt ein Fehlerbericht, der am 20. September 2026 gegen Anthropics Coding-Agenten eingereicht wurde. Die Funktion kam mit Version 2.1.277. Wer die Nutzungsmeldungen abgeschaltet hat oder das Werkzeug über Amazon Bedrock oder Google Vertex nutzt, bekommt gar kein AGENTS.md. Auf dem Bildschirm steht davon nichts.

Der Bericht ist Issue #95690 im öffentlichen Claude-Code-Repository. Ein am 23. September veröffentlichter Blogbeitrag beschreibt dasselbe Verhalten und einen Workaround.

Was die AGENTS.md-Unterstützung leisten sollte

AGENTS.md ist eine Anweisungsdatei in reinem Text, die mehrere Coding-Agenten gemeinsam nutzen. Sie erklärt einem Agenten, wie ein Projekt gebaut und getestet wird und wie es aufgebaut ist. Claude Code hat für diese Aufgabe eine eigene Datei namens CLAUDE.md.

Version 2.1.277 versprach eine einfache Regel. In den Worten der Versionshinweise, die das Issue zitiert: "In einem Projekt ohne CLAUDE.md liest Claude Code stattdessen AGENTS.md." Tech AI Wire hat über diese Änderung berichtet, als sie erschien: Claude Code 2.1.277 liest AGENTS.md als Ersatz.

Warum es ohne Telemetrie nicht funktioniert

Laut dem Issue steckt die Funktion nicht im normalen Ladevorgang. Sie ist ein eingebautes Plugin, das standardmäßig aus ist. Ein entfernter Schalter schaltet es ein.

Dieser Schalter ist ein Feature-Flag namens tengu_agents_md_mod, bereitgestellt von Statsig. Statsig ist ein externer Dienst, mit dem eine Firma Funktionen für Nutzer ein- oder ausschalten kann, ohne eine neue Version auszuliefern. Um das Flag zu prüfen, muss Claude Code diesen Dienst erreichen.

In mehreren gängigen Konfigurationen gelingt das nicht, darin sind sich Issue und Blogbeitrag einig.

Konfiguration	Wird AGENTS.md geladen?
Standardinstallation, Telemetrie an	Ja, sobald das Flag an ist
DISABLE_TELEMETRY=1 gesetzt	Nein
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1 gesetzt	Nein
Über Bedrock oder Vertex	Nein

In jedem "Nein"-Fall wird die Datei einfach übersprungen. Das Issue beschreibt das Ergebnis unverblümt: "Kein Fehler. Keine Warnung. Sie wird einfach nicht geladen." Der Melder stufte die Auswirkung als kritisch ein.

Die Kritik: eine lokale Datei hinter einem entfernten Schalter

Beide Quellen argumentieren gleich. Eine Markdown-Datei aus dem Projektordner zu lesen, braucht kein Netzwerk. Wird das an ein serverseitiges Flag gekoppelt, schaltet eine Datenschutzentscheidung stillschweigend eine andere Funktion ab.

Das Issue nennt es "das Lesen einer lokalen Markdown-Datei, eine Handlung, die überhaupt kein Netzwerk benötigt", das "stillschweigend von einem serverseitigen Schalter weggesperrt wird". Der Blogbeitrag formuliert es als Regel: "Eine Datenschutzeinstellung sollte niemals stillschweigend unabhängiges lokales Verhalten abschalten."

Der Workaround

Der Blogbeitrag nennt eine Lösung, die heute funktioniert. Legen Sie im Projekt eine CLAUDE.md an und lassen Sie sie die andere Datei mit einer Zeile importieren: @AGENTS.md. Claude Code liest CLAUDE.md immer, und der Import zieht AGENTS.md mit hinein. Kein Flag ist beteiligt.

Was das für Entwickler bedeutet

Prüfen Sie, ob Ihre Konfiguration in eine der "Nein"-Zeilen oben fällt. Teams, die die Telemetrie aus Unternehmensrichtlinien abschalten, und Teams, die Claude über einen Cloud-Anbieter erreichen, sind die wahrscheinlichen Fälle. Trifft eines davon zu, gehen Sie davon aus, dass AGENTS.md nicht gelesen wird, egal was die Versionshinweise sagen.

Der einzeilige Import in einer CLAUDE.md ist vorerst die sichere Voreinstellung. Er kostet eine einzige kleine Datei und verhält sich überall gleich. Falls Sie nach dem Release 2.1.277 eine CLAUDE.md gelöscht haben, legen Sie eine schlanke wieder an.

Testen Sie Anweisungen, statt ihnen zu vertrauen. Bitten Sie den Agenten, eine Regel zu wiederholen, die nur in AGENTS.md steht, etwa Ihren Testbefehl. Kann er das nicht, wurde die Datei nicht geladen. Tun Sie das einmal pro Umgebung, die Ihr Team nutzt.

Verfolgen Sie Issue #95690 für eine Korrektur. Die größere Lehre: Das Verhalten eines Werkzeugs kann von Schaltern abhängen, die Sie nicht sehen. Anweisungen in einer Datei, die das Werkzeug immer liest, sind die verlässliche Wahl.