Thariq Shihipar из команды Claude Code объявил о поддержке AGENTS.md в версии 2.1.277. Если в корневой папке проекта нет файла CLAUDE.md, Claude будет искать AGENTS.md и использовать его для настройки поведения агента. За функцией стоит система mods — новый способ кастомизации Claude Code, который Anthropic готовит к выпуску.
Что такое AGENTS.md и чем он отличается от CLAUDE.md
Файл CLAUDE.md уже стал стандартом для проектов, использующих Claude Code: он содержит инструкции для модели, список инструментов, правила форматирования и ограничения. AGENTS.md выполняет ту же роль, но ориентирован на более широкий сценарий — настройку поведения агента, а не просто кодового помощника.
Что изменилось
Ключевое отличие: AGENTS.md — это «лёгкий» вариант конфигурации, который срабатывает только при отсутствии CLAUDE.md. Такой подход позволяет командам стандартизировать поведение агента в репозиториях, где раньше не было нужды создавать отдельный файл инструкций. Например, если проект уже использует AGENTS.md, но кто-то добавляет CLAUDE.md, приоритет остаётся за последним.
Сама поддержка AGENTS.md реализована через механизм mods. Как поясняет Shihipar, mods — это «настраиваемый каркас Claude Code», который Anthropic планирует активно развивать. Пока моды доступны ограниченно, но AGENTS.md уже работает как их обёртка: файл подгружается и интерпретируется как мод.
Кого это касается
Почему это важно именно сейчас
Выпуск совпал с растущей дискуссией о том, как конфигурировать агентов без накопления «технического долга в промптах». В статье Forrester-аналитиков, посвящённой этой проблеме, отмечается: когда модель заменяется на более новую, старые инструкции-компенсации перестают работать и начинают мешать. AGENTS.md предлагает альтернативу — вынести настройки в декларативный файл, который не смешивается с системным промптом.
В то же время недавний пост Thariq Shihipar «The Unreasonable Effectiveness of HTML» (8,3 млн просмотров) вызвал волну обсуждений: стоит ли агентам по умолчанию генерировать HTML вместо Markdown. Независимый тест, проведённый автором блога gallon.me, показал, что HTML действительно выигрывает в задачах с вёрсткой (сетки, слайдеры), но для текстовых отчётов и код-ревью Markdown остаётся практичнее. AGENTS.md, будучи Markdown-файлом, делает ставку на второй сценарий — простую читаемую конфигурацию, а не на визуальную сложность.
Что проверить
Практический взгляд: как написать AGENTS.md
Хотя Anthropic пока не опубликовала полную спецификацию mods, структуру AGENTS.md можно вывести из текущей документации Claude Code. Примерный шаблон:
AGENTS.md
— Модель: claude-opus-4-7
— Токены: 8192
— Инструменты: bash, file_edit, web_search
— Правило: перед коммитом запускать тесты
— Ограничение: не менять файлы в /vendor
На практике файл может быть сложнее, включать примеры промптов, запрещённые паттерны и приоритеты инструментов. Главное — он однозначен и не требует правки системного промпта при каждой смене модели.
Для команд, уже использующих CLAUDE.md, ничего не изменится — приоритет остаётся за ним. Нововведение полезно прежде всего для проектов с несколькими агентами (например, отдельные файлы для код-ревью и для генерации тестов) или для публичных репозиториев, где единый AGENTS.md задаёт «джентльменский набор» инструкций для любого пользователя Claude Code.
Ограничения и нерешённые вопросы
На данный момент AGENTS.md поддерживается только в Claude Code. Другие агенты Anthropic (Claude for Work, Claude API в режиме агента) пока не подхватили этот формат. Кроме того, система mods находится в стадии «upcoming» — её детали и API могут измениться до официального релиза.
Из-за этого AGENTS.md пока остаётся внутренней договорённостью внутри команды или репозитория. Если в будущем Anthropic стандартизирует моды и выпустит их для внешних агентов, AGENTS.md может стать де-факто стандартным файлом конфигурации, аналогичным `claude.md` или `cursorrules`.
Что стоит проверить разработчикам
Если вы используете Claude Code, обновитесь до версии 2.1.277 и создайте в корне проекта AGENTS.md, если ещё нет CLAUDE.md. Проверьте, что инструкции применяются корректно — выполните простой запрос, который должен следовать заданным правилам. Пока это единственный способ убедиться, что файл обрабатывается так, как задумано.
Кроме того, обратите внимание на чужие репозитории: если проект с открытым исходным кодом разместил AGENTS.md, ваша локальная копия Claude Code может неожиданно начать следовать этим правилам. Это удобно для онбординга, но требует доверия к содержимому файла — особенно если он включает разрешения на запись или запуск команд.