Codex und AGENTS.md: die Dateien lesen, die Codex nutzt

Codex liest Anweisungen aus Markdown-Dateien namens AGENTS.md. Wenn du darum bittest, kann es auch Pläne, Spezifikationen und Notizen als .md-Dateien in dein Projekt schreiben. Diese Seite erklärt, wo Codex nach AGENTS.md sucht und wie du alle diese Dateien bequem liest.

Wo Codex nach AGENTS.md sucht

Beim Start baut Codex eine einzige Kette von Anweisungen auf: eine globale Datei, dann Projektdateien entlang des Pfads zu deinem Arbeitsordner.

1. Deine globale Datei. Im Codex-Home-Ordner ~/.codex (oder dem Ordner, der durch CODEX_HOME gesetzt ist). Codex verwendet AGENTS.override.md, falls vorhanden, sonst AGENTS.md. Hier wird nur eine Datei verwendet.

2. Dein Projekt. Codex beginnt im Projektstamm (standardmäßig der Git-Stamm; project_root_markers kann das ändern) und geht abwärts bis zu dem Ordner, in dem du arbeitest. In jedem Ordner nimmt es höchstens eine Datei und prüft in dieser Reihenfolge:

  1. AGENTS.override.md
  2. AGENTS.md
  3. Jeden Namen, den du in project_doc_fallback_filenames aufgeführt hast

Gibt es keinen Projektstamm, prüft Codex nur den aktuellen Ordner.

Wie die Dateien zusammenwirken

Codex fügt die Dateien vom Stamm abwärts zusammen, mit Leerzeilen dazwischen. Eine Datei, die näher an deinem Arbeitsordner liegt, kommt später, sodass ihre Anweisungen vor früheren gelten. Leere Dateien werden übersprungen.

Es gibt eine Größenbegrenzung: Codex hört auf, Dateien hinzuzufügen, wenn ihre gemeinsame Größe project_doc_max_bytes erreicht, standardmäßig 32 KiB (32,768 Bytes). Wenn deine Anweisungen lang sind, erhöhe die Grenze oder teile sie auf AGENTS.md-Dateien in Unterordnern auf.

Beide Einstellungen stehen in config.toml in deinem Codex-Home-Ordner (standardmäßig ~/.codex/config.toml):

project_doc_fallback_filenames = ["TEAM_GUIDE.md"]
project_doc_max_bytes = 65536

Starte nach dem Ändern einen neuen Codex-Lauf.

Eine einfache AGENTS.md

# AGENTS.md

## Commands
- Build: `npm run build`
- Test: `npm test`

## Rules
- Write plans to `docs/plans/<task>.md` before changing code.
- Keep each change small; explain it in the pull request.

Codex speichert Pläne nicht von sich aus in Dateien. Um Pläne zu bekommen, die du später lesen kannst, bitte es, einen in eine Datei zu schreiben, in der AGENTS.md (wie die zweite Regel) oder in deinem Prompt.

Lesen, was Codex schreibt

Bei wenigen Dateien reicht jeder Editor. Bei vielen (ein Plan pro Aufgabe, Notizen, Berichte) hilft es, sie als Seiten zu lesen und zu sehen, was sich geändert hat.

Auf dem Mac, mit PilcrowMD (kostenlos, Beta):

PilcrowMD für Mac (Beta) · Mehr zum Lesen von Agentendateien

Häufige Fragen

Ist AGENTS.md nur für Codex? Nein. Es ist eine offene Konvention, die mehrere Coding-Agenten lesen, kein Format nur für Codex. Claude Code kann zum Beispiel AGENTS.md lesen, wenn ein Projekt keine CLAUDE.md hat (Seite zu Claude Code).

Warum ignoriert Codex einen Teil meiner Anweisungen? Prüfe die Größenbegrenzung (standardmäßig 32 KiB) und ob eine AGENTS.override.md im selben Ordner deine AGENTS.md ersetzt.

Kann ich diese Dateien auf meinem Smartphone lesen? Wenn der Projektordner mit Google Drive synchronisiert wird, füge ihn in PilcrowMD für Android unter „Meine Ordner“ hinzu. Öffne eine Notiz, um ihren neuesten Stand zu sehen; auf Android gibt es kein Live-Neuladen.

Auch für Mac: PilcrowMD für Mac (Beta)