Claude Code Anleitung: So lädt Claude Code AGENTS.md

Claude Code Anleitung: die Kurzfassung

Gehen Sie in dieser Reihenfolge vor:

1. Führen Sie claude --version aus. Erforderlich ist v2.1.277 oder neuer.
2. Aktualisieren Sie die Installation bei Bedarf. Bei einer nativen Installation funktioniert claude update; Homebrew und WinGet werden mit den Befehlen des jeweiligen Paketmanagers aktualisiert.
3. Prüfen Sie, ob die Sitzung Feature-Flags von Anthropic abrufen kann. Das native Laden von AGENTS.md steht in Sitzungen über Drittanbieter-Provider wie Amazon Bedrock, Google Cloud's Agent Platform und Microsoft Foundry nicht zur Verfügung. Dasselbe gilt, wenn Telemetrieeinstellungen oder Einstellungen für nicht essenziellen Datenverkehr den Abruf des Feature-Flags verhindern.
4. Legen Sie AGENTS.md oder .claude/AGENTS.md im Projektpfad ab. Im Standardmodus darf im Arbeitsverzeichnis oder einem übergeordneten Verzeichnis kein projektbezogenes CLAUDE.md, .claude/CLAUDE.md oder CLAUDE.local.md liegen.
5. Sollen beide Dateifamilien geladen werden, öffnen Sie /config und setzen Project instructions auf claude-md-and-agents-md.
6. Testen Sie das Verhalten in einer neuen Sitzung. Die erste Sitzung nach einer Installation oder einem Update ist eine Ausnahme; beurteilen Sie das Ergebnis deshalb erst in der darauffolgenden Sitzung.

So funktioniert der native Weg. Fehlt Project instructions in /config, behalten Sie den dokumentierten Import @AGENTS.md in CLAUDE.md bei.

Welche Datei wählt Claude Code tatsächlich aus?

Das neue Verhalten gleicht einer Schaltzentrale und nicht einer pauschalen Suche nach sämtlichen Anweisungsdateien. Im Standardmodus claude-md-or-agents-md prüft Claude Code zunächst, ob es projektbezogene Claude-Anweisungen gibt. Auf AGENTS.md greift das Tool nur zurück, wenn weder im Arbeitsverzeichnis noch darüber eine passende Claude-Datei vorhanden ist.

Entscheidend ist der Geltungsbereich. Ein CLAUDE.local.md in einem übergeordneten Verzeichnis unterbindet den Rückgriff. Ein persönliches ~/.claude/CLAUDE.md, ein von der Organisation verwaltetes CLAUDE.md und .claude/rules/ tun das nicht. Dieser Unterschied erklärt viele Fälle, in denen zwei Entwickler dasselbe Repository öffnen und dennoch ein anderes Verhalten beobachten.

Greift der Fallback, liest Claude Code beim Sitzungsstart AGENTS.md und .claude/AGENTS.md aus dem Arbeitsverzeichnis sowie aus den darüberliegenden Verzeichnissen. Das AGENTS.md eines Unterverzeichnisses kann später geladen werden, sobald Claude dort eine Datei liest – sofern in diesem Unterverzeichnis keine eigene passende Claude-Datei liegt. AGENTS.local.md, AGENTS.override.md und Dateien unter .agents/ werden nicht direkt gelesen.

Das Prinzip ähnelt eher dem Umschalter einer Gebäudeinstallation als einer Ordnersuche. Zuerst wird der aktive Anweisungskreis gewählt. Die Dateien im anderen Kreis können vollkommen gültig sein und trotzdem getrennt bleiben.

Den Modus für Project instructions bewusst festlegen

Öffnen Sie /config, suchen Sie Project instructions und wählen Sie danach, welche Quelle im Repository maßgeblich sein soll:

