Claude Code игнорирует AGENTS.md, если рядом лежит CLAUDE.md

Если в репозитории лежат и CLAUDE.md, и AGENTS.md, второй файл Claude Code просто не прочитает: по умолчанию тут откат, а не слияние. Поддержку AGENTS.md добавили в Claude Code 2.1.277 18 сентября 2026 года, а что именно она покрывает, разобрано в гайде AgentsMesh на Github.

Коротко

• В чейнджлоге 2.1.277 сказано, что в проекте без CLAUDE.md агент читает AGENTS.md, а сменить поведение можно в /config, в разделе «Project instructions»; на Bedrock, Vertex и Foundry функции нет.
• Чтение AGENTS.md отключают CLAUDE.md, .claude/CLAUDE.md и CLAUDE.local.md в рабочей папке или выше, а пользовательский ~/.claude/CLAUDE.md, управляемый файл организации и .claude/rules/ грузятся вместе с ним.
• Корневой AGENTS.md читают 17 инструментов из 33, с Claude Code их 18, но для слэш-команд, сабагентов, хуков и разрешений переносимого стандарта сегодня нет вообще.

Если вы не следили, формат появился не вчера. По данным Product at Work, AGENTS.md оформили на agents.md в середине 2025 года и продвигали вместе OpenAI, Google, Sourcegraph, Cursor, Factory, JetBrains и Anthropic как замену россыпи .cursorrules, .clinerules и .github/copilot-instructions.md. По данным Kingy AI, с выхода в августе 2025 года формат подхватили больше 60 000 открытых проектов, а в декабре 2025-го спецификацию передали Agentic AI Foundation под крылом Linux Foundation.

Три файла полностью выключают чтение AGENTS.md

Строка чейнджлога звучит буднично: в проекте без CLAUDE.md Claude Code читает AGENTS.md. Дальше начинаются детали. По документации Anthropic про память, чтение выключают три файла в рабочей папке или выше: CLAUDE.md, .claude/CLAUDE.md и CLAUDE.local.md. Если есть любой из них, AGENTS.md игнорируется целиком, без дописывания и слияния.

Рядом с AGENTS.md грузятся только клодовские источники: пользовательский ~/.claude/CLAUDE.md, управляемый CLAUDE.md организации и файлы из .claude/rules/. Большинство репозиториев, которым вся эта тема важна, держат оба файла сразу, так что разница между откатом и слиянием бьёт именно по ним. Отсюда совет из гайда: когда коллега жалуется, что агент игнорирует правило, которое видят все, ищите у него забытый CLAUDE.local.md.

На Bedrock, Vertex и Foundry AGENTS.md не читается вообще

Список того, чего откат не делает, короткий и неприятный.

• Пользовательского AGENTS.md уровня ~/.claude нет, личные предпочтения остаются клод-специфичными.
• Управляемого или корпоративного AGENTS.md тоже нет: при политике managed-only все AGENTS.md выпадают.
• Каталог .agents/ не читается вовсе, как и AGENTS.local.md с AGENTS.override.md.
• Папки, добавленные через --add-dir, свой AGENTS.md не подтягивают.
• Файл не виден в /memory и /context, хуки InstructionsLoaded на нём не срабатывают.

Сверху накладывается доступность. Откат не работает на Amazon Bedrock, Google Vertex AI и Microsoft Foundry, а также в любой сессии, которая пропускает запрос фич-флагов: с DISABLE_TELEMETRY, DO_NOT_TRACK или CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC, плюс в первой сессии после установки или обновления. Команды в облаке получают поведение CLAUDE.md независимо от того, что лежит в репозитории.

У опции instructionFiles четыре значения

Механика простая: поведение реализовано встроенным модом agents-md@builtin с опцией instructionFiles. Добраться до неё можно через /config, раздел «Project instructions», или прописать в настройках. Значений четыре: claude-md-or-agents-md (откат по умолчанию), claude-md-and-agents-md (читать оба файла), claude-md (игнорировать AGENTS.md) и managed-only.

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

Правила поддерживают 33 инструмента из 33, а разрешения только 11

AgentsMesh считает нативную поддержку по 33 инструментам: правила 33 из 33, скиллы 31, MCP-серверы 27, сабагенты 21, хуки 18, разрешения 11. Корневой AGENTS.md читают 17 инструментов, с Claude Code их 18. Правила и были лёгкой частью.

Дальше начинается пустота. Agent Plugins 1.0.0, за которым стоят мейнтейнеры из Amazon, Cursor, Microsoft, OpenAI и Vercel, описывает ровно два типа компонентов, скиллы и MCP-серверы, и в самой спецификации сказано, что команды, хуки, агенты, правила и LSP-серверы слишком завязаны на конкретный клиент для стабильного переносимого контракта. Модель доверия, систему разрешений и требования к песочнице версия 1.0.0 отдельно оставляет за скобками. Переносимого способа сказать «никогда не запускай terraform apply» и чтобы это поняли все ассистенты команды, сегодня нет.

Стоит помнить, подо что все подстраиваются: agents.md это сайт с FAQ, без номера версии, без даты и без нормативных формулировок, а весь контракт сводится к тому, что выигрывает ближайший файл. Формат SKILL.md описан, а место скиллов на диске нет: Claude Code читает .claude/skills/, предложение про общий .agents/skills/ до сих пор открыто, хотя его часто считают решённым. Странно, на наш взгляд, что доступность отката завязана на выборку фич-флагов, и выключенная телеметрия меняет то, какие инструкции прочитает агент.

Что решится вокруг .agents/skills

Дат никто не называет. Предложение про общий каталог скиллов остаётся открытым, разрешения и модель доверия вынесены за пределы Agent Plugins 1.0.0, а про Bedrock, Vertex и Foundry в чейнджлоге стоит только пометка «пока нет». Гайд сверялся с источниками 19 сентября 2026 года, и его авторы сами предупреждают: Claude Code выходит часто, так что таблицу отключающих файлов имеет смысл перечитывать после обновлений.