Claude Code fällt jetzt auf AGENTS.md zurück und vereinfacht Multi-Agent-Repos

Claude Code liest künftig die AGENTS.md-Datei eines Repositorys, wenn keine Claude-spezifische Anweisungsdatei existiert. Damit schließt sich eine Lücke für Teams, die mehrere KI-Coding-Agenten gegen dieselbe Codebasis einsetzen. Die Änderung wurde mit Claude Code 2.1.277 ausgeliefert und am 18. September 2026 vom Claude-Code-Team angekündigt: Enthält ein Ordner keine CLAUDE.md, prüft Claude stattdessen, ob eine AGENTS.md vorhanden ist, und verwendet diese.

Ein Fallback, keine Übernahme

Das Verhalten greift nur, wenn keine Claude-spezifische Datei vorhanden ist. Findet Claude Code eine CLAUDE.md, eine .claude/CLAUDE.md oder eine CLAUDE.local.md irgendwo entlang des Pfads zum Arbeitsverzeichnis, hat diese Datei Vorrang und AGENTS.md wird ignoriert. Existiert keine davon, kann AGENTS.md die Codierregeln, Build-Schritte und Testanforderungen des Projekts liefern. Die Funktion wird als eingebautes Plugin ausgeliefert, und Teams können das Verhalten – nur CLAUDE.md, AGENTS.md als Fallback, beide zusammen laden oder eine eingeschränkte Quellenliste – über /config, Benutzereinstellungen oder verwaltete Einstellungen anpassen.

Warum Repositories doppelte Dateien anhäufen

Teams mit mehreren Werkzeugen haben oft mehr als eine Anweisungsdatei im selben Repo: CLAUDE.md für Claude Code, AGENTS.md für Codex, Cursor und andere. Sie beginnen als Kopien voneinander und driften auseinander, bis eine davon einen Agenten auf einen Build-Befehl verweist, der nicht mehr funktioniert. Eine gemeinsame AGENTS.md beseitigt diese Duplizierung für Repos, die keine Claude-spezifischen Anweisungen benötigen.

Was zu prüfen ist, bevor man sich darauf verlässt

• CLAUDE.md hat standardmäßig weiterhin Vorrang – Teams, die beide Dateien berücksichtigen wollen, müssen die Einstellung für die Anweisungsquelle explizit ändern.
• Die Unterstützung weist derzeit Lücken bei Bedrock-, Vertex- und Foundry-Bereitstellungen auf, sodass dasselbe Repo Anweisungen unterschiedlich auflösen kann, je nachdem, gegen welchen Anbieter ein Teammitglied arbeitet.
• Ein verfolgtes GitHub-Issue (#96005) meldet doppelte Anweisungen, wenn dieselbe Anleitung zusätzlich über einen zweiten Kanal eintrifft, etwa ein Agenten-Harness – das sollte geprüft werden, bevor man annimmt, AGENTS.md allein sei maßgeblich.

Für MSPs, die eine einzige Anweisungsdatei über Kunden-Repos mit gemischter Agenten-Toolchain standardisieren, beseitigt dies eine echte Driftquelle – es ist jedoch ratsam zu prüfen, welchen Claude-Code-Anbieter und welche Version jedes Team nutzt, bevor AGENTS.md als alleinige Quelle der Wahrheit behandelt wird.

Quellen: DevOps.com, dev.to.