Source: https://aiprimetech.io/de/blog/claude-code-agents-md-support/ Sept. 19, 2026 · 8 Min. · Entwicklerleitfäden # Claude Code liest jetzt AGENTS.md: CLAUDE.md im Vergleich zu AGENTS.md und das Verzeichnis .claude A Von [AI Prime Tech](https://aiprimetech.io/de/) · KI-unterstützt Wenn Sie sich fragen „Was ist claude.md?“, handelt es sich um eine Markdown-Datei, die Claude Code dauerhafte Anweisungen zu Ihrem Projekt und Workflow gibt. Claude Code 2.1.277, veröffentlicht am 18. September 2026, unterstützt nun das Lesen von AGENTS.md , wenn keine geeignete Claude-Anweisungsdatei vorhanden ist. Dieser Leitfaden erklärt diesen Fallback, wie Sie beide Dateien laden und wo Einstellungen, Befehle, Subagenten und Skills im .claude Verzeichnis hingehören. ## Was ist claude.md, und was sollte darin stehen? CLAUDE.md ist eine Markdown-Datei im Klartextformat mit Anweisungen, die Claude Code in seinen Sitzungskontext einliest. Sie bietet Ihnen einen Ort, um Informationen festzuhalten, die Sie sonst wiederholen müssten: Build- und Testbefehle, Programmierkonventionen, Projektarchitektur und Workflow-Regeln. Es gibt kein vorgeschriebenes Dokumentformat. Sie können die Datei mit gewöhnlichen Markdown-Überschriften und -Listen organisieren und dabei die Struktur wählen, die die Anweisungen Ihres Projekts leicht verständlich macht. Die von Claude Code /init Der Befehl erzeugt eine auf dem Projekt basierende Ausgangsdatei, wie beschrieben in der [offiziellen Dokumentation zu bewährten Verfahren](https://code.claude.com/docs/en/best-practices). Ein sinnvoller Ausgangspunkt ist, vier Bereiche abzudecken: - Build- und Testbefehle: die Befehle, mit denen Mitwirkende das Projekt bauen und Änderungen prüfen sollten. - Programmierkonventionen: Benennung, Formatierung und andere für das Repository relevante Konventionen. - Projektarchitektur: die Hauptkomponenten und ihr Zusammenspiel. - Workflow-Regeln: die Schritte, die Claude beim Vornehmen und Prüfen von Änderungen befolgen soll. Betrachten Sie diese als dauerhafte Vorgaben. Anweisungen werden in Claudes Kontext aufgenommen; sie sind keine verbindlich durchgesetzte Konfiguration. Wenn Sie Claude Code selbst konfigurieren müssen, verwenden Sie die entsprechende Einstellungsdatei, statt zu erwarten, dass Fließtext in CLAUDE.md als Einstellungswert fungiert. Diese Unterscheidung ist bei der Organisation eines Repositorys wichtig: Projektwissen gehört in Anweisungsdateien, während die Anwendungskonfiguration in die Einstellungen gehört. Die [Übersichtsseite mit Leitfäden zu Claude Code](/de/claude-code/) bietet einen Ausgangspunkt für den zugehörigen Workflow. ## Wo CLAUDE.md hingehört Claude Code unterstützt gemeinsame Projektanweisungen und persönliche Anweisungen an mehreren Speicherorten. Die [Dokumentation zu Anweisungsdateien](https://code.claude.com/docs/en/memory) beschreibt diese etablierten Speicherorte und wie Anweisungen gefunden werden. | Speicherort | Zweck | ./CLAUDE.md | Gemeinsame Anweisungen für das Projekt | ./.claude/CLAUDE.md | Gemeinsame Projektanweisungen innerhalb von .claude | ~/.claude/CLAUDE.md | Projektübergreifende persönliche Anweisungen | ./CLAUDE.local.md | Persönliche Anweisungen für das aktuelle Projekt Anweisungsdateien in übergeordneten Verzeichnissen werden beim Start geladen. Dateien in Unterverzeichnissen werden bei Bedarf geladen, sodass Anweisungen relevant werden, wenn Claude in diesen Teilen des Projekts arbeitet. Wählen Sie für gemeinsame Anweisungen einen Speicherort, der für Ihr Team sinnvoll ist. Eine Datei im Stammverzeichnis namens CLAUDE.md platziert die Vorgaben neben den anderen Dateien auf oberster Ebene des Repositorys. .claude/CLAUDE.md platziert sie bei den Claude-spezifischen Dateien des Projekts. ### Persönliche Anweisungen beeinflussen mehr als die Dateiorganisation CLAUDE.local.md erfüllt einen anderen Zweck als die gemeinsame Projektdatei: Sie enthält Ihre persönlichen Anweisungen für dieses Projekt. In Version 2.1.277 beeinflusst ihre Existenz auch, ob Claude Code zurückgreift auf AGENTS.md. Das bedeutet, dass das Hinzufügen einer lokalen Anweisungsdatei ändern kann, welche gemeinsamen Anweisungen in den Kontext aufgenommen werden. Bevor Sie eine solche Datei in einem Repository erstellen, das sich stützt auf AGENTS.md, prüfen Sie die unten beschriebene Einstellung „Projektanweisungen“. Die oben genannten Speicherorte stammen aus einer laufend aktualisierten Dokumentation, deren genauer Wortlaut vom September 19 nicht überprüft wurde. Das Fallback-Verhalten im nächsten Abschnitt ist speziell für die mit einem Tag versehene Version 2.1.277 dokumentiert. ## Liest Claude Code AGENTS.md automatisch? Ja, unter bestimmten Bedingungen. Die [Versionshinweise zu Claude Code 2.1.277](https://github.com/anthropics/claude-code/releases/tag/v2.1.277) besagen: „Unterstützung für AGENTS.md hinzugefügt: In einem Projekt ohne CLAUDE.md liest Claude Code stattdessen AGENTS.md“. Das Standardverhalten ist ein Fallback. Daher bedeutet die bloße Existenz einer AGENTS.md Datei nicht, dass sie geladen wird. In dieser Version umfasst die Prüfung mehr als eine Datei im Stammverzeichnis namens CLAUDE.md. ### Was unterdrückt den standardmäßigen Fallback? Jede dieser Dateien an beliebiger Stelle entlang des Pfads vom Stammverzeichnis des Dateisystems bis zum Arbeitsverzeichnis unterdrückt den standardmäßigen AGENTS.md Fallback: - CLAUDE.md - .claude/CLAUDE.md - CLAUDE.local.md Verwaltete Anweisungen, persönliche Anweisungen in ~/.claude/CLAUDE.mdund .claude/rules/ unterdrücken nicht diesen Fallback. Betrachten Sie beispielsweise ein Repository mit einer gemeinsamen AGENTS.md und ohne passende Claude-Anweisungsdatei entlang des Pfads durch die übergeordneten Verzeichnisse. Im Standardmodus werden die AGENTS-Anweisungen gelesen. Wenn Sie anschließend Folgendes hinzufügen: CLAUDE.local.md, wird der standardmäßige Fallback unterdrückt – obwohl die neue Datei persönliche Anweisungen statt der gemeinsamen Vorgaben des Teams enthält. ### Wie AGENTS.md gefunden wird Die integrierte Unterstützung wird bereitgestellt durch das agents-md Plugin, Version 0.1.0. Es findet beide AGENTS.md und .claude/AGENTS.md entlang des Pfads durch die übergeordneten Verzeichnisse und fügt verschachtelte Anweisungen hinzu, wenn Claude Dateien unterhalb des Projektstammverzeichnisses liest. Bereits über einen Import oder Link geladene Inhalte werden dedupliziert. Das ist relevant, wenn eine Claude-Anweisungsdatei bereits dieselben AGENTS-Inhalte einbindet. Zum Redaktionsschluss im September 19 ist diese Unterstützung laut Versionsankündigung noch nicht auf Bedrock, Vertex oder Foundry verfügbar. ## Claude Code so konfigurieren, dass eine Datei oder beide gelesen werden Öffnen Sie /config und ändern Sie Projektanweisungen , um das Verhalten beim Laden von Anweisungen auszuwählen. Die [README des mit dem Tag v2.1.277 versehenen Plugins](https://raw.githubusercontent.com/anthropics/claude-code/v2.1.277/mods/agents-md/README.md) dokumentiert vier genaue Werte. | Wert | Verhalten | claude-md-or-agents-md | Standard: Claude-Anweisungsdateien verwenden, mit AGENTS als Fallback, wenn keine passende Claude-Datei vorhanden ist | claude-md-and-agents-md | Sowohl Claude- als auch AGENTS-Anweisungsdateien laden | claude-md | Nur Claude-Anweisungsdateien laden | managed-only | Verwaltete Anweisungen und Engine-Speicher beibehalten; Projekt-, lokale und Benutzeranweisungen aus dem anfänglichen Kontext entfernen Die README enthält eine wichtige Einschränkung für managed-only: Verschachtelte CLAUDE.md Anhänge können weiterhin hinzukommen. Interpretieren Sie den Wert nicht als Garantie dafür, dass keine verschachtelten Claude-Anweisungsinhalte in die Unterhaltung gelangen können. ### Genaue Konfiguration für Version 2.1.277 Verwenden Sie diese Konfiguration, um beide Anweisungsarten zu laden: ``` { "pluginConfigs": { "agents-md@builtin": { "options": { "instructionFiles": "claude-md-and-agents-md" } } } } ``` Tragen Sie sie für diese Version in die Benutzereinstellungen unter ~/.claude/settings.json, in eine Datei, die bereitgestellt wird über --settings, oder in die verwalteten Einstellungen ein. Die Projektdatei .claude/settings.json stellt nicht diese Plugin-Optionen bereit. Änderungen werden wirksam, wenn der Kontext das nächste Mal neu aufgebaut wird, etwa beim nächsten Gesprächsschritt oder in einer neuen Unterhaltung. Berücksichtigen Sie diesen Zeitpunkt, wenn Sie prüfen, ob eine Einstellung die geladenen Anweisungen verändert hat. ### Der Import gemeinsamer Anweisungen bleibt eine Option Sie können auch @AGENTS.md in einer benachbarten CLAUDE.mdplatzieren. Dadurch werden die gemeinsamen Anweisungen ausdrücklich über die Claude-Anweisungsdatei importiert. Importe in Claude-Anweisungsdateien verwenden @path/to/file.md und wurden in v0.2.107 eingeführt. Version 2.1.277 dedupliziert AGENTS-Inhalte, die bereits importiert wurden durch CLAUDE.md. Damit haben Sie zwei Möglichkeiten, gemeinsame Vorgaben zu organisieren: Konfigurieren Sie Claude Code so, dass beide Dateien geladen werden, oder verwenden Sie einen Import, um AGENTS-Inhalte in eine Claude-Anweisungsdatei einzubinden. Wählen Sie die Anordnung, die den Zusammenhang für Mitwirkende am Repository deutlich macht. ## Was gehört in das Verzeichnis .claude? Das .claude Verzeichnis enthält verschiedene Arten von Projektdateien. Sie erfüllen unterschiedliche Zwecke. Wählen Sie den Speicherort daher danach aus, ob Sie dauerhafte Vorgaben, eine Konfiguration, einen wiederverwendbaren Prompt, eine Subagenten-Definition oder einen Ablauf schreiben. | Datei oder Verzeichnis | Zweck | .claude/CLAUDE.md | Gemeinsame Projektanweisungen | .claude/settings.json | Gemeinsame Projektkonfiguration, die für das Team eingecheckt werden kann | .claude/settings.local.json | Persönliche Überschreibungen der Projekteinstellungen | .claude/commands/.md | Wiederverwendbare benutzerdefinierte Prompts für Slash-Befehle | .claude/agents/.md | Subagenten-Definitionen für das Projekt | .claude/skills//SKILL.md | Wiederverwendbare Abläufe, optional mit Skripten und Referenzdateien Projektübergreifende persönliche Einstellungen befinden sich in ~/.claude/settings.json. Persönliche Subagenten-Definitionen verwenden ~/.claude/agents/, und persönliche Skills verwenden ~/.claude/skills//SKILL.md. ### Befehle, Subagenten und Skills Eine Befehlsdatei wie .claude/commands/deploy.md erstellt /deploy. Version 2.1.3 führte Slash-Befehle und Skills zusammen, und bestehende Befehlsdateien funktionieren weiterhin neben Skills. Subagenten-Definitionen verwenden Markdown mit YAML-Frontmatter. Die erforderlichen Felder sind name und description; relevante optionale Felder sind tools, modelund permissionMode. Verwalten Sie sie mit /agents, und verwenden Sie den [Leitfaden zu Subagenten](/de/claude-code/subagents/) für diesen Teil Ihrer Projekteinrichtung. Skills bündeln wiederverwendbare Abläufe in einem Ordner mit SKILL.md, optional ergänzt durch Skripte und Referenzmaterial. Claude kann relevante Skills auswählen, oder Sie können einen Skill aufrufen mit /skill-name; der Inhalt des Skills wird bei der Verwendung geladen. Der [Leitfaden zu Skills](/de/claude-code/skills/) beschreibt diesen Workflow. Diese Strukturen gab es bereits vor der Version mit AGENTS-Fallback. Das [Changelog des Versions-Tags](https://raw.githubusercontent.com/anthropics/claude-code/v2.1.277/CHANGELOG.md) bestätigt, dass Projekteinstellungen, Befehle, Agenten und Skills spätestens in v2.1.277 vorhanden waren. Die detaillierten Verzeichnisbeschreibungen stützen sich auf laufend aktualisierte Dokumentation, deren genauer Wortlaut am Stichtag nicht überprüft wurde. ## CLAUDE.md im Vergleich zum automatischen Gedächtnis CLAUDE.md und das automatische Gedächtnis unterscheiden sich darin, wer die Inhalte schreibt. Sie schreiben Anweisungsdateien, um Projektvorgaben festzulegen; Claude speichert nützlichen Kontext im automatischen Gedächtnis. Das Changelog des Versions-Tags dokumentiert das automatische Speichern und die Verwaltung über /memory in Version 2.1.59. Das automatische Gedächtnis erfüllt daher eine andere Aufgabe als die Anweisungen, die Sie bewusst pflegen in CLAUDE.md oder AGENTS.md. Orientieren Sie sich bei der Entscheidung, wohin Informationen gehören, an diesem Unterschied in der Urheberschaft. Schreiben Sie explizite Build-Befehle, Konventionen, Architekturhinweise und Workflow-Regeln in Ihre Anweisungsdateien. Verwenden Sie /memory , um den nützlichen Kontext zu verwalten, den Claude automatisch speichert. ## Wichtige Erkenntnisse - CLAUDE.md enthält dauerhafte Markdown-Anweisungen, die Claude Code in den Kontext lädt; eine Konfiguration wird dadurch nicht erzwungen. - Claude Code 2.1.277 ergänzt einen bedingten AGENTS.md Fallback, wobei Bedrock, Vertex und Foundry bei der Veröffentlichung ausgeschlossen sind. - Eine in einem übergeordneten Verzeichnis vorhandene CLAUDE.md, .claude/CLAUDE.md, oder CLAUDE.local.md unterdrückt den standardmäßigen Fallback. - Setzen Sie die Projektanweisungen auf claude-md-and-agents-md , um beide Arten von Anweisungen zu laden. - In v2.1.277 gehören die Plugin-Optionen in die Benutzereinstellungen, eine --settings Datei oder verwaltete Einstellungen – nicht in die projektbezogene .claude/settings.json. - Das .claude Verzeichnis enthält außerdem Einstellungen, Befehle, Subagenten und Skills; das automatische Gedächtnis enthält von Claude gespeicherten Kontext. ## FAQ ### Was ist CLAUDE.md? CLAUDE.md ist eine Markdown-Datei im Klartext mit dauerhaften Anweisungen für Claude Code, etwa Build-Befehlen, Programmierkonventionen, Architekturhinweisen und Workflow-Regeln. Claude lädt sie in den Sitzungskontext, und /init kann auf Grundlage des Projekts eine Ausgangsdatei erzeugen. ### Welche Datei wird geladen, wenn sowohl CLAUDE.md als auch AGENTS.md vorhanden sind? In Claude Code 2.1.277 im voreingestellten claude-md-or-agents-md Modus unterdrückt eine passende Claude-Anweisungsdatei den Rückgriff auf AGENTS. Wählen Sie claude-md-and-agents-md , um beide zu laden, oder importieren Sie benachbarte AGENTS-Anweisungen mit @AGENTS.md innerhalb von CLAUDE.md. ### Warum verhindert das Hinzufügen von CLAUDE.local.md den AGENTS-Fallback? Version 2.1.277 zählt CLAUDE.local.md zu den Dateien, die den standardmäßigen Fallback unterdrücken, wenn sie auf dem Pfad vom Stammverzeichnis des Dateisystems bis zum Arbeitsverzeichnis gefunden werden. Ihre Anwesenheit kann daher beeinflussen, ob gemeinsame AGENTS-Anweisungen geladen werden, obwohl sie eigentlich persönlichen Projektvorgaben dient. ### Kann ich beide Dateien in der projektbezogenen .claude/settings.json aktivieren? In v2.1.277 stellt die projektbezogene .claude/settings.json nicht die agents-md Plugin-Optionen bereit. Verwenden Sie /config, oder hinterlegen Sie die dokumentierte pluginConfigs Konfiguration in den Benutzereinstellungen, einer --settings Datei oder in verwalteten Einstellungen. [Claude](/de/blog/tag/claude/)[Programmierung](/de/blog/tag/coding/)[Agenten](/de/blog/tag/agents/) A [AI Prime Tech](https://aiprimetech.io/de/) AI Prime Tech veröffentlicht diesen Blog. Die Artikel werden mit KI-Unterstützung verfasst; prüfen Sie versionsspezifische Angaben wie Modell-IDs, Preise und Limits anhand der offiziellen Dokumentation, bevor Sie sich darauf verlassen. Günstigeren Zugang zur Claude API erhalten Ein API-Schlüssel für Claude Opus 5.5, Sonnet 5, Haiku 4.5 und Fable 5.1 sowie GPT-6 Modelle. Nutzungsbasierte Abrechnung, kein Abonnement. [API-Schlüssel erhalten →](/register) AI Prime Tech ist ein unabhängiges API-Gateway eines Drittanbieters. Claude™ und Anthropic® sind Marken von Anthropic, PBC. Eine Verbindung oder Unterstützung wird nicht impliziert.