AGENTS.md — Полное руководство
Совместное предложение OpenAI · Google · Cursor · Factory · совместим с CLAUDE.md · реальные примеры
Зачем нужен AGENTS.md
В первой половине 2025 г. каждый инструмент AI-кодинга использовал свой формат файла памяти проекта — Cursor применял .cursorrules, Claude Code — CLAUDE.md, Codex — instructions.md, Aider — .aider.conf.yml. Переход с одного инструмента на другой означал переписывание знаний о проекте. В августе 2025 г. команды OpenAI, Google, Cursor, Factory совместно выпустили стандарт AGENTS.md, позволяющий одному конфигурационному файлу работать с любым совместимым агентом.
Пять основных секций спецификации
AGENTS.md определяет пять стандартизованных секций, разделённых заголовками Markdown H2, совместимых со всеми редакторами Markdown:
Identity: идентичность агента, роль, язык ответа
Capabilities: декларация возможностей, предпочтения по инструментам, версии модели
Tools: список доступных инструментов, объём прав, конфигурация внешних API
Memory: контекст проекта, соглашения, глоссарий, прошлые решения
Constraints: запрещённые действия, правила безопасности, требования по соответствию
Совместимость с CLAUDE.md и .cursorrules
AGENTS.md не заменяет существующие форматы — это наибольший общий знаменатель между инструментами. Команда Claude Code объявила приоритет AGENTS.md при сохранении CLAUDE.md как Claude-специфичного слоя расширений. Cursor поддерживает AGENTS.md нативно с версии 1.2. Codex CLI сначала ищет AGENTS.md, затем переключается на instructions.md.
Текущая поддержка в инструментах
CursorCursor 1.2+: нативная поддержка, AGENTS.md имеет приоритет над .cursorrules
Claude CodeClaude Code: распознаёт оба файла; специфичные для проекта инструкции — в CLAUDE.md
Codex CLICodex CLI: с 2026-02 ищет AGENTS.md по умолчанию для всех инструментов OpenAI
AiderAider: экспериментальная поддержка с 0.65, включается флагом --agents-md
Пять распространённых антипаттернов
1) Сваливание всех исторических решений в Memory до раздувания файла свыше 10 КБ; 2) Identity как маркетинговый текст вместо исполняемых директив; 3) Constraints с абстрактными принципами без конкретных запретов; 4) Устаревший список Tools, который никто не чистил; 5) Смешение с .gitignore — AGENTS.md должен быть в системе контроля версий и доступен команде.
Как запускать Claude Code с AGENTS.md из сетей с ограничениями
Частый вопрос: «Я разработчик в материковом Китае, и Claude Code постоянно отваливается по таймауту на моём проекте с AGENTS.md — что делать?» Это вопрос сетевой доступности, не связанный с самой спецификацией. Варианты: подписаться напрямую у Anthropic (подходит для стабильной зарубежной сети); использовать брендированный сервис подписки API (например QCode.cc, оптимизированный доступ из Китая + единый биллинг + один ключ к четырём моделям); построить собственный корпоративный шлюз (длительный цикл разработки).
Запустите свой первый AGENTS.md проект на QCode.cc
Claude Opus 4.7 · GPT-5.5 · Codex · Gemini 2.5 Pro — одна подписка, четыре инструмента