AGENTS.mdAGENTS.md: Speicherort und Verwendung durch Tools
AGENTS.md ist eine einfache Markdown-Datei mit Projektanweisungen, die die meisten Coding-Agents ohne zusätzliche Einrichtung lesen. OpenAI hat die Datei der Agentic AI Foundation unter dem Dach der Linux Foundation übergeben. Über 60.000 Open-Source-Projekte verwenden sie.
Speicherort
- AGENTS.md im Repository-Stammverzeichnis gilt für das gesamte Projekt.
- Verschachtelte AGENTS.md-Dateien in Unterverzeichnissen oder Paketen; Agents verwenden die Datei, die sich im Verzeichnisbaum am nächsten befindet.
- OpenAI Codex: eine globale ~/.codex/AGENTS.override.md oder, falls diese leer ist oder fehlt, ~/.codex/AGENTS.md.
- Cline: eine globale ~/.agents/AGENTS.md.
- Claude Code unterstützt auch .claude/AGENTS.md.
Format
Einfaches Markdown ohne Frontmatter oder Pflichtfelder; Überschriften sind frei wählbar. Das Format legt keine Größenbegrenzung fest, aber OpenAI Codex beendet das Lesen bei project_doc_max_bytes, standardmäßig 32 KiB.
# Acme web app
Customer-facing web app with an admin area and a REST API.
## Commands
- Install: `pnpm install`
- Test: `pnpm test`
- Lint and type-check: `pnpm lint && pnpm tsc --noEmit`
## Code style
- TypeScript strict mode; no `any` in new code.
- Keep database access in `src/db/`.
## Never
- Never commit secrets or .env files.
- Never edit files under `src/generated/` by hand.
Priorität und Zusammenführung
Die AGENTS.md, die der bearbeiteten Datei am nächsten liegt, hat Vorrang. Eine ausdrückliche Anweisung im Chat überschreibt jede Datei. OpenAI Codex hängt ausgehend vom Projektstammverzeichnis jeweils eine Datei pro Verzeichnis bis zum Arbeitsverzeichnis aneinander. Dateien aus näher gelegenen Verzeichnissen stehen also weiter unten und haben Vorrang. Claude Code überspringt AGENTS.md standardmäßig, wenn eine CLAUDE.md vorhanden ist.
Tools, die die Datei lesen
| Tool | Unterstützung |
|---|---|
| OpenAI Codex | Nativ. Liest eine globale Datei und anschließend standardmäßig bis zu 32 KiB aus höchstens einer Datei pro Verzeichnis, vom Stammverzeichnis bis zum Arbeitsverzeichnis. |
| Claude Code | Ab v2.1.277 nativ, aber nur, wenn keine CLAUDE.md oder CLAUDE.local.md vorhanden ist – es sei denn, claude-md-and-agents-md ist eingestellt. |
| Cursor | Nativ, im Stammverzeichnis und in Unterverzeichnissen. Verschachtelte Dateien werden mit den übergeordneten Dateien kombiniert; die spezifischere Datei hat Vorrang. |
| GitHub Copilot (cloud agent, code review, VS Code) | Nativ, an beliebiger Stelle im Repository. Die nächstgelegene Datei hat Vorrang. |
| Devin Desktop (formerly Windsurf) | Nativ. Die Datei im Stammverzeichnis gilt immer; eine Datei in einem Unterverzeichnis gilt für das jeweilige Verzeichnis. |
| Cline | Nativ, außerdem mit einer globalen ~/.agents/AGENTS.md. Im Rules-Bereich lässt sich die Funktion ein- oder ausschalten. |
| Gemini CLI | Optional: Füge AGENTS.md zu context.fileName in .gemini/settings.json hinzu. |
| Aider | Optional: Füge read: AGENTS.md zu .aider.conf.yml hinzu. |
| OpenClaw | Nativ, als erforderliche Datei mit Betriebsanweisungen im Agent-Arbeitsbereich. |
| Listed on agents.md (not individually re-verified) | Eines von 23 Tools in der agents.md-Liste, darunter Amp, Jules, Zed, Warp, goose, opencode und JetBrains Junie. Wir haben diese Tools nicht einzeln überprüft. |
Tipps
- Benennt ihr eine ältere AGENT.md um? agents.md empfiehlt mv AGENT.md AGENTS.md && ln -s AGENTS.md AGENT.md, damit beide Namen weiterhin funktionieren.
- Führe Test- und Lint-Befehle auf: Agents versuchen, die gefundenen Prüfungen auszuführen und Fehler zu beheben, bevor sie fertig sind.
- Lege in einem Monorepo für jedes Paket eine kurze AGENTS.md an, statt die Datei im Stammverzeichnis immer weiter auszubauen.
- In OpenAI Codex hat AGENTS.override.md im selben Verzeichnis Vorrang vor AGENTS.md.
Erstellen Sie aus einem Formular eine AGENTS.md und passende Regeldateien für fünf Tools. AGENTS.md-Generator öffnen →