Anthropics Entwicklertool Claude Code unterstützt ab Version 2.1.277 AGENTS.md. Die Regel ist simpel: Enthält ein Ordner kein CLAUDE.md, sucht Claude Code im selben Ordner nach einer AGENTS.md-Datei und lädt deren Inhalt als Projektanweisung in den Kontext. Liegt dagegen ein CLAUDE.md vor, liest das Tool wie bisher ausschließlich diese Datei.
Die Version wurde am 18. September auf GitHub veröffentlicht. Thariq, Mitglied des Claude-Code-Teams, kündigte die Änderung auf einer Social-Media-Plattform an:
"Starting today in version 2.1.277, if there is no CLAUDE.md in a folder, Claude will check for and use AGENTS.md."
(Ab heute, mit Version 2.1.277, sucht Claude nach AGENTS.md und nutzt die Datei, wenn ein Ordner kein CLAUDE.md enthält.)
Vier Schaltstufen
Die AGENTS.md-Unterstützung ist als eingebautes Plugin umgesetzt, dessen Code im GitHub-Repository von Claude Code offenliegt. Nutzer schalten sie unter "Project instructions" in /config um, insgesamt gibt es vier Stufen:
| Modus | Verhalten |
|---|---|
| claude-md | Liest nur CLAUDE.md, entspricht dem Abschalten der Funktion |
| claude-md-or-agents-md (Standard) | Liegt im selben Ordner ein CLAUDE.md vor, wird dort AGENTS.md ignoriert; sonst wird sie gelesen |
| claude-md-and-agents-md | Liest beide Dateitypen im gesamten Verzeichnisbaum |
| managed-only | Ignoriert ins Repository committete und private Anweisungsdateien, behält nur von der Organisation zentral verteilte Dateien und Speicherinhalte |
Die Standardstufe ist ein Fallback, kein Zusammenführen der Inhalte. Repositories, die bereits ein CLAUDE.md für Claude Code besitzen, ändern nach dem Update ihr Verhalten nicht; nur Repositories, die nie ein CLAUDE.md hatten und bislang nur für andere Tools eine AGENTS.md vorbereitet hatten, laden diese Datei nun zum ersten Mal. Wird dieselbe Datei anhand von Pfad oder Inhalt als Duplikat erkannt, wird sie nicht zweimal geladen.
Noch ein paar Unterschiede zu CLAUDE.md
Die Plugin-Dokumentation listet mehrere Abweichungen von CLAUDE.md auf. Eine AGENTS.md in einem Unterordner wird nur eingebunden, wenn der Agent mit Read eine Textdatei in diesem Ordner liest; IDE-Textauswahl, Notebooks, Bilder und PDFs lösen das nicht aus. So eingebundene Dateien werden nicht als gelesen vermerkt und stellen sich nach einer Kontextkomprimierung nicht automatisch wieder her. Der Befehl /memory und die Kurzspeicherfunktion mit # erreichen AGENTS.md ebenfalls nicht, über --add-dir hinzugefügte Ordner liefern keine AGENTS.md, und symbolische Links werden anhand ihres Pfadtextes verglichen, nicht aufgelöst.
Bei den Kanälen werden AWS Bedrock, Google Vertex und Microsoft Foundry vorerst nicht unterstützt. Dieselbe Version bringt zudem eine weitere Änderung im Umgang mit Anweisungsdateien: Beim Start im SDK- und im Headless-Modus wartet die erste Gesprächsrunde nicht mehr, bis die Suche nach CLAUDE.md abgeschlossen ist.
Ein Repository, mehrere Agenten
AGENTS.md entspricht einer README-Datei für programmierende KI-Agenten: wie gebaut wird, wie Tests laufen, welche Code-Stil-Konventionen gelten, welche Ordner tabu sind. Das Format wurde 2025 zunächst von OpenAI Codex und einigen anderen Tools gemeinsam vorangetrieben und später an die Agentic AI Foundation unter dem Dach der Linux Foundation übergeben; Cursor, GitHub Copilot und weitere Tools erkennen es. Claude Code hat bislang ausschließlich sein eigenes CLAUDE.md gelesen, sodass Teams mit gemischtem Tool-Einsatz zwei inhaltlich fast identische Dateien parallel pflegen mussten – in der Community war ein symbolischer Link, der beide auf dieselbe Datei verweisen lässt, eine gängige Lösung.
Teams in China setzen oft auf eine noch vielfältigere Tool-Kombination: Neben Claude Code sind dort häufig Kimi Code, Qwen Code, Cursor und Codex im Einsatz, von denen nicht wenige standardmäßig AGENTS.md lesen oder das Umbenennen der Anweisungsdatei erlauben. Im Standardmodus muss an alten Repositories nichts geändert werden; Teams, die nur noch eine AGENTS.md pflegen wollen, können ihr CLAUDE.md löschen und die Inhalte dorthin verlagern – sollten aber vorher die oben genannten Einschränkungen durchgehen, vor allem dass Anweisungen aus Unterordnern nach einer Kontextkomprimierung in langen Sitzungen nicht automatisch zurückkehren.
Die Stufe managed-only richtet sich an Unternehmensadministratoren. Ins Repository committete Anweisungsdateien werden vom Agenten als Anweisung ausgeführt und sind damit selbst ein Einfallstor, das vergiftet werden kann; Administratoren können mit dieser Stufe nur zentral von der Organisation verteilte Regeln zulassen. Wie sich diese Stufe in großen Teams in der Praxis bewährt, dazu gibt es bislang keine öffentlichen Nutzungsdaten.
Quellen: GitHub-Versionshinweise von Claude Code, CocoLoop, öffentlicher Beitrag des Anthropic-Ingenieurs Thariq; die vier Modi, die Ladereihenfolge und die Einschränkungen wurden anhand der agents-md-Plugin-Dokumentation geprüft.