Claude Code liest jetzt AGENTS.md

Claude Code liest seit Version 2.1.277 vom 18.09.2026 eine AGENTS.md, wenn im Projekt keine CLAUDE.md liegt. Auf Hacker News stand die Ankündigung mit 647 Punkten oben, mit Kommentaren wie "Only took them a year and a half of everyone complaining to finally do the right thing."

Was sich ändert

Findet Claude Code beim Start weder eine CLAUDE.md noch eine CLAUDE.local.md im Arbeitsverzeichnis oder einem Ordner darüber, lädt es stattdessen jede AGENTS.md auf diesem Pfad, genau wie sonst CLAUDE.md. Das gilt auch pro Unterordner: Öffnet Claude eine Datei in einem Unterverzeichnis, zieht es dessen AGENTS.md nach, sofern dort keine eigene CLAUDE.md liegt. In der AGENTS.md funktionieren @-Importe genauso wie in der CLAUDE.md.

Liegt irgendwo auf dem Pfad eine CLAUDE.md, gewinnt sie komplett: Die AGENTS.md bleibt dann ungelesen, statt ergänzend dazuzukommen. Unter "Project instructions" in /config lässt sich das umstellen, mit vier Werten: nur CLAUDE.md, CLAUDE.md oder AGENTS.md (Standard), beide zusammen, oder nur die von der Organisation verwaltete Datei. Auf Bedrock, Vertex und Foundry fehlt die Funktion laut Changelog noch.

Technisch steckt das Feature laut Thariq Shihipar von Anthropic in einem eingebauten "Mod". Der Quelltext liegt offen im claude-code-Repository unter mods/agents-md. Laut Shihipar ist das der erste eingebaute Baustein eines kommenden Systems, mit dem sich der Claude-Code-Harness künftig auch von außen anpassen lassen soll.

Praktisch für gemischte Teams

Wer Claude Code neben Codex, Cursor oder Copilot einsetzt, kam bisher um zwei Regeldateien kaum herum. Der übliche Behelf: ein Symlink CLAUDE.md auf AGENTS.md, oder eine CLAUDE.md mit @AGENTS.md-Import und claude-spezifischen Zusätzen darunter. In der aktuellen Doku ist beides weiterhin beschrieben, für neue Projekte ohne eigene CLAUDE.md wird es jetzt aber unnötig, weil der Standardfall automatisch greift.

Wer schon eine CLAUDE.md hat, merkt dagegen nichts von der Neuerung: Wird sie parallel gepflegt, bleibt die AGENTS.md komplett außen vor. Dafür lohnt sich eine bewusste Entscheidung: entweder auf die CLAUDE.md verzichten und die AGENTS.md allein pflegen, oder sie per @AGENTS.md-Import einbinden und nur das Claude-spezifische in der CLAUDE.md selbst unterbringen, oder die Project-Instructions auf "beide zusammen" stellen. Noch am 14.09.2026 hatten wir zu OpenAIs Astra-Empfehlungen geschrieben, dass Claude Code nur die CLAUDE.md liest. Das ist mit diesem Update überholt. Wie eine schlanke Regeldatei als Wegweiser statt als Handbuch aussieht, unabhängig vom Dateinamen, steht in Harness Engineering.

Nebenbei: Auto Mode ohne Klassifikator-Aufpreis

Im selben Changelog, einen Tag später mit Version 2.1.278, hat Anthropic für API- und Enterprise-Nutzer den Auto Mode standardmäßig auf einen serverseitigen Klassifikator umgestellt, der keine zusätzlichen Kosten für den Klassifikator-Overhead mehr verursacht.