20 сентября 2026, 14:27

Claude Code научился ознакомиться AGENTS.md

2 мин

Anthropic добавили поддержку AGENTS.md в Claude Code 2.1.277. Теперь средство может использовать совокупный файл с инструкциями для coding-агентов вместо отдельного CLAUDE.md.

Что изменилось

На всякий случай напомню, что AGENTS.md хранит правила работы с проектом. Например:

как инсталлировать зависимости;
какой командой запускать тесты;
где находится необходимый исходник;
какие стандарты оформления соблюдать;
какие файлы нельзя изменять.

Формат называют README для агентов. Это обычный Markdown без обязательной схемы. По данным официального сайта, его используют более 60 тысяч open source проектов. Формат поддерживают Codex, Gemini CLI, GitHub Copilot, Cursor, Devin, Aider и другие инструменты.

Claude Code раньше ориентировался на собственный CLAUDE.md. Командам, использующим несколько агентов, приходилось копировать правила, создавать символические ссылки или импортировать AGENTS.md вручную.

Главная проблема копий проста. Команду тестирования обновили в одном файле, во втором забыли, и агенты получили разные инструкции. Теперь базовые правила можно хранить в одном месте.

Как работает

По умолчанию Claude Code сначала ищет:

CLAUDE.md;
.claude/CLAUDE.md;
CLAUDE.local.md.

Если этих файлов нет, он загружает AGENTS.md. При запуске сессии появляется сообщение:

no CLAUDE.md found; AGENTS.md loaded: /home/user/project/AGENTS.md

Через /config можно изменить режим Project instructions. Claude Code умеет читать только один тип файлов, загружать CLAUDE.md и AGENTS.md одновременно или использовать только корпоративные инструкции. Вложенные AGENTS.md тоже поддерживаются. Корневой файл может содержать общие правила репозитория, а файл внутри отдельного сервиса описывать его команды и архитектуру.

Существующий CLAUDE.md со строкой @AGENTS.md удалять необязательно. Anthropic пишет, что повторно один и тот же файл загружен не будет.

Что важно учесть

Функционал требует Claude Code 2.1.277 или новее. На момент релиза она не работает через Amazon Bedrock, Google Vertex AI и Microsoft Foundry.

Загруженный AGENTS.md не отображается в списке Memory files команд /memory и /context. Проверить его можно по сообщению при запуске или попросив Claude пересказать инструкции проекта.

Сам файл не заменяет настройки безопасности. Например, просьба «не удалять production» остаётся просьбой. Для нормальной защиты нужны ограничения разрешений, sandbox и хуки.