Claude Code 2.1.277 liest AGENTS.md als Rückfalloption

Claude Code liest jetzt AGENTS.md, eine Anweisungsdatei, die mehrere konkurrierende Coding-Agenten gemeinsam nutzen, wenn ein Projekt keine eigene CLAUDE.md besitzt. Die Änderung erschien am 18. September 2026 in Version 2.1.277. Eine Datei kann nun mehr als ein Werkzeug informieren. Das nimmt jedem Repository, das zwei davon nutzt, eine kleine, aber echte Pflegeaufgabe ab.

Anthropics Changelog nennt die Regel in einem Satz: "in a project with no CLAUDE.md, Claude Code reads AGENTS.md instead; change it under 'Project instructions'". Das passende GitHub-Release erschien am selben Tag um 18:06 UTC.

Was AGENTS.md ist

AGENTS.md ist eine einfache Markdown-Datei, die im Repository liegt. Sie erklärt einem Coding-Agenten, wie das Projekt funktioniert, so wie ein Beitragsleitfaden es einer neuen Kollegin erklärt.

Die AGENTS.md-Website nennt das Format "a README for agents: a dedicated, predictable place to provide the context and instructions to help AI coding agents work on your project". Sie beschreibt den Inhalt als "build steps, tests, and conventions that might clutter a README or aren't relevant to human contributors".

Das Format stammt nicht von Anthropic. Es entstand aus Arbeiten mit OpenAI Codex, Amp, Jules von Google, Cursor und Factory. Betreut wird es nun von der Agentic AI Foundation unter der Linux Foundation. Das Projekt gibt an, dass mehr als 60.000 Open-Source-Repositories auf GitHub die Datei führen.

Wie die Rückfalloption arbeitet

Die Reihenfolge der Suche ist die ganze Funktion, und sie ist kurz.

Punkt	Detail
Version	2.1.277
Veröffentlicht	18. September 2026, 18:06 UTC
Regel	AGENTS.md wird nur gelesen, wenn das Projekt keine CLAUDE.md hat
Schalter	"Project instructions" in /config
Noch nicht verfügbar auf	Bedrock, Vertex, Foundry

Für ein Repository mit vorhandener CLAUDE.md ändert sich nichts. Diese Datei gewinnt weiterhin, und das neue Verhalten führt die beiden nie zusammen. Ein Projekt bekommt das eine oder das andere.

Die Rückfalloption lässt sich auch abschalten. Anthropics Changelog verweist auf einen Schalter unter "Project instructions" im Menü /config.

Eine Grenze verdient Aufmerksamkeit, bevor jemand darauf baut. Das Changelog sagt, die Unterstützung für AGENTS.md habe Bedrock, Vertex oder Foundry noch nicht erreicht. Teams, deren Entwickler Claude Code über einen Cloud-Anbieter nutzen, sehen also anderes Verhalten als Kolleginnen, die es direkt starten. Ein späterer Fehlerbericht zeigt, dass der Rückgriff auch ausbleibt, wenn die Telemetrie abgeschaltet ist.

Der Rest des Releases

Version 2.1.277 brachte nicht nur diese Funktion. Anthropics Notizen listen mehr als 50 Fehlerbehebungen auf, verteilt auf Terminaldarstellung, Dateioperationen und MCP-Server, also die Verbindungsstücke, mit denen ein Agent fremde Werkzeuge erreicht.

Zwei Korrekturen fallen jedem auf, der sie erlebt hat. Berechtigungsabfragen für gefährliche Löschbefehle nennen jetzt den markierten Befehl und schlagen einen ${VAR:?}-Schutz vor. Eine nicht gesetzte Variable schlägt damit fehl, statt den falschen Pfad zu löschen. Server, die als HTTP eingerichtet waren und noch den älteren Transport aus HTTP und Server-Sent Events nutzten, scheitern nicht mehr an 422 und anderen 4xx-Antworten.

Ein zweites Release folgte am 19. September. Version 2.1.278 stellte den Auto-Modus für Nutzer der Claude API und von Enterprise auf einen serverseitigen Klassifikator um.

Was das für Entwickler bedeutet

Prüfen Sie zuerst, welche Datei Ihr Repository wirklich hat. Liegt eine CLAUDE.md vor, ändert dieses Release für Sie nichts, und eine AGENTS.md daneben bleibt ungelesen.

Für ein Projekt, das Beitragende auf mehreren Agenten unterstützt, ist der praktische Schritt klar. Behalten Sie eine AGENTS.md und löschen Sie die CLAUDE.md, die sie nur doppelt. Das ist jetzt ein unterstützter Aufbau und kein Notbehelf mehr. Eine CLAUDE.md gehört nur dorthin, wo Anweisungen sich je Werkzeug wirklich unterscheiden.

Achten Sie auf die Spaltung im Team. Weil die Cloud-Varianten das noch nicht haben, kann ein Beitragender auf Bedrock anderes Verhalten erleben als jemand mit dem Kommandozeilenwerkzeug, und keine Fehlermeldung erklärt den Unterschied. Wenn Ihre Agenten-Anweisungen für die Prüfung von Code zählen, schreiben Sie im Repository fest, welche Datei gilt.

Dahinter steht ein größerer Punkt darüber, wie schnell sich Verhalten unter Ihnen ändert. Claude Code begann früher, ohne Widerspruch einen Sitzungslink in Commit-Nachrichten zu schreiben, eine Voreinstellung, die Repositories erreichte, bevor viele Teams es merkten. Konfiguration in einer eingecheckten Datei, geprüft wie Code, ist der Schutz gegen beide Überraschungen.

Fixieren Sie die Version, wenn Ihr Arbeitsablauf am alten Verhalten hängt. Releases erscheinen hier täglich, und eine Voreinstellung, die zwischen zwei davon umkippt, verkraftet ein Team leichter, wenn alle denselben Build nutzen.

Fortsetzung: Claude Code liest AGENTS.md nur mit eingeschalteter Telemetrie.