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:
AGENTS.override.mdAGENTS.md- Jeden Namen, den du in
project_doc_fallback_filenamesaufgefü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):
- Füge deinen Projektordner hinzu unter Meine Ordner. Dateien, die Codex schreibt, erscheinen mit N (neu) oder U (aktualisiert) markiert. Eine geöffnete Notiz wird neu geladen, wenn Codex oder eine andere App sie ändert.
- Änderungen hervorheben zeigt, was Codex in einem Plan geändert hat, den du schon gelesen hast: blau für hinzugefügt, orange für entfernt oder bearbeitet.
- Nebeneinander vergleichen zeigt zwei Versionen, als Seite oder als Quelltext.
- Bei eingeschaltetem Dateiverlauf kannst du mit Ablage › Verlauf anzeigen … zu einer früheren Version zurückgehen.
- Tabellen, Codeblöcke, Aufgabenlisten und Mermaid-Diagramme werden als Seite gezeichnet. Keine Internetverbindung.
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)