# AGENTS.md в 2026: 3 раздела правил для Claude Code и Codex > AGENTS.md хранит постоянные правила проекта для coding agent. Здесь показано, как подключить один файл к Codex и Claude Code. Источник: https://vibeceh.ru/guides/agents-md-odin-fajl-pravil Автор: Сергей Мазур · опубликовано 2026-08-02 Запрос `agents md` обычно появляется после первой поломки: агент переписал рабочий файл, запустил не ту команду или снова нарушил правило. `AGENTS.md` собирает постоянные инструкции проекта в одном Markdown-файле, чтобы Codex и Claude Code получали общий контекст. ## Что такое AGENTS.md и зачем он нужен `AGENTS.md` - обычный Markdown-файл с постоянными правилами проекта. В нём хранят команды, соглашения, структуру каталогов и правила поведения агента. Файл лежит в корне проекта, пишется на Markdown и подхватывается coding agent при старте сессии - правила не нужно повторять в каждом чате. Если каждый раз писать в чате «сначала посмотри существующие файлы», «не трогай `.env`» и «после изменений запусти тесты», правила быстро теряются. Файл остаётся рядом с кодом. ИИ-агент получает его как часть [контекста](/concepts/kontekst) проекта. Поддерживаемый практический формат - обычный Markdown. Отдельный сервис, специальный редактор и сложная схема конфигурации не нужны. Подойдут заголовки, обычный текст и списки. Идея простая: - `AGENTS.md` содержит общие правила; - разные coding agent используют один источник инструкций; - инструмент получает сведения о командах и устройстве проекта до выполнения задачи. CLAUDE.md files are markdown files that give Claude persistent instructions. Файл задаёт агенту рабочий контекст. Ошибки и отдельные строки он сам не исправляет и не проверяет. Повторяющееся объяснение исчезает, а исходные рамки работы заданы заранее. Подробнее о формате CLAUDE.md и его поиске по дереву каталогов читайте в статье [CLAUDE.md больше 200 строк в 2026: удалить и пересобрать](/guides/claude-md-udalit-ili-perepisat). ## Где лежит файл AGENTS.md и что в нём хранится начни с корня проекта, рядом с основными файлами и каталогами. Внутри используй заголовки и списки для команд, стиля, структуры и рабочего процесса. Для первого варианта хватит разделов с командами, стилем, структурой каталогов, правилами поведения и проверками после изменений. Не превращай файл в энциклопедию - только то, что относится к большинству задач. В корне файл проще заметить и подключить к инструментам. Для первого варианта хватит нескольких разделов: - команды установки, запуска, тестирования и сборки; - соглашения по стилю; - основные каталоги проекта; - правила поведения агента; - проверки после изменений. Пример структуры: ```md # Правила проекта ## Команды - Установка: `npm install` - Запуск: `npm run dev` - Тесты: `npm test` - Сборка: `npm run build` ## Стиль - Сначала изучай существующие файлы. - Не создавай новую библиотеку без согласия. ## Структура - `src/` - исходный код. - `tests/` - тесты. ## После изменений - Запусти тесты. - Проверь сборку. ``` Заголовки помогают сгруппировать связанные инструкции. Списки делают отдельные требования заметными. Такая форма рекомендована для файлов с постоянными правилами. Не превращай `AGENTS.md` в энциклопедию проекта. Нерелевантный текст становится шумом в контексте. Для `CLAUDE.md` документация Claude Code рекомендует держать файл меньше 200 строк. Для `AGENTS.md` в документации нет отдельного подтверждённого ограничения, поэтому не переноси это число на Codex как спецификацию. `AGENTS.md` остаётся текстовым контекстом и не заменяет систему исполнения. Строка «всегда запускай тесты» не гарантирует запуск сама по себе. Если правило важно для каждой задачи, вынеси его в короткий список с конкретным действием. Для обязательного контроля добавь тест, линтер, hook или Git hook. ## Пример готового файла AGENTS.md возьми короткую заготовку, замени команды на команды конкретного проекта и оставь только правила, которые относятся почти к каждой задаче. Замени команды `npm` на команды своего проекта, оставь правила «не трогай `.env`» и «сначала изучи существующие файлы», если они подходят твоему процессу, и убери лишнее - файл должен оставаться коротким. В официальном минимальном примере используются раздел `Dev environment tips`, команда `pnpm test` и требование обновлять тесты. Для другого проекта команды надо заменить. Саму логику можно сохранить. Ниже вариант для проекта с `npm`: ```md # Правила проекта ## Команды - Для установки используй `npm install`. - Для запуска используй `npm run dev`. - Для тестов используй `npm test`. - Для сборки используй `npm run build`. ## Стиль - Сначала изучи существующие файлы, потом редактируй. - Не создавай новые библиотеки без моего согласия. - Не трогай `.env`. ## Как работать - Перед изменением найди связанные файлы. - Делай небольшие изменения. - Не переписывай рабочий код без причины. ## Что проверить после изменений - Запусти `npm test`. - Запусти `npm run build`. - Обнови тесты, если поведение изменилось. ``` Строки с `npm` - шаблон. Замени их командами конкретного проекта. Если проект запускается через `pnpm`, в файл должны попасть команды `pnpm`. При отсутствии отдельной сборки не добавляй выдуманную команду. Правила «не трогай `.env`» и «сначала изучи существующие файлы» можно оставить, если они подходят рабочему процессу. Формулировки «делай небольшие изменения» и «не переписывай рабочий код без причины» задают направление, но не создают технический запрет. Для контроля нужны внешние проверки. Готовый промпт поможет проверить, понял ли [ИИ-агент](/concepts/agent) файл: Теперь можно перейти от текста к практике: создать два файла, запустить инструмент из правильной папки и проверить новую сессию. Именно так быстрее увидеть, где правило работает, а где остаётся только подсказкой. ## Как подключить AGENTS.md к Claude Code и Codex по шагам сначала создай общий `AGENTS.md` в корне проекта. Затем добавь `CLAUDE.md` со строкой `@AGENTS.md`, запусти Claude Code или Codex из этой папки и проверь результат в новой сессии. После создания файлов заверши активную сессию и открой новую из корня проекта - только тогда агент подхватит свежие инструкции. ![Кот изучает схему подключения AGENTS.md и CLAUDE.md по трём шагам.](https://s3.regru.cloud/crossmark/statejnik/images/guides/agents-md-odin-fajl-pravil/kadr-1.webp) Перейди в каталог репозитория. Проверь, что это нужная папка, а внутри нет случайного `.git` в подкаталоге. Добавь в корень файл `AGENTS.md`. Запиши команды, структуру каталогов и постоянные правила поведения. ```md # Правила проекта ## Команды - Для установки используй `npm install`. - Для запуска используй `npm run dev`. - После изменений запускай `npm test`. ## Стиль - Не трогай `.env`. - Сначала изучи существующие файлы, потом редактируй. ``` В той же папке создай `CLAUDE.md`. Оставь в нём импорт общего файла. ```md @AGENTS.md ``` Если отдельное правило относится только к Claude Code, напиши его ниже импорта. ```md @AGENTS.md ## Claude Code - Перед изменениями кратко перечисли файлы, которые собираешься затронуть. ``` Открой Claude Code или Codex в каталоге, где лежат `AGENTS.md` и `CLAUDE.md`. Не начинай настройку из `src/` или другого подкаталога. Заверши активную сессию и запусти новую после создания или изменения файлов. Только новая сессия должна использовать свежий текст правил. Дай задачу без изменения файлов и попроси перечислить команды, ограничения и проверки из `AGENTS.md`. Для Codex не считай отсутствие глобального файла в `/status` доказательством, что инструкции не загрузились. ## Как Claude Code читает правила из AGENTS.md чтобы Claude Code получил правила из `AGENTS.md`, добавь в `CLAUDE.md` строку `@AGENTS.md`. Одного файла `AGENTS.md` недостаточно - нужна связка из двух файлов, где `CLAUDE.md` содержит импорт общего файла и может включать дополнения только для Claude Code. Документация Claude Code формулирует это прямо: Claude Code читает `CLAUDE.md`, а не `AGENTS.md`. Поэтому одного файла `AGENTS.md` для Claude Code недостаточно. Нужна связка: ```text AGENTS.md # общие правила проекта CLAUDE.md # импорт общего файла ``` В `CLAUDE.md` импорт выглядит так: ```md @AGENTS.md ``` `@AGENTS.md` - специальный импорт. Обычная Markdown-ссылка на файл лишь открывает его для чтения человеком: ```md [Правила проекта](AGENTS.md) ``` Такая строка выглядит как ссылка для чтения человеком. Она не подключает содержимое к контексту Claude Code тем способом, который нужен для общих инструкций. После импорта можно добавить правила только для Claude Code: ```md @AGENTS.md ## Только для Claude Code - Перед редактированием перечисли план действий. ``` Подробнее о поиске `CLAUDE.md` по дереву каталогов и формате файла читайте в статье [CLAUDE.md больше 200 строк в 2026: удалить и пересобрать](/guides/claude-md-udalit-ili-perepisat). Для этой статьи важно: `AGENTS.md` без импорта в `CLAUDE.md` не попадает в контекст Claude Code. Держи правила проекта в `AGENTS.md`, а в `CLAUDE.md` оставь `@AGENTS.md` и короткие дополнения только для Claude Code. Две независимые версии быстро расходятся. ## Как Codex читает правила из AGENTS.md для Codex `AGENTS.md` - штатный файл инструкций. Codex учитывает проектные правила и ищет корень по ближайшему каталогу с `.git`. Для первой настройки держи `AGENTS.md` в корне репозитория и запускай Codex из этой же директории. Глобальные инструкции зависят от значения `CODEX_HOME` и могут лежать в отдельном каталоге. Claude Code получает инструкции через `CLAUDE.md`. Codex использует имя `AGENTS.md` как основной способ передать инструкции проекту. Для первой настройки держи `AGENTS.md` в корне репозитория. Запускай Codex из этой же директории. Если внутри проекта случайно оказался отдельный `.git`, ближайшая папка с ним может быть принята за корень. Тогда выше этого места Codex уже не ищет. Глобальные инструкции зависят от фактического значения `CODEX_HOME`. Глобальный файл может лежать по одному из путей: ```text $CODEX_HOME/AGENTS.md $CODEX_HOME/AGENTS.override.md ``` Если `CODEX_HOME` указывает не на `~/.codex`, проверка только `~/.codex/AGENTS.md` не даст правильного ответа. Порядок для Codex выглядит так: 1. Уточни, какая папка указана в `CODEX_HOME`. 2. Проверь глобальный `AGENTS.md` или `AGENTS.override.md` в этой папке. 3. Проверь проектный файл в корне. 4. Запусти Codex из каталога проекта. 5. Отдельно проверь, какой текст попал в текущую сессию. Команда `/status` не всегда показывает глобальный `AGENTS.md`. Она может показать только проектный файл. Поэтому надпись без глобального файла не доказывает, что глобальные инструкции не применились. Точные каталоги поиска проектных файлов и полный алгоритм наследования `AGENTS.md` в открытых источниках не подтверждены. Не воспринимай неподтверждённую схему как спецификацию Codex. ## Сравнение Claude Code и Codex Claude Code читает CLAUDE.md, Codex читает AGENTS.md штатно. Таблица ниже собирает ключевые различия в одном месте. | Что | Claude Code | Codex | |-----|------------|-------| | Файл инструкций | CLAUDE.md | AGENTS.md | | Импорт AGENTS.md | Через @AGENTS.md в CLAUDE.md | Штатно, без импорта | | Поиск корня | От текущего каталога вверх | По ближайшему .git | | Глобальные инструкции | Не предусмотрены | Через CODEX_HOME | ## Почему агент не соблюдает правила из AGENTS.md `AGENTS.md` передаёт модели текстовый контекст, но не исполняет требования как код. Агент может пропустить длинное, расплывчатое или конфликтующее правило. Основные причины: слишком большой файл с нерелевантными инструкциями, расплывчатые формулировки без точных действий, конфликт между разными файлами правил и ожидание, что текстовая инструкция сработает как жёсткий запрет. ![Мужчина закрывает лицо перед схемой причин, по которым агент нарушает правила.](https://s3.regru.cloud/crossmark/statejnik/images/guides/agents-md-odin-fajl-pravil/kadr-2.webp) Первая причина - слишком большой файл. Нерелевантные инструкции увеличивают шум в контексте. Правило про frontend не помогает задаче, где меняется только серверная часть. Для локальных требований подходят path-scoped rules. Вторая причина - расплывчатая формулировка. «Правильно форматируй код» оставляет много вариантов. Лучше указать точное действие, компонент, импорт и поведение при отсутствии подходящего варианта. ```md ## Frontend - Для интерактивных элементов используй `GoodButton`, `GoodInput` и `GoodSelect`. - Не добавляй обычные элементы `