Claude Code научился читать общий файл инструкций AGENTS.md
Ещё недавно у каждого ИИ-кодинг-ассистента была своя причуда: Claude Code хотел файл CLAUDE.md, Codex — AGENTS.md, Cursor — папку.cursor/rules, а Gemini CLI — GEMINI.md. Если вы вели проект через два-три инструмента одновременно, приходилось дублировать одни и те же правила в нескольких файлах и следить, чтобы они не расходились. В сентябре это неудобство наконец начало исчезать: Claude Code тоже научился понимать универсальный формат AGENTS.md.
Что такое AGENTS.md и почему он стал стандартом
AGENTS.md — это простой markdown-файл в корне репозитория, который объясняет ИИ-агенту то, что обычно знает только человек-разработчик: какой командой собирать проект, чем гонять тесты, какие папки трогать нельзя, в каком стиле писать код. Это «README для агентов»: выделенное, предсказуемое место, где AI находит контекст и правила работы с проектом.
Формат придумала OpenAI для Codex ещё в августе 2025 года, но прижился он куда шире. С момента выхода в августе 2025 года AGENTS.md был принят более чем 60 000 открытых проектов и фреймворков агентов, включая Amp, Codex, Cursor, Devin, Factory, Gemini CLI, Github Copilot, Jules и VS Code. А в декабре 2025 года формат передали под нейтральное управление: AGENTS.md — это простой, универсальный стандарт, который даёт ИИ-кодинг-агентам единый источник инструкций по конкретному проекту, необходимых для надёжной работы в разных репозиториях и наборах инструментов, и теперь он живёт в Agentic AI Foundation при Linux Foundation вместе с протоколом MCP от Anthropic.
Что именно изменилось в Claude Code
До сентября Claude Code упорно держался своего формата CLAUDE.md и файл AGENTS.md просто игнорировал — приходилось вручную прописывать импорт. Ситуация изменилась с выходом версии 2.1.277: Claude Code читает AGENTS.md нативно, начиная с версии v2.1.277 или новее (вышла 18 сентября 2026 года, когда Anthropic приняла кросс-инструментальную спецификацию). Благодаря этому репозиторий, который уже понимают другие агенты, работает с Claude Code без добавления CLAUDE.md, строки импорта или настройки. Важный нюанс: это не слияние файлов, а приоритет. Если в репозитории есть и AGENTS.md, и CLAUDE.md, Claude читает только файлы CLAUDE.md. То есть AGENTS.md — это запасной вариант для проектов, где CLAUDE.md никогда не заводили. Если вы хотите совместить оба формата, проще прописать в коротком CLAUDE.md строку импорта, которая подключает содержимое AGENTS.md.
Обновление вышло почти незаметно — одна строка в changelog — но реакция сообщества показала, насколько запрос был накопленным: обсуждение на Hacker News набрало 719 очков и 271 комментарий за 48 часов — сильный сигнал, что многие команды именно этого и ждали.
Как настроить AGENTS.md под себя: пошагово
Если у вас пока нет такого файла, а проект ведётся через Claude Code, Codex или Cursor одновременно — вот простой план:
- Создайте файл AGENTS.md в корне репозитория. Никакой особой разметки не нужно: обычный markdown, без YAML-заголовков и спецсинтаксиса.
- Опишите команды сборки и тестов. Например: каким пакетным менеджером пользоваться, как запускать линтер, какой командой гонять тесты перед коммитом.
- Укажите запретные зоны. Папки с автогенерируемым кодом, миграции, конфиги окружения — всё, что агент не должен трогать без явного разрешения.
- Добавьте ожидания к pull request'ам — формат заголовка, обязательные проверки перед коммитом.
- Для разных частей монорепозитория можно создавать отдельные вложенные AGENTS.md — ближайший к редактируемому файлу имеет приоритет.
Для новичка это особенно полезно: вместо того чтобы в каждой новой сессии объяснять ассистенту одно и то же, вы один раз фиксируете правила — и агент читает их автоматически перед первым действием.
Как это работает в Codex и Cursor
В Codex всё устроено как «родной» формат: когда вы запускаете сессию Codex, он автоматически проходит по файловой системе от корня git-репозитория до текущей рабочей директории, читая каждый найденный AGENTS.md. Есть и ограничение по объёму — по умолчанию около 32 КиБ суммарных инструкций, так что раздувать файл бесконечно не стоит.
В Cursor AGENTS.md работает как облегчённая альтернатива собственным правилам: это инструкции агенту в markdown-формате — простая альтернатива.cursor/rules. Если нужна точная настройка по типам файлов и условная активация правил — лучше оставить.cursor/rules, а AGENTS.md использовать как общий, кросс-инструментальный слой контекста.
Для Gemini CLI потребуется небольшая донастройка: формат имени файла задаётся вручную в настройках, и чтобы указать другое имя или список имён, используется свойство context.fileName, куда можно прописать AGENTS.md наравне с GEMINI.md.
Что это значит на практике
Главная выгода — не в самом факте поддержки, а в экономии времени на синхронизацию правил между инструментами. Если команда пробует одновременно Claude Code для сложных задач, Codex для фоновых агентов и Cursor для повседневной разработки, теперь достаточно держать в порядке один файл вместо трёх. Это особенно заметно в проектах, где разные участники команды предпочитают разные ассистенты — больше не нужно спорить, чей формат «главный».
Если вы ещё не пробовали AI-кодинг-ассистентов или хотите протестировать несколько моделей без привязки к одному сервису, в GEMERA AI можно пообщаться с GPT, Claude и Gemini в одном окне — через Telegram-бота или веб-кабинет — и присмотреться, какой инструмент удобнее лично вам.