Claude Code 2.1.277 führt AGENTS.md‑Fallback mit Feature‑Flag‑Beschränkungen ein

Das Update vom 18. September 2026 für Claude Code (Version 2.1.277) führt native Unterstützung für die Konvention AGENTS.md ein, eine Markdown‑Datei, die kontextbezogene Entwicklungsinformationen, Testbefehle und Mitwirkungsregeln repository‑weit aggregiert und damit einen einheitlichen Einstiegspunkt für alle projektbezogenen Metadaten bietet.

Fehlt in einem Projekt die Datei CLAUDE.md, greift Claude Code automatisch auf AGENTS.md zurück, sodass Teams eine einzige Quelle für Anweisungs‑Metadaten nutzen können, ohne für jedes Tool separate Dateien zu pflegen, und das ohne dass zusätzliche Konfigurationsschritte nötig sind.

Konfiguration und Steuerung

Operatoren können im Menü /config zwischen CLAUDE.md und AGENTS.md umschalten. Die Auswahl wird lokal gespeichert, die eigentliche Implementierung erfolgt über ein integriertes Plugin, das per entferntem Feature‑Flag aktiviert wird, wie Korben in seinem Bericht betont.

Die Architektur mit Feature‑Flag bedeutet, dass das Deaktivieren von nicht‑kritischem Traffic oder Telemetrie das Laden des Flags verhindern kann. In diesem Fall fällt Claude Code stillschweigend zum vorherigen Verhalten zurück und ignoriert AGENTS.md ohne sichtbare Fehlermeldung, was insbesondere in stark regulierten Umgebungen relevant ist.

Ein dokumentierter Work‑around besteht darin, eine minimale CLAUDE.md‑Datei zu behalten, die AGENTS.md mittels der Syntax @AGENTS.md importiert. So funktioniert der Fallback auch, wenn das Flag nicht abgerufen werden kann, und das Team behält die volle Kontrolle über die Quelle der Anweisungen.

Kompatibilitätslandschaft

Der erste Rollout schließt die Integration mit Amazon Bedrock, Google Vertex AI und Microsoft Foundry nicht ein. Nutzer dieser Plattformen müssen weiterhin CLAUDE.md oder externe Werkzeuge verwenden, bis ein zukünftiges Update die Abdeckung erweitert und die Feature‑Flag‑Logik dort implementiert wird.

Mehrere andere Entwicklungsassistenten verstehen bereits die AGENTS.md‑Konvention, darunter Codex, Gemini CLI, Devin, Cursor und GitHub Copilot. Ihre vorhandene Unterstützung reduziert die doppelte Pflege von Anweisungen im gesamten Ökosystem und erleichtert den Wechsel zwischen den Tools.

Praktische Checkliste für Teams

• Überprüfen, dass /config AGENTS.md als Anweisungsquelle anzeigt
• Sicherstellen, dass eine CLAUDE.md‑Datei nur @AGENTS.md importiert, falls das Feature‑Flag blockiert sein könnte
• Testen, dass Claude Code in der UI den Hinweis „Lade Projektanweisungen aus AGENTS.md“ anzeigt
• Sicherstellen, dass Telemetrie‑ oder Datenschutzeinstellungen das Abrufen des Remote‑Flags nicht verhindern

Teams sollten zudem beachten, dass allein die Versionsnummer keinen Nachweis für die Unterstützung liefert. Die UI muss explizit anzeigen, dass Projektanweisungen aus AGENTS.md geladen wurden; andernfalls könnte der Fallback stillschweigend fehlgeschlagen sein und zu Inkonsistenzen führen.

Da der Fallback von einem Remote‑Flag abhängt, müssen Organisationen mit strengen Netzwerk‑Richtlinien möglicherweise den Flag‑Endpunkt auf die Whitelist setzen oder Datenschutzeinstellungen anpassen, um ein konsistentes Verhalten zu garantieren und unerwartete Fallback‑Ausfälle zu vermeiden.

In der Praxis vereinfacht die Einführung des AGENTS.md‑Fallbacks das Onboarding neuer Mitwirkender, weil alle relevanten Projekt‑Hinweise in einer einzigen Datei zentralisiert sind und automatisch von Claude Code erkannt werden, sobald CLAUDE.md fehlt.

Der Ansatz bringt Claude Code in Einklang mit anderen KI‑Assistenten, die bereits AGENTS.md unterstützen, und reduziert den Wartungsaufwand für mehrere Anweisungsdateien erheblich, was insbesondere in großen, verteilten Teams von Vorteil ist.

Für deutschsprachige Unternehmen bedeutet das einen reibungsloseren, transparenteren Arbeitsablauf: Entwickler können alle relevanten Projekt‑Hinweise in einer einzigen AGENTS.md‑Datei hinterlegen, Claude Code nutzt sie automatisch, und Teams können das Verhalten über die UI und die oben genannte Checkliste verifizieren.

Die Einführung erfolgt jedoch nicht ohne Einschränkungen: Der Fallback ist derzeit nicht für große Cloud‑Back‑Ends verfügbar, und das Feature‑Flag kann in Umgebungen mit restriktiver Datenpolitik blockiert werden, was die Notwendigkeit eines robusten Monitoring‑Mechanismus erhöht.

Entwickler, die bereits CI/CD‑Pipelines mit CLAUDE.md integriert haben, sollten prüfen, ob die Migration zu AGENTS.md zusätzliche Schritte erfordert, etwa das Anpassen von Build‑Skripten, um die @AGENTS.md‑Importsyntax korrekt zu verarbeiten.

Abschließend lässt sich festhalten, dass Claude Code Version 2.1.277 einen wichtigen Schritt in Richtung standardisierter Metadaten‑Verwaltung macht, jedoch weiterhin auf ein funktionierendes Remote‑Feature‑Flag angewiesen ist, das in sicherheitskritischen Netzwerken explizit freigegeben werden muss.