• Fallback, claude-md-or-agents-md: Die beste Wahl für ein Repository, das bereits AGENTS.md nutzt und keine Claude-Projektdatei enthält. Dies ist der Standard.
• Beide, claude-md-and-agents-md: Geeignet, wenn AGENTS.md die gemeinsamen Regeln enthält und CLAUDE.md Claude-spezifische Hinweise ergänzt.
• Nur Claude, claude-md: Sinnvoll, wenn ein Team seine gemeinsamen Agentenanweisungen noch nicht für Claude Code freigeben möchte.
• Nur verwaltet, managed-only: Gedacht für einen kontrollierten Startkontext, in dem Organisationsrichtlinien und Auto Memory geladen werden sollen, Repository-Anweisungen beim Start jedoch nicht.

Im Modus für beide Dateifamilien liest Claude Code in jedem Verzeichnis die Claude-Inhalte vor den AGENTS-Inhalten. Außerdem lädt es dasselbe AGENTS.md nicht doppelt, wenn CLAUDE.md die Datei bereits importiert oder per Symlink einbindet.

Die Auswahl greift ab der nächsten Nachricht und bleibt auch in neuen Sitzungen bestehen. Sie kann außerdem im integrierten Plugin agents-md@builtin in den Benutzereinstellungen, in einer --settings-Datei oder in verwalteten Einstellungen hinterlegt werden. In Projekt- und lokalen Einstellungsdateien ignoriert Claude Code diese Option. Ein Repository kann daher nicht unbemerkt allen Entwicklern dieselbe Auswahl aufzwingen. Über verwaltete Einstellungen kann ein Administrator die Auswahl zentral vorgeben.

So prüfen Sie, welche Datei eine neue Sitzung geladen hat

Verwenden Sie eine harmlose Information und keine riskante Anweisung. Ergänzen Sie die zu testende Datei um diese Zeile:

Project probe: BASALT-HERON.

Beenden Sie anschließend die Sitzung, starten Sie im Repository eine neue und fragen Sie: What is the project probe? Lautet die Antwort korrekt BASALT-HERON, ist der Inhalt im Sitzungskontext angekommen. Entfernen Sie die Zeile nach dem Test wieder.

Verlassen Sie sich nicht allein auf /context. Ein direkt geladenes AGENTS.md erscheint dort nicht in der Liste Memory files. Beim Standard-Fallback kann eine interaktive Sitzung beim Start die Zeile AGENTS.md loaded anzeigen. Die Abfrage der harmlosen Testinformation funktioniert jedoch auch mit den anderen Auswahlmodi.

Schlägt der Test fehl, prüfen Sie diese Punkte der Reihe nach:

1. Version: v2.1.277 oder neuer.
2. Sitzungsnummer: Es handelt sich nicht um die erste Sitzung nach Installation oder Update.
3. Provider: Die Sitzung läuft nicht über einen Provider, der den Abruf von Anthropic-Feature-Flags verhindert.
4. Umgebung: Keine Telemetrievariable und keine Variable für nicht essenziellen Datenverkehr hat diesen Abruf deaktiviert.
5. Plugin und Richtlinie: Das integrierte agents-md-Plugin ist aktiviert und weder disableAllHooks noch allowManagedHooksOnly blockiert es.
6. Dateihierarchie: Im Standardmodus liegt auf der aktuellen Ebene oder darüber kein passendes CLAUDE.md, .claude/CLAUDE.md oder CLAUDE.local.md.
7. Modus: /config verweist auf das gewünschte Verhalten.

Fehlt Project instructions in /config, ist schon das ein diagnostisches Signal. Dann läuft die Sitzung entweder mit einer nicht unterstützten Version oder kann das Feature nicht nutzen.

Wo native Unterstützung ausfällt, bleibt der Import

Für Bedrock, Vertex, Foundry, andere Drittanbieter-Sitzungen, Umgebungen mit eingeschränkter Telemetrie und Teams mit gemischten Versionen bleibt der bestehende Import die sicherste Kompatibilitätsschicht. Schreiben Sie dazu Folgendes in die Datei CLAUDE.md, die neben AGENTS.md liegt:

@AGENTS.md

