Claude Code: AGENTS.md fehlt ohne Telemetrie

Vor fünf Tagen haben wir gemeldet, dass Claude Code jetzt die AGENTS.md liest, wenn im Projekt keine CLAUDE.md liegt. Das stimmt, aber mit einer Einschränkung, die nirgends angekündigt war: Wer die Telemetrie abschaltet, bekommt die Funktion nicht. Die AGENTS.md wird dann einfach nicht geladen, ohne Fehlermeldung und ohne Hinweis.

Woran es liegt

Przemysław Szypowicz hat das am 23.09.2026 in einem Blogpost aufgeschrieben, nachdem es in Issue #95690 schon gemeldet war. Der AGENTS.md-Support steckt in einem eingebauten Plugin, das standardmäßig aus ist. Eingeschaltet wird es über einen Feature-Flag, den Claude Code von Anthropics Servern abholt. Kann Claude Code den Flag nicht abrufen, bleibt das Plugin aus.

Und abrufen kann es ihn nicht, sobald eine dieser Variablen gesetzt ist:

DISABLE_TELEMETRY
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC
DISABLE_GROWTHBOOK (laut Issue)

Tückisch ist, dass jeder Wert zählt. Auch DISABLE_TELEMETRY=0 schaltet den Abruf ab. Außerdem greift die Funktion laut Issue selbst bei eingeschalteter Telemetrie in der allerersten Session nach der Installation noch nicht, weil der Flag erst geholt und danach verwendet wird.

Selbst nachgestellt

Wir haben den Test aus dem Blogpost mit Claude Code 2.1.280 wiederholt: ein leeres Verzeichnis, darin nur eine AGENTS.md mit einem Kontrollwort, und die Frage an claude -p, wie das Wort lautet.

Einstellung	Ergebnis
Telemetrie an	Kontrollwort erkannt, in beiden Durchläufen
`DISABLE_TELEMETRY=1`	Kontrollwort unbekannt, in beiden Durchläufen
`DISABLE_TELEMETRY=1` plus `CLAUDE.md` mit `@AGENTS.md`	Kontrollwort erkannt

Das Verhalten ist also reproduzierbar, und der Workaround funktioniert.

Behoben in 2.1.281

Auf Hacker News hat sich Alice T'Poteat gemeldet. Laut Commit-Historie stammt der AGENTS.md-Mod von T'Poteat. Der Flag sei als Notschalter gedacht gewesen, um die Funktion bei Problemen aus der Ferne abschalten zu können, ohne Telemetrie greife er aber nicht. Das sei ein menschlicher Fehler gewesen und mit Version 2.1.281 behoben, die am 23.09.2026 erschienen ist.

Die Memory-Doku bestätigt das inzwischen offiziell: Vor 2.1.281 hätten manche Sessions, etwa auf Amazon Bedrock oder mit abgeschalteter Telemetrie, nur CLAUDE.md-Dateien gelesen. Wer eine ältere Version nutzt, soll aktualisieren. Im Changelog zu 2.1.281 steht dazu allerdings kein Eintrag, und das Issue ist zum Zeitpunkt dieses Artikels noch offen. Wir haben 2.1.281 nicht selbst getestet. Außerdem steht der Stable-Kanal von Claude Code laut npm noch bei 2.1.273, also vor dem AGENTS.md-Support. Wer auf "stable" bleibt, hat die Funktion noch gar nicht, mit oder ohne Telemetrie.

Die Risiken

Das eigentliche Problem ist nicht der Bug, sondern dass er still ist. Die Session startet normal, das Modell antwortet, nur eben ohne eure Projektregeln.

Was ihr jetzt tun könnt

Der zuverlässigste Weg, unabhängig von Version und Telemetrie, ist eine einzeilige CLAUDE.md neben der AGENTS.md:

echo '@AGENTS.md' > CLAUDE.md

Achtung: > überschreibt eine vorhandene CLAUDE.md ohne Rückfrage. Gibt es im Projekt schon eine, tragt die Zeile @AGENTS.md dort von Hand ein.

Der @-Import hängt nicht am Feature-Flag. Das ist genau die Zusatzdatei, die der AGENTS.md-Support eigentlich überflüssig machen sollte. Sie hilft aber auf älteren Versionen, auf dem Stable-Kanal und in jeder Umgebung, in der ihr nicht sicher wisst, welche Version läuft. Doppelt im Kontext landet der Text dadurch nicht: Laut Doku liest Claude Code eine importierte AGENTS.md nie ein zweites Mal, egal wie die Einstellung "Project instructions" steht. In unserem Test auf 2.1.280 stand der Kontrollsatz auch mit der Einstellung "beide Dateien" nur einmal im Kontext. Der Import darf also nach dem Update stehen bleiben. Wer auf 2.1.281 aktualisiert, kann mit dem Kontrollwort-Test selbst prüfen, ob die AGENTS.md bei abgeschalteter Telemetrie jetzt auch ohne Import geladen wird.