AGENTS.md — Полное руководство
Совместное предложение OpenAI · Google · Cursor · Factory · совместим с CLAUDE.md · реальные примеры · На 2026-10-07 Claude Code с 2.1.277 читает AGENTS.md в проектах без 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 (проверено 2026-10-07) по умолчанию — либо/либо: без CLAUDE.md он читает AGENTS.md, а если есть оба файла — только CLAUDE.md. Cursor поддерживает AGENTS.md нативно с версии 1.2. Codex CLI сначала ищет AGENTS.md, затем переключается на instructions.md.
Текущая поддержка в инструментах
CursorCursor 1.2+: нативная поддержка, AGENTS.md имеет приоритет над .cursorrules
Claude CodeClaude Code: читает AGENTS.md нативно с 2.1.277 (выпуск 2026-09-18); в журнале изменений: «Added AGENTS.md support: in a project with no CLAUDE.md, Claude Code reads AGENTS.md instead». По умолчанию — либо/либо: если в рабочем каталоге или выше есть CLAUDE.md, читается только он; в /config через Project instructions можно включить чтение обоих. С 2.1.281 (2026-09-23) это работает и через LLM-шлюзы (проверено 2026-10-07).
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 Fable 5 · GPT-5.5 · Codex · Gemini 2.5 Pro — одна подписка, четыре инструмента
Создать аккаунт QCode
Один ключ для Claude, GPT и китайских моделей, оплата по токенам — актуальные цены на /models.