Claude Code liest jetzt AGENTS.md: Was sich in 2.1.277 geändert hat

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.

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.

Was hat sich bei AGENTS.md in Claude Code 2.1.277 geändert?#

Im offiziellen CHANGELOG.md des Claude-Code-Projekts auf GitHub steht es so:

Ü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?#

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.

4 Modi für Project instructions – welchen soll man auswählen?#

Das Verhalten der Modi in der Tabelle ist in der Dokumentation von Anthropic beschrieben. Die rechte Spalte enthält Empfehlungen zur Auswahl:

Sie können den Modus auch ohne die Benutzeroberfläche über settings.json auswählen:

{
  "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, wie der @-Import funktioniert. Diese Methode funktioniert weiterhin.

Warum fehlt Project instructions in /config?#

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?#

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#

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. 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 – ü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.