Darunter lassen sich Claude-spezifische Anweisungen ergänzen. Claude liest zuerst die importierte gemeinsame Datei und anschließend die Claude-spezifischen Ergänzungen. Bleibt diese Brücke erhalten, führt das nicht zu einer doppelten Ladung, wenn in einer unterstützten Sitzung der Modus für beide Dateifamilien ausgewählt ist.

Ein Symlink von CLAUDE.md auf AGENTS.md funktioniert ebenfalls, der Import ist jedoch plattformübergreifend sicherer. Unter Windows kann das Anlegen von Symlinks erhöhte Rechte oder den Entwicklermodus erfordern; außerdem benötigt Git die richtige Symlink-Einstellung. Ein SessionStart-Hook, der AGENTS.md ausgibt, sollte entfernt werden, sobald das direkte Laden funktioniert, da er sonst eine zweite Kopie einschleusen kann.

Mit dem Release ändert sich der Wartungsaufwand. Zuvor brauchte ein Team mit einer gemeinsamen, agentenübergreifenden Richtlinie oft zwei Dateien, einen Import-Behelf oder einen Hook. In unterstützten Sitzungen reicht im Standardfall nun eine einzige eingecheckte Anweisungsdatei. Die Claude-Lizenz wird dadurch nicht günstiger: Laut Anthropic ist Claude Code im Pro-Tarif für $20 pro Monat enthalten. Gespart werden vielmehr Synchronisationsstellen und Sitzungen, die mit veralteten Regeln arbeiten.

Für die übrige Einrichtung behandelt die ausführliche Claude Code Anleitung Installation, Projektkontext und die tägliche Befehlsfolge. Falls das Repository außerdem spezialisierte Agenten definiert, erklärt der Subagenten-Leitfaden deren separaten Startkontext.

Sieben Situationen, in denen sich die Funktion auszahlt

Die Reihenfolge richtet sich danach, wie groß das Koordinationsproblem ist, das der neue Auswahlmechanismus beseitigt.

Die ersten drei Fälle bringen den größten Nutzen, weil sich ein Fehler über mehrere Personen und Repositorys vervielfacht. Bei einem einzelnen Repository mit nur einem Agenten ist der Komfort zwar spürbar, aber begrenzt.

Was sich darauf aufbauen lässt

1. Diagnose-Tool für agentenübergreifende Anweisungen

Eine lokale CLI samt CI-Prüfung könnte exakt erklären, welche Anweisungsdateien jeder Coding-Agent lädt. Plattformteams und Beratungen würden für eine belastbare Antwort vor einem Repository-Rollout bezahlen.

Die Nachfrage ist bereits sichtbar: claude code setup kommt in den USA auf etwa 1,900 Suchanfragen im Monat, claude md vs agents md auf 480 und ein Wachstum von 1,500% gegenüber dem Vorjahr. Die kleinste verkaufbare Version scannt den Dateibaum, liest Claude-Code-Version und Provider-Konfiguration, markiert überschattende Dateien und gibt einen Plan der Ladereihenfolge aus. Eine kostenpflichtige Teamversion könnte dieselbe Richtlinie Repository-übergreifend durchsetzen.

Das ist die stärkste Chance, weil sie ein Diagnoseproblem statt eines Vorlagenproblems löst. Allerdings besteht Plattformrisiko: Anthropic könnte die Prüfungen in claude doctor integrieren. Ein dauerhaft tragfähiges Produkt müsste deshalb mehrere Coding-Agenten abdecken und den Verlauf von Richtlinienabweichungen dokumentieren, statt nur einen einzelnen Claude-Befehl zu bedienen.

2. Starter und Linter für AGENTS.md-Richtlinien

Ein geführter Editor könnte aus Build-Befehlen, Testregeln, Verzeichnisgrenzen und Review-Anforderungen ein prägnantes AGENTS.md erstellen und anschließend auf Widersprüche sowie schwammige Formulierungen prüfen. Die Zielgruppe wären kleinere Entwicklungsteams, die mehrere Agenten einführen.

