--- title: "AGENTS.md in Claude Code und Codex nutzen" description: "Codex liest AGENTS.md standardmäßig. Claude Code ab 2.1.277 liest die Datei, wenn dein Projekt keine CLAUDE.md hat. Willst du beide behalten, schreib @AGENTS.md in deine CLAUDE.md." canonical: "https://logbrew.co/de/guides/agents-md" last_updated: "2026-11-10" --- # AGENTS.md in Claude Code und Codex nutzen Codex liest `AGENTS.md` standardmäßig. Claude Code ab 2.1.277 liest die Datei, wenn dein Projekt keine `CLAUDE.md` hat. Willst du beide behalten, schreib `@AGENTS.md` in deine `CLAUDE.md`. Getestet am 10. November 2026 mit Claude Code 2.1.319 und Codex CLI 0.167.0 Von [Furkan Erday](https://github.com/furkanerday). Furkan Erday hat LogBrew gegründet. Er entwickelt LogBrew jeden Tag mit Claude Code und Codex. Canonical: https://logbrew.co/de/guides/agents-md ## Wann welcher Agent `AGENTS.md` lädt | Dein Projekt enthält | Claude Code | Codex | | --- | --- | --- | | Nur `AGENTS.md` | Geladen | Geladen | | `AGENTS.md` und `CLAUDE.md` | Weggelassen | Geladen | | Eine `CLAUDE.md`, die `@AGENTS.md` importiert | Geladen | Geladen | | Eine `CLAUDE.md` als Symlink auf `AGENTS.md` | Geladen | Geladen | | `AGENTS.md` und `CLAUDE.local.md` | Weggelassen | Geladen | Wir haben die Anweisungen gelesen, die jeder Agent mit seiner ersten Anfrage geschickt hat. ## 1 Datei für beide Agenten einrichten ### AGENTS.md im Stammverzeichnis anlegen Schreib deine Build-Befehle, Test-Befehle und Code-Regeln in 1 Datei. Beide Agenten lesen sie vom Stammverzeichnis deines Git-Repositorys bis zu deinem aktuellen Ordner. ### Claude Code aktualisieren Ab Version 2.1.277 liest Claude Code `AGENTS.md` selbst. Ältere Versionen brauchen den Import aus dem nächsten Schritt. ```bash claude update ``` ### AGENTS.md aus deiner CLAUDE.md importieren Eine `CLAUDE.md`, `.claude/CLAUDE.md` oder `CLAUDE.local.md` in deinem Ordner oder darüber hält Claude Code davon ab, `AGENTS.md` zu lesen. Füge diese Zeile in deine `CLAUDE.md` ein, um beide zu laden. ```bash @AGENTS.md ``` ### Oder CLAUDE.md auf AGENTS.md verlinken Enthielte deine `CLAUDE.md` nur den Import, mach sie stattdessen zu einem Symlink. ```bash ln -s AGENTS.md CLAUDE.md ``` ### Oder beide per Einstellung laden Um eine `CLAUDE.local.md` zu behalten und trotzdem `AGENTS.md` zu laden, füge das hier in `~/.claude/settings.json` ein. In einer Sitzung setzt die Option für Projektanweisungen in `/config` denselben Wert. ```bash { "pluginConfigs": { "cc-plugin-agents-md@builtin": { "options": { "instructionFiles": "claude-md-and-agents-md" } } } } ``` ### Prüfen, was Codex geladen hat Führe das in dem Ordner aus, in dem du arbeitest. Die Codex-Doku nennt diesen Befehl, damit Codex die geladenen Anweisungen wiedergibt. ```bash codex --ask-for-approval never "Summarize the current instructions." ``` ## Was wir beim Testen gesehen haben Wir haben beide Agenten auf einen lokalen Testserver gerichtet und die Anweisungen gelesen, die jeder mit seiner ersten Anfrage geschickt hat. So sieht man genau, welche Dateien jeder Agent lädt. Claude Code lud `AGENTS.md`, wenn das Projekt keine `CLAUDE.md` hatte, und das Debug-Log meldete `no CLAUDE.md found; AGENTS.md loaded`. Lag eine `CLAUDE.md` daneben, ließ Claude Code `AGENTS.md` weg. Mit dem Import `@AGENTS.md` oder dem Symlink erschien der Text aus `AGENTS.md` genau einmal. Die Einstellung `pluginConfigs` von oben lud beide Dateien, auch mit einer `CLAUDE.local.md` im Projekt. Codex lud zuerst `~/.codex/AGENTS.md`, dann die `AGENTS.md` im Stammverzeichnis und dann die Datei im aktuellen Ordner. Eine `AGENTS.override.md` ersetzte die `AGENTS.md` in ihrem Ordner. Eine `CLAUDE.md` übersprang Codex, bis wir sie zu `project_doc_fallback_filenames` hinzufügten. Gab es beide Dateien, lud Codex nur `AGENTS.md`, auch mit gesetztem Fallback. ## AGENTS.md vs. CLAUDE.md Codex liest in jedem Ordner `AGENTS.override.md` oder `AGENTS.md` sowie die globale `~/.codex/AGENTS.md`, standardmäßig insgesamt bis zu 32 KiB. `CLAUDE.md` liest es nur, wenn du die Datei in `project_doc_fallback_filenames` aufführst. Claude Code liest zuerst `CLAUDE.md`. `AGENTS.md` und `.claude/AGENTS.md` liest es nur, wenn keine `CLAUDE.md` des Projekts greift. Deine persönliche `~/.claude/CLAUDE.md` zählt dabei nicht und wird deshalb neben `AGENTS.md` geladen. ## Was die GitHub-Issues sagen In #6235 mit 409 Kommentaren wünschten sich Nutzer AGENTS.md-Support in Claude Code. Am 17. August 2026 schloss ein Anthropic-Engineer das Issue mit dem Import und dem Symlink von oben. Inzwischen liest Claude Code die Datei selbst. #31005 wünscht zusätzlich Support für `.agents/skills/` und ist noch offen. ## Häufige Fragen ### Liest Claude Code AGENTS.md? Ja, ab Version 2.1.277, wenn in deinem Ordner oder darüber keine `CLAUDE.md`, `.claude/CLAUDE.md` oder `CLAUDE.local.md` liegt. Wir haben das mit 2.1.319 bestätigt. ### Soll ich AGENTS.md oder CLAUDE.md nutzen? Nutze `AGENTS.md`, wenn jemand in deinem Team Codex oder einen anderen Agenten nutzt. Behalte eine `CLAUDE.md` nur für Regeln, die allein für Claude Code gelten, und importiere darin `@AGENTS.md`. ### Kann ich CLAUDE.md als Symlink auf AGENTS.md anlegen? Ja. In unserem Test lud Claude Code die verlinkte Datei einmal, genau wie beim Import. ### Liest Codex CLAUDE.md? Standardmäßig nicht. Füge `project_doc_fallback_filenames = ["CLAUDE.md"]` in `~/.codex/config.toml` ein. ## Gib deinem Agenten deine Produktionsfehler Verbinde den LogBrew-MCP-Server, und Claude Code oder Codex liest die Fehler, Logs und Traces der Projekte, die du freigibst. Starte mit dem großzügigen kostenlosen Plan, ohne Kreditkarte. [Agenten verbinden](https://logbrew.co/de/agents) ## Quellen - [Claude Code docs, How Claude remembers your project](https://code.claude.com/docs/en/memory#agents-md) - [Codex docs, Custom instructions with AGENTS.md](https://learn.chatgpt.com/docs/agent-configuration/agents-md) - [anthropics/claude-code#6235](https://github.com/anthropics/claude-code/issues/6235) - [anthropics/claude-code#31005](https://github.com/anthropics/claude-code/issues/31005) ## Weitere Anleitungen für KI-Coding-Agenten - [MCP-Server in Claude Code und Codex hinzufügen](https://logbrew.co/de/guides/mcp-server-claude-code-codex) - [Claude-Fehler 529 overloaded und 429 Rate Limit beheben](https://logbrew.co/de/guides/claude-overloaded-rate-limit-error) - [Fehler beheben in Claude Code, Codex und Browser-JavaScript](https://logbrew.co/de/guides)