AGENTS.mdAGENTS.md: расположение и чтение инструментами
AGENTS.md — это обычный Markdown-файл с инструкциями для проекта, который большинство coding-агентов читает без дополнительной настройки. OpenAI передала его Agentic AI Foundation при Linux Foundation; он используется более чем в 60k open-source проектах.
Расположение
- AGENTS.md в корне репозитория — для всего проекта.
- Вложенные файлы AGENTS.md в подкаталогах или пакетах: агент использует ближайший файл в дереве.
- OpenAI Codex: глобальный файл ~/.codex/AGENTS.override.md или, если он пуст или отсутствует, ~/.codex/AGENTS.md.
- Cline: глобальный файл ~/.agents/AGENTS.md.
- Claude Code также поддерживает .claude/AGENTS.md.
Формат
Обычный Markdown без frontmatter и обязательных полей; заголовки могут быть любыми. Формат не задаёт ограничений на размер, но OpenAI Codex прекращает чтение на project_doc_max_bytes — по умолчанию это 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.
Приоритет и объединение
При редактировании файла приоритет имеет ближайший к нему AGENTS.md, а явная инструкция в чате перекрывает любой файл. OpenAI Codex объединяет по одному файлу из каждого каталога, от корня проекта до рабочего каталога, поэтому более близкие файлы идут последними и имеют приоритет. Claude Code по умолчанию игнорирует AGENTS.md, если есть CLAUDE.md.
Инструменты, которые его читают
| Инструмент | Поддержка |
|---|---|
| OpenAI Codex | Поддерживается из коробки. Читает глобальный файл, затем не более одного файла на каталог от корня до рабочего каталога; по умолчанию — до 32 KiB. |
| Claude Code | Поддерживается из коробки начиная с v2.1.277, но только если нет CLAUDE.md или CLAUDE.local.md, если не задано значение claude-md-and-agents-md. |
| Cursor | Поддерживается из коробки: файлы в корне и вложенные файлы; вложенные файлы объединяются с родительскими, приоритет у более конкретных. |
| GitHub Copilot (cloud agent, code review, VS Code) | Поддерживается из коробки в любом месте репозитория; приоритет у ближайшего файла. |
| Devin Desktop (formerly Windsurf) | Поддерживается из коробки. Файл в корне используется всегда, файл в подкаталоге — только для своего каталога. |
| Cline | Поддерживается из коробки; также можно использовать глобальный файл ~/.agents/AGENTS.md. Включите или отключите поддержку на панели Rules. |
| Gemini CLI | Подключается вручную: добавьте AGENTS.md в context.fileName в .gemini/settings.json. |
| Aider | Подключается вручную: добавьте read: AGENTS.md в .aider.conf.yml. |
| OpenClaw | Поддерживается из коробки в качестве обязательного файла с инструкциями по работе в рабочей области агента. |
| Listed on agents.md (not individually re-verified) | Один из 23 инструментов в списке agents.md, включая Amp, Jules, Zed, Warp, goose, opencode и JetBrains Junie; мы не проверяли их по отдельности. |
Советы
- Переименовываете старый AGENT.md? На agents.md рекомендуют выполнить mv AGENT.md AGENTS.md && ln -s AGENTS.md AGENT.md, чтобы оба имени продолжали работать.
- Укажите команды для тестов и линтинга: агенты стараются запускать найденные проверки и исправлять ошибки до завершения работы.
- В монорепозитории добавьте короткий AGENTS.md для каждого пакета вместо того, чтобы раздувать один длинный файл в корне.
- В OpenAI Codex файл AGENTS.override.md имеет приоритет над AGENTS.md в том же каталоге.
Создайте AGENTS.md и соответствующие файлы правил для пяти инструментов с помощью одной формы. Открыть генератор AGENTS.md →