agents md erreicht in den USA etwa 2,900 Suchanfragen pro Monat. Die engere Suchanfrage agents md best practices kommt auf 210 und ist gegenüber dem Vorjahr um 750% gewachsen. Ein MVP braucht einen Repository-Scanner, ein kurzes Interview, einen generierten Entwurf sowie Lint-Regeln für doppelte oder widersprüchliche Anweisungen. Statt ein riesiges Richtlinienhandbuch zu produzieren, sollte das Tool die Provider-Empfehlung für knappe Projektdateien einhalten.

Der Haken ist die geringe Differenzierbarkeit. Jeder Coding-Agent kann Markdown entwerfen. Einen festen Platz verdient das Produkt nur, wenn seine Validierung die tatsächliche Ladereihenfolge abbildet und nachweisen kann, dass jedes unterstützte Coding-Tool das Ergebnis verarbeitet hat.

3. Migrationsaudit für gemischte Tool-Flotten

Ein Bericht könnte CLAUDE.md, AGENTS.md, Importe, Symlinks, Hooks, verschachtelte Regeln und Provider-Ausnahmen erfassen und daraus einen sicheren Migrationsplan hin zu einer einzigen Quelle ableiten. Als Käufer kommen Agenturen und größere Teams mit mehreren Agenten-Tools infrage.

Die 480 monatlichen Suchanfragen für claude md vs agents md bei einem Wachstum von 1,500% gegenüber dem Vorjahr belegen diese Unsicherheit ungewöhnlich direkt. Als MVP genügt eine Repository-Analyse mit reinem Lesezugriff und einem Plan für einen Pull Request. Eine Brücke sollte nie automatisch gelöscht werden, denn nicht unterstützte Sitzungen könnten weiterhin darauf angewiesen sein.

Das Zeitfenster ist allerdings kurz. Sobald sich Teams auf eine stabile Konvention für gemeinsam genutzte Dateien geeinigt haben, nimmt der Bedarf an einmaligen Migrationen ab. Wiederkehrende Richtlinienaudits und Kompatibilitätsprüfungen für Provider müssten deshalb zum Kerngeschäft werden.

Grenzen und eine ehrliche Einschätzung

Der native Fallback beseitigt eine Brücke. Er setzt Projektanweisungen weder verbindlich durch noch macht er jeden Provider kompatibel oder löst widersprüchliche Vorgaben auf. Anthropic beschreibt Anweisungsdateien als Kontext. Muss ein Befehl zwingend blockiert werden, ist dafür eine Berechtigungsregel oder ein PreToolUse-Hook erforderlich.

Außerdem wird AGENTS.md dadurch nicht in denselben Diagnoseansichten sichtbar wie CLAUDE.md. Eine direkt geladene Datei fehlt sowohl in /memory als auch in der Liste Memory files unter /context. Wegen dieser Inkonsistenz gehört die harmlose Testinformation in jede Migrationscheckliste.

Entfernen Sie einen funktionierenden Import in einer gemischten Provider-Flotte nicht nur deshalb, weil der native Test auf einem Laptop erfolgreich war. Wählen Sie den Modus für beide Dateifamilien nicht, ohne mögliche Widersprüche zu prüfen. Innerhalb eines Verzeichnisses werden Claude-Inhalte zwar vor AGENTS-Inhalten gelesen, die Reihenfolge im Kontext ist aber kein verbindliches System für Richtlinienprioritäten.

Trotzdem ist das Release eine relevante operative Verbesserung. Ein Repository, das AGENTS.md bereits als gemeinsame Quelle behandelt, kann nun mit Claude Code arbeiten, ohne den zweiten Dateinamen zur eigentlichen Quelle erklären zu müssen. Eine kleine Funktion entfaltet so eine große Wirkung auf die Zusammenarbeit.

Wenn Sie ein zuverlässiges System für agentenübergreifende Anweisungen in Ihren Repositorys aufbauen möchten, unterstütze ich Sie bei Agentenarchitektur und Rollout.