AGENTS.md — правила и память Codex

У Claude Code есть свой вводный файл, который агент читает перед работой, — CLAUDE.md. У Codex — ровно та же идея, только файл называется AGENTS.md. Это обычный markdown в корне проекта: открыл сессию — Codex сразу знает, кто ты, как ты работаешь, какие в проекте порядки и что трогать нельзя. Пишешь один раз человеческим языком — и перестаёшь объяснять одно и то же каждое утро. В этом гайде разберём, что класть в AGENTS.md, чем он отличается от CLAUDE.md и почему навык из одного файла переносится в другой.

Короткий ответ

AGENTS.md — обычный markdown-файл в корне проекта, который Codex подгружает первым при старте каждой сессии. Формат свободный: нет жёсткой схемы и обязательных заголовков, ты просто пишешь человеческим языком — кто ты, как с тобой общаться, как устроен проект и что нельзя ломать.

# AGENTS.md

Меня зовут Алексей, обращайся на «ты», без эмодзи.
Бэкенд на Python, тесты гоняй через `pytest`.
В папку legacy не лезь без спроса.

Положил файл в корень, Codex прочитал его на старте — и дальше работает по твоим правилам, а не по догадкам.

Что это и зачем

У любого агента есть «главный промпт» — файл, который он читает первым, ещё до того как возьмётся за задачу. Для Codex это и есть AGENTS.md. Каждая новая сессия стартует с чистой памятью: вчерашний разговор про стек, про порядки в проекте, про запретные зоны агент не помнит. AGENTS.md — это инструктаж, который восстанавливает весь этот контекст автоматически, в начале каждой сессии.

Внутри — простой человеческий текст, никакой магии и хитрого синтаксиса. Ты описываешь то, что иначе пришлось бы проговаривать заново каждый раз: кто ты, как устроен проект, какие команды, какие границы. Codex читает это на старте и держит как постоянную память, пока работает внутри проекта. Записал правило один раз — оно действует во всех будущих сессиях.

Ключевая мысль: AGENTS.md — это markdown-файл с инструктажем для агента. Всё, что ты устал повторять из сессии в сессию, выносится сюда один раз и перестаёт быть твоей заботой.

AGENTS.md и CLAUDE.md — в чём разница

Если ты уже читал гайд про CLAUDE.md, то понял главное: это один и тот же приём, просто у разных инструментов файл называется по-своему. У каждого агента есть свой «главный промпт», который он читает первым. У Claude Code это CLAUDE.md, у Codex — AGENTS.md. Разница не в идее, а в названии и в том, кто за файлом стоит.

CLAUDE.md — файл Claude Code, это формат Anthropic: его читает конкретно их инструмент. AGENTS.md устроен иначе — это открытый стандарт, не привязанный к одному вендору. Он задуман как общий: один и тот же AGENTS.md в корне проекта читают многие агенты и редакторы — Codex, Cursor, GitHub Copilot, Gemini CLI, Zed и другие, а не только Codex. Смысл один — единый файл с инструкциями в корне репозитория, — но AGENTS.md претендует на роль межинструментального стандарта, тогда как CLAUDE.md остаётся «родным» файлом одной экосистемы.

Для тебя это означает приятную вещь: навык переносится. Научился толково писать CLAUDE.md — считай, умеешь писать и AGENTS.md, и наоборот. Меняется имя файла, а не подход. Подробный разбор, что и как писать в такой файл, — в соседнем гайде про CLAUDE.md; всё оттуда применимо и здесь.

Названия разные, суть одна. Как только ты понял принцип «у агента есть файл, который он читает первым», ты ориентируешься в любом из них.

Что писать внутри

Схема свободная — это важно понять сразу. У AGENTS.md нет обязательных заголовков, нет спецификации, которую надо соблюсти. Ты пишешь обычный markdown обычными словами, а структуру задаёшь как удобно. Чаще всего в файле держат несколько смысловых блоков:

• Кто ты. Имя, как к тебе обращаться, чего ты владелец. Это личная часть — про тебя, а не про проект.
• Стиль общения. Как агенту с тобой разговаривать: «без эмодзи», «объясняй как пятилетнему», «коротко и по делу», на каком языке отвечать.
• Конвенции и стандарты проекта. Стек, технологии, правила именования, стиль кода и коммитов — как принято делать в этом репозитории.
• Сборка и тесты. Чем собирать, какой командой гонять тесты, как запускать проект. Самое ценное — агент перестаёт угадывать твои команды.
• Границы. Что нельзя трогать, куда не лезть, какие действия под запретом без явного разрешения.

Первый блок — личный, про тебя. Всё остальное — переиспользуемые стандарты проекта, которые одинаково полезны любому, кто (или что) работает с этим кодом. Пример нескольких строк живого AGENTS.md, написанного простым языком:

# AGENTS.md

## Про меня
Алексей, обращайся на «ты», без корпоративной вежливости и эмодзи.
Сначала код и факты, объяснения — после.

## Проект
Бэкенд на Python 3.12, менеджер пакетов — uv.
Сборка: `uv sync`. Тесты: `pytest -q`.
Коммиты по-русски, в стиле «Починил X».

## Границы
В main напрямую не пушить — только через PR.
Папку legacy не трогать без явного разрешения.

Это не спецификация и не обязательный шаблон — просто иллюстрация. Заголовки, порядок, объём выбираешь сам под свой проект. Главное — писать конкретно: «функции короче 40 строк» агент выполнит, «пиши хороший код» проигнорирует, потому что не поймёт, что от него хотят.

Совет: держи личную часть под себя, а стандарты проекта — переиспользуй. Личный блок (кто ты, как общаться) едет с тобой из проекта в проект, а блоки про стек, команды и границы — общие для всей команды и живут в репозитории. И помни: навык один на все инструменты — то, что ты научился формулировать в AGENTS.md, ложится в CLAUDE.md и SOUL.md почти без изменений. Меняется имя файла, не подход.

Итог

AGENTS.md — обычный markdown-файл в корне проекта, который Codex читает первым в каждой сессии. Формат свободный, без жёсткой схемы: пишешь человеческим языком, кто ты, как с тобой работать, какие в проекте порядки и что трогать нельзя. Это открытый стандарт — тот же файл понимают разные агентские инструменты, — а идея один в один как у CLAUDE.md в Claude Code и SOUL.md в других агентах. Научился писать один — умеешь все: меняется название, не подход. Держи личную часть при себе, стандарты проекта переиспользуй, формулируй правила коротко и конкретно.

Файл-инструктаж есть у каждого агента — а самый автономный из них живёт не на ноутбуке, который ты закрываешь на ночь, а на сервере, работающем 24/7. Про то, как поднять агента на своём сервере, — в следующей части.

FAQ

Чем AGENTS.md отличается от CLAUDE.md?

Это один и тот же приём — главный файл, который агент читает первым. CLAUDE.md — формат Anthropic для Claude Code, а AGENTS.md устроен как открытый стандарт: один файл в корне читают разные инструменты — Codex, Cursor, GitHub Copilot, Gemini CLI, Zed. Меняется имя файла, не подход.

Где должен лежать файл AGENTS.md?

В корне проекта. Codex подгружает его первым при старте каждой сессии и дальше работает по твоим правилам, а не по догадкам.

Что писать внутри AGENTS.md?

Свободный markdown без обязательной схемы: кто ты и как обращаться, стиль общения, конвенции проекта (стек, именование, коммиты), команды сборки и тестов, границы — что нельзя трогать. Правила формулируй конкретно: «функции короче 40 строк» агент выполнит, «пиши хороший код» проигнорирует.