AntwortenVeröffentlicht18 Quellen
Claude Code 2.1.277: AGENTS.md wird zur Fallback-Datei für Projektanweisungen
Seit Version 2.1.277 vom 18. September 2026 kann Claude Code AGENTS.md als Projektanweisung lesen, wenn keine CLAUDE.md vorhanden ist.
Veröffentlicht vonBearbeitet mit GPT-5.6 TerraBilder erstellt mit GPT Image 2
Forschungsantwort
Wichtige Erkenntnisse
- Seit Version 2.1.277 vom 18. September 2026 kann Claude Code AGENTS.md als Projektanweisung lesen, wenn keine CLAUDE.md vorhanden ist.
- Die Einstellung liegt unter „Project instructions“ in /config; auf Amazon Bedrock, Google Vertex AI und Azure AI Foundry wird sie noch nicht unterstützt.
- AGENTS.md enthält gemeinsame Repository Regeln, während SKILL.md wiederverwendbare, bei Bedarf nutzbare Fähigkeiten paketiert.
KI-Prompt
openai.comCreate a landscape editorial hero image for this Studio Global article: What changed in Claude Code version 2.1.277, released on September 18, 2026, regarding support for the open AGENTS.md project-instructions f. Article summary: Claude Code 2.1.277 adds native, opt-in-configurable fallback support for `AGENTS.md`: a repository without `CLAUDE.md` can now supply Claude Code’s project instructions through the shared open format instead. It is a fa. Topic tags: general, general web, user generated. Style: premium digital editorial illustration, source-backed research mood, clean composition, high detail, modern web publication hero. Use reference image context only for broad subject, composition, and topical grounding; do not copy the exact image. Avoid: logos, brand marks, copyrighted characters, real person likenesses, fake screenshots, UI text, readable text, watermarks, charts with fa
Claude Code kann seit Version 2.1.277 mit einer verbreiteten offenen Konvention für KI-gestützte Softwareentwicklung umgehen: AGENTS.md. Für Teams, die mehrere Coding-Agenten einsetzen, bedeutet das weniger doppelte Pflege von Projektregeln.
Die Standardlogik ist dabei klar: Gibt es im Projekt keine CLAUDE.md, verwendet Claude Code AGENTS.md als Projektanweisung. Ist eine CLAUDE.md vorhanden, bleibt sie die etablierte Datei für Claude-Code-spezifische Anweisungen. Die Release-Notiz beschreibt für das Standardverhalten keine automatische Zusammenführung beider Dateien. 1
So funktioniert der Fallback
- Keine
CLAUDE.mdim Projekt: Claude Code kannAGENTS.mdfür die Projektanweisungen einlesen.1
CLAUDE.mdvorhanden: Diese Datei bleibt maßgeblich; wer Regeln aus beiden Dateien benötigt, sollte ihre Beziehung ausdrücklich festlegen, statt sich auf ein automatisches Zusammenführen zu verlassen.
Aktivieren oder anpassen lässt sich das Verhalten in Claude Code über /config unter „Project instructions“. Noch nicht verfügbar ist die Funktion in Claude-Code-Deployments auf Amazon Bedrock, Google Vertex AI und Azure AI Foundry. 1
Was ist AGENTS.md?
AGENTS.md ist eine offene Markdown-Konvention für Hinweise, die speziell an Coding-Agenten in einem Repository gerichtet sind – vereinfacht gesagt: ein „README für Agenten“. Darin können etwa Projektkontext, Einrichtungsschritte, Build- und Testbefehle, Code-Konventionen sowie Erwartungen an Beiträge stehen. 19
32
Das Format entstand aus einer Zusammenarbeit im Umfeld von OpenAI Codex, Amp, Google Jules, Cursor und Factory. Heute wird es von der Agentic AI Foundation unter dem Dach der Linux Foundation betreut. Nach Angaben des Projekts nutzen es mehr als 60.000 Open-Source-Repositories. 19
21
Zum wachsenden Ökosystem zählen unter anderem OpenAI Codex, Google Jules, Cursor, der Coding-Agent von GitHub Copilot, Gemini CLI, Aider, Zed, Warp, VS Code, Devin, JetBrains Junie, Factory, Goose und OpenCode. Wie Dateien gefunden und verarbeitet werden, unterscheidet sich aber weiterhin je nach Tool. Allein das Vorhandensein einer AGENTS.md garantiert daher nicht überall exakt dieselbe Wirkung. 19
Weniger Pflegeaufwand für Teams mit mehreren Agenten
Vor der nativen Unterstützung mussten Teams mit einer zentralen AGENTS.md für Claude Code häufig zusätzlich eine CLAUDE.md pflegen. Gängige Übergangslösungen waren ein symbolischer Link oder eine schlanke CLAUDE.md, die mit einem Import auf AGENTS.md verweist. Solche Workarounds waren nötig, weil Claude Code AGENTS.md zuvor nicht direkt einlas. 10
Der neue Fallback spart diese Zusatzarbeit in Repositories, die keine Claude-spezifischen Projektanweisungen benötigen. Eine gemeinsame Datei kann damit die Grundregeln für Claude Code und andere kompatible Werkzeuge bereitstellen.
Vollständig vereinheitlicht sind die Konventionen damit allerdings nicht. Gerade bei Unterverzeichnissen, widersprüchlichen Regeln und mehreren Anweisungsdateien sollten Teams weiterhin prüfen, nach welchen Regeln der jeweils eingesetzte Agent Dateien entdeckt und priorisiert.
AGENTS.md und SKILL.md erfüllen unterschiedliche Aufgaben
Die neue Unterstützung ergänzt Anthropic’ Arbeit an Agent Skills, ersetzt sie aber nicht:
AGENTS.mdenthält dauerhafte, repositoryweite Leitlinien: den Kontext und die Regeln für die Arbeit an einer konkreten Codebasis.19
32
SKILL.mdgehört zu einem Agent Skill: einem wiederverwendbaren Paket aus Anweisungen, Metadaten und optionalen Hilfsdateien. Claude kann solche Skills nutzen, wenn sie für eine Aufgabe relevant sind, etwa für spezialisierte Abläufe oder Fachwissen.33
Claude Code beschreibt seine Skills als Umsetzung des werkzeugübergreifenden Agent-Skills-Standards. In der Claude-Code-Dokumentation liegt ein Projekt-Skill beispielsweise unter .claude/skills/<name>/SKILL.md. 37
39
Diese Grenzen bleiben bestehen
Das Update erweitert die Unterstützung für Anweisungsdateien, schafft aber noch keine vollständige Gleichbehandlung aller Agenten-Konventionen.
Insbesondere kündigt Version 2.1.277 keine Erkennung eines Verzeichnisses .agents/skills/ an. Dokumentiert ist für Claude Code weiterhin der Pfad .claude/skills/<name>/SKILL.md. 1
37
Auch sollte der Fallback nicht als allgemeine Merge-Regel verstanden werden. Benötigt ein Repository portable Regeln und zusätzliche Claude-spezifische Vorgaben, ist eine explizite Struktur sinnvoll:
- Allgemeine, werkzeugübergreifende Regeln in
AGENTS.mdablegen. CLAUDE.mdfür Anweisungen behalten, die ausdrücklich nur Claude Code betreffen.- Falls beide Regelwerke gelten sollen, in
CLAUDE.mdklar auf die gemeinsame Datei verweisen oder sie importieren – nicht darauf vertrauen, dass beide automatisch geladen werden.
Damit ist Claude Code 2.1.277 vor allem ein Interoperabilitätsgewinn: Ein AGENTS.md-zentriertes Repository kann nun ohne zusätzliche Claude-Datei mit Claude Code arbeiten. Unterschiedliche Regeln für Anweisungs- und Skill-Erkennung zwischen den Tools bleiben jedoch bestehen.
Studio Global AI
Setzen Sie Ihre Recherche fort
Diese Seite enthält eine quellengestützte Antwort, die Sie in Studio Global fortsetzen können.
Die Leute fragen auch
Wie lautet die kurze Antwort auf „Claude Code 2.1.277: AGENTS.md wird zur Fallback-Datei für Projektanweisungen“?
Seit Version 2.1.277 vom 18. September 2026 kann Claude Code AGENTS.md als Projektanweisung lesen, wenn keine CLAUDE.md vorhanden ist.
Was sind die wichtigsten Punkte, die zuerst validiert werden müssen?
Seit Version 2.1.277 vom 18. September 2026 kann Claude Code AGENTS.md als Projektanweisung lesen, wenn keine CLAUDE.md vorhanden ist. Die Einstellung liegt unter „Project instructions“ in /config; auf Amazon Bedrock, Google Vertex AI und Azure AI Foundry wird sie noch nicht unterstützt.
Was soll ich als nächstes in der Praxis tun?
AGENTS.md enthält gemeinsame Repository Regeln, während SKILL.md wiederverwendbare, bei Bedarf nutzbare Fähigkeiten paketiert.