Claude Code erhält Fallback-Unterstützung für AGENTS.md

Wie Projektanweisungen jetzt geladen werden

Claude Code verfügt endlich über einen praktischen Fallback für AGENTS.md: Werden keine Dateien aus der CLAUDE.md-Familie gefunden, verwendet das Tool die Standard-Anweisungsdatei des Projekts. Mit Stand vom 24. September 2026 beschreibt die Claude-Code-Dokumentation genau dieses Verhalten. Die Änderung ist klein, reduziert aber den Aufwand rund um parallele Dateien deutlich.

Zuerst prüft Claude Code CLAUDE.md, .claude/CLAUDE.md und CLAUDE.local.md im Arbeitsverzeichnis sowie entlang der übergeordneten Verzeichniskette. Erst wenn keine dieser Dateien existiert, wird AGENTS.md geladen. Die Dokumentation nennt auch die Meldung in der Oberfläche: Claude read AGENTS.md instead of CLAUDE.md.

Der entscheidende Punkt: Es handelt sich um einen Ausweichpfad und nicht um das automatische Zusammenführen aller Anweisungen. Wird auch nur eine Datei aus der CLAUDE.md-Familie gefunden, überspringt Claude Code AGENTS.md standardmäßig. Das gemeinsame Laden lässt sich in der Einstellung Project instructions mit dem Wert claude-md-and-agents-md aktivieren.

Ich würde nicht nur prüfen, ob eine Datei geladen wurde, sondern auch, welche Anweisungen im tatsächlichen Projektbaum Vorrang haben. Eine alte CLAUDE.local.md, die weiter oben in der Hierarchie vergessen wurde, kann den erwarteten Fallback unbemerkt deaktivieren. Der Nutzen hängt hier von einer transparenten Suche ab: Eine zusätzliche Datei kann die Kontextquelle für die gesamte Sitzung ändern.

Was sich für Repositories ändert

Der wichtigste Vorteil ist einfach: Projekte mit AGENTS.md brauchen kein separates CLAUDE.md mehr, nur um mit Claude Code kompatibel zu sein. Weniger Duplizierung senkt das Risiko, dass zwei Anweisungssätze auseinanderlaufen und dem Agenten widersprüchliche Regeln geben.

Für Teams mit einer bestehenden CLAUDE.md ändert sich fast nichts. Bei einer schrittweisen Umstellung auf eine gemeinsame AGENTS.md muss jedoch die strikte Fallback-Bedingung beachtet werden: Solange eine alte Datei in der Verzeichniskette bleibt, wird die neue Quelle nicht aktiviert. Das ist einer dieser Fälle, in denen eine vergessene Konfiguration wichtiger ist als eine elegante Ankündigung.

Die Änderung wirkt klein, hat aber echten technischen Nutzen: Claude Code lässt sich leichter in Repositories integrieren, die eine gemeinsame Anweisungsdatei für Agenten verwenden. Die offene Frage betrifft nicht mehr das Format, sondern vorhersehbares Verhalten bei Konflikten zwischen lokalen und übergeordneten Einstellungen.

Wir haben zuvor erläutert, wie parallele Claude-Code-Agenten Pull Requests prüfen und Race Conditions in CI/CD-Workflows sichtbar machen können. Dieser Ablauf benötigt ebenfalls klare Anweisungen auf Repository-Ebene, die AGENTS.md nun vereinfacht.