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, 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 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 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 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 besagt, dass fehlende Telemetrieaufrufe verworfen werden, ohne die übrige Arbeit des Plugins zu beeinflussen. Der Überblick zu den integrierten Mods 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 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.