# Claude Code liest jetzt AGENTS.md: Was sich in 2.1.277 geändert hat
> Am 18. September 2026 erhielt Claude Code 2.1.277 direkte Unterstützung für AGENTS.md: wann die Datei geladen wird, wie man einen von 4 Modi auswählt und was mit Imports zu tun ist.
Source: https://ailoot.ai/blog/de/claude-code-agents-md-support/
Canonical: https://ailoot.ai/blog/de/claude-code-agents-md-support/
Language: de
Publisher: Ailoot (https://ailoot.ai/)
Translation: guide-041
Revision: sha256-76423f0d3cb1494ed4b95a1a079786e16fae93a1f8f6ddea5133dc766ca4bd97
Am 18. September 2026 wurde Claude Code 2.1.277 um Unterstützung für `AGENTS.md` erweitert. Wenn die Funktion in der Sitzung und im Arbeitsverzeichnis verfügbar ist und es in der Verzeichniskette darüber weder `CLAUDE.md`, `.claude/CLAUDE.md` noch `CLAUDE.local.md` gibt, liest Claude Code `AGENTS.md` standardmäßig ohne manuellen Import. Zuvor geschah dies über einen `@AGENTS.md`-Import in `CLAUDE.md` oder über einen symbolischen Link von `CLAUDE.md` auf `AGENTS.md` – weitere Details finden Sie im Artikel [über eine gemeinsame Anweisungsdatei für mehrere Agents](https://ailoot.ai/blog/de/agents-md-claude-md-one-instruction-file/).
Wenn Sie Claude Code und ein oder zwei weitere Tools im selben Repository verwenden, bestimmt der Modus „Project instructions“, den Sie auswählen, welche Anweisungsdateien Claude Code liest. Im Folgenden finden Sie die Bedingungen für jeden der vier Modi und die Schritte für den Wechsel von der bisherigen Einrichtung.
Weitere Materialien zur Konfiguration von Tools finden Sie in der [Ailoot-Dokumentation](https://ailoot.ai/docs/).
[Ailoot-Anleitungen](https://ailoot.ai/docs/)
## Was hat sich bei AGENTS.md in Claude Code 2.1.277 geändert?
Das Wichtigste
Seit dem 18. September 2026 liest Claude Code `AGENTS.md` standardmäßig, wenn es in der Verzeichniskette vom Arbeitsordner aufwärts weder `CLAUDE.md`, `.claude/CLAUDE.md` noch `CLAUDE.local.md` gibt. Wenn eine solche Datei vorhanden ist, ist das automatische Lesen von `AGENTS.md` über Project instructions nicht aktiviert. Ein expliziter `@AGENTS.md`-Import aus `CLAUDE.md` funktioniert weiterhin. Die benutzerspezifische `~/.claude/CLAUDE.md`, die von der Organisation verwaltete `CLAUDE.md` und `.claude/rules/` werden unabhängig von der Auswahl zwischen Projektdateien geladen. Der Modus wird über `/config` gewechselt. Die Funktion ist auf Bedrock, Vertex oder Foundry noch nicht verfügbar.
Im offiziellen CHANGELOG.md des Claude-Code-Projekts auf GitHub steht es so:
Unterstützung für AGENTS.md hinzugefügt: In einem Projekt ohne CLAUDE.md liest Claude Code stattdessen AGENTS.md; die Einstellung lässt sich unter „Project instructions“ in /config ändern (noch nicht auf Bedrock, Vertex oder Foundry)
— Anthropic, Commit in claude-code CHANGELOG.md, ca02e7d, https://github.com/anthropics/claude-code/commit/ca02e7deeb0707f558b0afd7e9e5d67a382e12b3
Übersetzung: Die Unterstützung für `AGENTS.md` wurde hinzugefügt – in einem Projekt ohne `CLAUDE.md` liest Claude Code jetzt stattdessen `AGENTS.md`; dies lässt sich unter „Project instructions“ in `/config` umschalten (auf Bedrock, Vertex oder Foundry noch nicht verfügbar).
Vor dieser Version führte das Fehlen von `CLAUDE.md`, `.claude/CLAUDE.md` und `CLAUDE.local.md` im Arbeitsordner und darüber allein nicht dazu, dass `AGENTS.md` gelesen wurde. Dafür war ein expliziter Import, ein symbolischer Link oder ein manueller Hook erforderlich. Wenn die Funktion jetzt verfügbar ist, lädt der Agent die Datei automatisch.
## Welche Dateien verhindern das automatische Lesen von AGENTS.md?
Das Wichtigste
Im Standardmodus werden `CLAUDE.md`, `.claude/CLAUDE.md` und `CLAUDE.local.md` im Arbeitsverzeichnis und darüber geprüft. Die persönliche `~/.claude/CLAUDE.md`, die von der Organisation verwaltete `CLAUDE.md` und Dateien in `.claude/rules/` verhindern das Lesen von `AGENTS.md` nicht und werden zusätzlich geladen.
Wenn Sie eine persönliche `~/.claude/CLAUDE.md` mit Einstellungen zum Codierstil haben, hindert sie Claude Code nicht daran, die projektbezogene `AGENTS.md` zu lesen. Eine `CLAUDE.local.md` im Arbeitsordner – selbst wenn sie nicht zu Git hinzugefügt und für persönliche Notizen verwendet wird – verhindert im Standardmodus jedoch das automatische Lesen von `AGENTS.md`. Ein expliziter Import funktioniert weiterhin; wenn beide Dateien direkt gelesen werden sollen, müssen Sie den Modus wechseln.
Wenn unter Project instructions ein Modus zum direkten Lesen ausgewählt ist (siehe „4 Modi für Project instructions – welchen soll man auswählen?“ weiter unten) und es im Arbeitsverzeichnis oder darüber weder `CLAUDE.md`, `.claude/CLAUDE.md` noch `CLAUDE.local.md` gibt, liest Claude Code beim Start der Sitzung alle `AGENTS.md`- und `.claude/AGENTS.md`-Dateien in diesen Verzeichnissen. Für den Fall, dass keine blockierenden Dateien vorhanden sind, zeigt die Dokumentation in einer interaktiven Sitzung eine Zeile wie diese:
```
no CLAUDE.md found; AGENTS.md loaded: /home/you/repo/AGENTS.md
```
Eine `AGENTS.md` in einem Unterverzeichnis wird geladen, wenn Claude mit dem Read-Tool eine Datei dort öffnet. Im Modus `claude-md-or-agents-md` geschieht dies nur, wenn dieses Unterverzeichnis keine eigene `CLAUDE.md`, `.claude/CLAUDE.md` oder `CLAUDE.local.md` enthält. Für `claude-md-and-agents-md` beschreibt die Dokumentation die allgemeine Regel: `CLAUDE.md` und `AGENTS.md` werden zusammen gelesen, in jedem Verzeichnis zuerst `CLAUDE.md`, dann `AGENTS.md`. `AGENTS.local.md`, `AGENTS.override.md` und Inhalte des Verzeichnisses `.agents/` werden nicht automatisch gelesen.
Materialien zur Konfiguration des Arbeitsbereichs eines KI-Agents, einschließlich Anweisungsdateien mit Projektkontext, finden Sie in der [Ailoot-Dokumentation](https://ailoot.ai/docs/).
[Ailoot-Anleitungen](https://ailoot.ai/docs/)
## 4 Modi für Project instructions – welchen soll man auswählen?
Das Wichtigste
Im Bereich Project instructions des Befehls `/config` gibt es vier Werte: `claude-md-or-agents-md` (Standard – eine der beiden Dateien), `claude-md-and-agents-md` (beide zusammen), `claude-md` (nur `CLAUDE.md` wird automatisch gelesen, selbst wenn das Projekt nur `AGENTS.md` enthält) und `managed-only` (beim Start nur die von der Organisation verwaltete `CLAUDE.md` und das automatische Gedächtnis, ohne Projekt- oder persönliche Dateien). Die Änderung tritt mit der nächsten gesendeten Nachricht und in jeder neuen Sitzung in Kraft.
Das Verhalten der Modi in der Tabelle ist in der Dokumentation von Anthropic beschrieben. Die rechte Spalte enthält Empfehlungen zur Auswahl:
| Wert | Was Claude Code liest | Wann der Modus geeignet ist |
|----|----|----|
| `claude-md-or-agents-md` | `CLAUDE.md` oder `AGENTS.md`, wenn es im Arbeitsverzeichnis oder darüber keine `CLAUDE.md`, `.claude/CLAUDE.md` oder `CLAUDE.local.md` gibt | Standard, wenn das Repository nur eine der beiden Dateien verwendet und keine blockierenden Dateien darüber vorhanden sind |
| `claude-md-and-agents-md` | Beide Dateien zusammen: in jedem Verzeichnis zuerst `CLAUDE.md`, dann `AGENTS.md` | Sie benötigen eine gemeinsame `AGENTS.md` für alle Tools und eine kurze `CLAUDE.md` nur für Claude; oder Sie müssen `AGENTS.md` lesen, wenn `CLAUDE.local.md` vorhanden ist |
| `claude-md` | Nur `CLAUDE.md`; das automatische Lesen von `AGENTS.md` über Project instructions ist deaktiviert, selbst wenn `AGENTS.md` die einzige Datei ist (ein expliziter `@AGENTS.md`-Import aus `CLAUDE.md` funktioniert weiterhin) | `AGENTS.md` wurde für ein anderes Tool geschrieben und könnte Claude verwirren |
| `managed-only` | Beim Start der Sitzung nur die von der Organisation verwaltete `CLAUDE.md` und das automatische Gedächtnis; Projekt-, lokale und benutzerspezifische `CLAUDE.md`, `.claude/rules/` und alle `AGENTS.md`-Dateien sind vom anfänglichen Satz ausgeschlossen. `CLAUDE.md`- und `.claude/rules/`-Dateien in Unterverzeichnissen werden jedoch weiterhin später geladen, wenn Claude dort eine Datei öffnet. Der Modus begrenzt den anfänglichen Satz und bietet keine vollständige Abschottung von Projektdateien | Für Organisationen, denen wichtig ist, mit welchem Anweisungssatz Claude Code eine Sitzung startet – unabhängig davon, ob das Projekt selbst `CLAUDE.md` oder `AGENTS.md` enthält |
Sie können den Modus auch ohne die Benutzeroberfläche über `settings.json` auswählen:
```json
{
"pluginConfigs": {
"agents-md@builtin": {
"options": {
"instructionFiles": "claude-md-and-agents-md"
}
}
}
}
```
Claude Code ignoriert diesen Wert in den Einstellungen `project` und `local`. Laut der Dokumentation von Anthropic lässt er sich in `~/.claude/settings.json`, in einer `--settings`-Datei oder in den von der Organisation verwalteten Einstellungen festlegen.
Wenn Sie bereits eine gemeinsame Anweisungsdatei für mehrere KI-Tools in einem Repository eingerichtet haben, erklären die [Anweisungen für Versionen vor 2.1.277](https://ailoot.ai/blog/de/agents-md-claude-md-one-instruction-file/), wie der `@`-Import funktioniert. Diese Methode funktioniert weiterhin.
## Warum fehlt Project instructions in /config?
Das Wichtigste
Laut der Dokumentation von Anthropic kann der Bereich Project instructions aus folgenden Gründen fehlen:
- Claude Code ist älter als Version 2.1.277.
- Die Sitzung erhält keine Feature-Flags von Anthropic – zum Beispiel bei Verwendung von Bedrock, einem anderen Drittanbieter oder wenn Telemetrie deaktiviert ist.
- Dies ist die erste Sitzung unmittelbar nach der Installation oder einem Update von einer älteren Version. Wenn dies der einzige Grund ist, erscheint die Funktion in der nächsten Sitzung. `AGENTS.md` wird nur geladen, wenn die Bedingungen des ausgewählten Modus erfüllt sind.
- Das integrierte Plugin `agents-md` ist unter `/plugin` deaktiviert.
Prüfen Sie zunächst mit dem Befehl `claude --version` die Version. Liegt sie unter 2.1.277, aktualisieren Sie Claude Code. Ist die Version geeignet, der Bereich wird aber weiterhin nicht angezeigt, prüfen Sie die anderen oben aufgeführten Gründe. Solange die Funktion nicht verfügbar ist, bleibt der Import von `@AGENTS.md` in `CLAUDE.md` ein funktionierender Ausweg.
## Was tun mit dem bisherigen @AGENTS.md-Import?
Das Wichtigste
Sie können den `@AGENTS.md`-Import in `CLAUDE.md` und den symbolischen Link beibehalten: In keinem Modus wird die Datei dadurch zweimal gelesen. Eine Textaufforderung wie „AGENTS.md lesen“ sollte durch einen Import ersetzt werden, wenn Sie `CLAUDE.md` behalten. Bevor Sie eine Datei löschen, sichern Sie alle benötigten Anweisungen und prüfen Sie die Bedingungen des ausgewählten Modus. Wenn Sie zum direkten Lesen wechseln, entfernen Sie jeden `SessionStart`-Hook, der den Inhalt von `AGENTS.md` manuell ausgegeben hat; andernfalls gelangt eine zweite Kopie der Datei in den Kontext. Prüfen Sie anschließend das Laden in einer neuen Sitzung; wie die Prüfung erfolgt, hängt von der Version und davon ab, ob blockierende Dateien vorhanden sind.
Die nächsten Schritte hängen von der bisherigen Einrichtung ab. Prüfen Sie zunächst, ob die Funktion in Ihrer Sitzung verfügbar ist, wie im vorherigen Abschnitt beschrieben.
- **`CLAUDE.md` mit einem `@AGENTS.md`-Import.** Sie können die Datei unverändert lassen – Claude Code wird sie unter keinem Wert von Project instructions zweimal lesen. Das Löschen von `CLAUDE.md` ist optional: Der Import gewährt Claude bereits Zugriff auf den Inhalt von `AGENTS.md`. Prüfen Sie das Laden über den Import weiterhin mit `/memory`; eine direkte Frage an Claude nach dem Inhalt der Anweisungen ist nur eine schwache Prüfung.
- **`CLAUDE.md`, die in Worten zum Lesen von `AGENTS.md` auffordert.** Eine solche Aufforderung ist kein Import und garantiert für sich genommen nicht, dass die Datei geladen wird. Ersetzen Sie den Wortlaut durch einen `@AGENTS.md`-Import, wenn Sie `CLAUDE.md` behalten möchten (zum Beispiel für Tools, die sie ebenfalls lesen). Wenn Sie `CLAUDE.md` vollständig löschen und den Modus `claude-md-or-agents-md` ausgewählt haben, prüfen Sie zuerst, ob `CLAUDE.md` keine einzigartigen Anweisungen enthält und ob es im Arbeitsverzeichnis oder darüber keine andere `CLAUDE.md`, `.claude/CLAUDE.md` oder `CLAUDE.local.md` gibt; andernfalls liest Claude Code weiterhin die verbleibende Datei statt `AGENTS.md`. Prüfen Sie nach dem Löschen, ob der Wechsel erfolgt ist: Wenn keine blockierenden Dateien mehr vorhanden sind, erscheint in einer interaktiven Sitzung die Zeile `AGENTS.md loaded`. Wenn `CLAUDE.md` bestehen bleibt und im Modus `claude-md-and-agents-md` beide Dateien gelesen werden, prüfen Sie `/memory` (ab Version 2.1.280). Eine direkte Frage an Claude kann das direkte Laden nicht von einem Import unterscheiden.
- **Symbolischer Link von `CLAUDE.md` auf `AGENTS.md`.** Sie können ihn beibehalten: In keinem Modus kommt es zu doppeltem Lesen. Prüfen Sie vor dem Löschen des Links im Modus `claude-md-or-agents-md`, ob die benötigten Anweisungen erhalten bleiben und ob es im Arbeitsverzeichnis oder darüber keine andere `CLAUDE.md`, `.claude/CLAUDE.md` oder `CLAUDE.local.md` gibt. Prüfen Sie das Laden auf dieselbe Weise: über die Zeile `AGENTS.md loaded` beim Sitzungsstart, wenn keine blockierenden Dateien vorhanden sind, oder über `/memory` (ab 2.1.280). Wenn `CLAUDE.md` im Modus `claude-md-and-agents-md` bestehen bleibt, ist eine direkte Frage an Claude nur eine schwache Prüfung. Das Ausbleiben eines Fehlers reicht nicht als Bestätigung des Ladens.
- **Ein `SessionStart`-Hook, der den Inhalt von `AGENTS.md` manuell ausgegeben hat.** Wenn die Datei direkt gelesen wird, fügt ein solcher Hook eine zweite Kopie zum Kontext hinzu. Solange der Hook läuft, bestätigt die Frage „Was steht in deinen Anweisungen?“ kein direktes Laden: Claude kann anhand des vom Hook hinzugefügten Textes antworten. Wechseln Sie in dieser Reihenfolge:
1. Prüfen Sie, ob die Funktion verfügbar ist: Version 2.1.277 oder höher, die Sitzung erhält Feature-Flags, das Plugin ist aktiviert und die erste Sitzung nach der Installation oder Aktualisierung ist abgeschlossen. Wählen Sie einen Modus zum direkten Lesen – weder `claude-md` noch `managed-only`. Prüfen Sie beim Standardmodus außerdem, dass keine blockierenden Dateien vorhanden sind.
2. Entfernen Sie den Hook.
3. Beenden Sie die Sitzung und öffnen Sie eine neue. Der `SessionStart`-Hook fügt seinen Text beim Start hinzu, sodass der Inhalt in einer bereits geöffneten Sitzung im Kontext bleibt. Claudes Antwort auf die Frage nach dem Inhalt der Anweisungen in einer solchen Sitzung bestätigt kein direktes Laden.
4. Prüfen Sie das Laden in der neuen Sitzung. Ab Version 2.1.280 ist der Pfad zu `AGENTS.md` in `/memory` sichtbar. In den Versionen 2.1.277–2.1.279 suchen Sie, falls keine blockierenden Dateien vorhanden sind, beim Start nach der Zeile `AGENTS.md loaded`: Die Dokumentation beschreibt sie ausdrücklich für den Fall, dass keine `CLAUDE.md` gefunden wurde. Wenn Sie `CLAUDE.md` behalten und den Modus `claude-md-and-agents-md` verwenden, ist die Prüfung eingeschränkt: `/memory` zeigt `AGENTS.md` in diesen Versionen nicht an, die Dokumentation beschreibt für diesen Fall keine Ladezeile, und eine Paraphrase der Anweisungen kann direktes Lesen nicht von einem `@`-Import in `CLAUDE.md` unterscheiden. Aktualisieren Sie in diesem Fall auf 2.1.280+ und prüfen Sie `/memory`.
## So prüfen Sie, ob AGENTS.md geladen wurde
Das Wichtigste
Ab Version 2.1.280 erscheint `AGENTS.md`, das über Project instructions geladen wurde, in `/memory` und in der Liste der Memory-Dateien des Befehls `/context`. In den Versionen 2.1.277–2.1.279 erscheint es dort nicht, obwohl die Befehle selbst funktionieren und geladene `CLAUDE.md`- und andere Memory-Dateien anzeigen. Wenn in diesen Versionen keine blockierenden Dateien vorhanden sind, prüfen Sie beim Sitzungsstart, ob die Zeile `AGENTS.md loaded` erscheint. Claude nach dem Inhalt der Anweisungen zu fragen ist nur eine schwache Prüfung: Die Antwort kann direktes Lesen nicht von einem `@`-Import unterscheiden und sich auf Text stützen, den ein `SessionStart`-Hook hinzugefügt hat. Daher sollte man diese Frage nur in einer neuen Sitzung nach dem Entfernen eines solchen Hooks stellen.
Zwei weitere Unterschiede zu gewöhnlichem `CLAUDE.md`: `InstructionsLoaded`-Hooks werden für diese Art von `AGENTS.md` nicht ausgelöst (sie funktionieren für `AGENTS.md`, das per `@`-Syntax aus `CLAUDE.md` importiert oder über einen symbolischen Link von `CLAUDE.md` eingebunden wurde). Verzeichnisse, die mit dem Flag `--add-dir` zusammen mit der Variable `CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD` hinzugefügt wurden, laden nur die `CLAUDE.md` dieses Verzeichnisses – dessen `AGENTS.md` wird nicht einbezogen.
Wenn Sie den Inhalt einer umfangreichen Projektanweisungsdatei prüfen möchten, lesen Sie die separate Analyse [zur Konfiguration von CLAUDE.md ohne unnötigen Umfang](https://ailoot.ai/blog/de/claude-md-template/). Sie behandelt den Aufbau von Anweisungen; die Bedingungen für das Laden von `AGENTS.md` werden oben beschrieben. Für Arbeitsnotizen zwischen Sitzungen lesen Sie die Analyse über [ein zweites Gehirn in Claude Code](https://ailoot.ai/blog/de/claude-code-second-brain/) – über persönliches Gedächtnis zusätzlich zu Projektanweisungen.
## Wie geht es weiter?
Die Funktion wurde am 18. September 2026 mit Version 2.1.277 veröffentlicht. Anthropic könnte die Einzelheiten der Modi in künftigen Versionen präzisieren. Bevor Sie daher Einstellungen in einem wichtigen Projekt ändern, vergleichen Sie diesen Artikel mit der aktuellen `/config`-Ansicht und dem offiziellen Changelog.
### Quellen
- [Claude Code, CHANGELOG.md-Commit mit dem Eintrag zu 2.1.277 auf GitHub (18. September 2026)](https://github.com/anthropics/claude-code/commit/ca02e7deeb0707f558b0afd7e9e5d67a382e12b3)
- [Claude Code Docs: Wie Claude sich an Ihr Projekt erinnert – Abschnitt AGENTS.md](https://code.claude.com/docs/en/memory)
[Ailoot-Anleitungen](https://ailoot.ai/docs/)
[Zu Ailoot](https://ailoot.ai/)
## Fragen und Antworten
### Warum wird AGENTS.md trotz vorhandener Datei nicht geladen?
Im Standardmodus verhindert eine CLAUDE.md, .claude/CLAUDE.md oder CLAUDE.local.md im Arbeitsverzeichnis oder einem übergeordneten Verzeichnis die automatische AGENTS.md-Auswahl. Prüfe außerdem Claude-Code-Version, Funktionsverfügbarkeit und den Modus Project instructions unter /config.
### Wie prüfe ich direktes Laden nach dem Entfernen eines manuellen Hooks?
Öffne eine neue Sitzung ohne die alte SessionStart-Ausgabe. Prüfe ab 2.1.280 /memory oder die Liste Memory files unter /context. In 2.1.277–2.1.279 gilt die Startladezeile, wenn keine blockierende CLAUDE.md existiert. Claudes bloße Wiedergabe des Inhalts ist nur ein schwacher Nachweis.
## Ailoot · Das Unternehmen und sein Projektportfolio
Ailoot baut auf bewährte Betriebserfahrung, einen großen Kundenstamm, stabilen Service und kontinuierliche KPI-Kontrolle.
Das Unternehmen und sein Projektportfolio: Millionen von Kunden; monatliche Umsätze in Milliardenhöhe.
Ailoot nutzt diese Betriebserfahrung für den API-Zugang zu KI-Funktionen in Kundenprodukten, Agenten, Anwendungen und Automatisierungen.