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

Claude Code 2.1.277 вышел 18 сентября и научился читать AGENTS.md. Но только как запасной вариант: если в рабочей папке или выше есть CLAUDE.md, AGENTS.md игнорируется целиком. Его не дописывают к CLAUDE.md и не сливают с ним.

Где ещё новая поддержка ведёт себя неожиданно, разобрали в гайде AgentsMesh на GitHub. Авторы гайда делают генератор конфигов для кодовых агентов и 19 сентября сверили текст с changelog релиза и документацией Anthropic про память. Как они замечают, обновление избавляет от целой кучи симлинков и вставок @AGENTS.md, но действует уже, чем следовало из реакции на релиз. А это важно как раз для тех, кому тема небезразлична: в таких репозиториях обычно лежат оба файла.

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

Ещё пять вещей, которых запасной вариант не делает:

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

Глава Shopify Тоби Лютке в августе грозил запретить Claude Code в компании, пока тот не начнёт читать AGENTS.md и .agents/skills. AGENTS.md в 2.1.277 читается, папка .agents/ нет.

На Amazon Bedrock, Google Vertex AI и Microsoft Foundry AGENTS.md не читается вовсе. Команды на облачных провайдерах получают поведение CLAUDE.md, что бы ни лежало в репозитории. Функция не работает и в любой сессии, которая пропускает загрузку feature-флагов: с выставленными DISABLE_TELEMETRY, DO_NOT_TRACK или CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC, а также в первой сессии после установки или обновления. Выходит, какой файл инструкций прочтёт агент, почему-то решают настройки телеметрии.

Само поведение оформлено как встроенный мод с опцией instructionFiles. Поменять её можно в /config, в разделе «Project instructions», или прямо в настройках:

{ "pluginConfigs": { "agents-md@builtin": { "options": { "instructionFiles": "claude-md-and-agents-md" } } } }

Значений четыре: claude-md-or-agents-md (запасной вариант, по умолчанию), claude-md-and-agents-md (читать оба), claude-md (игнорировать AGENTS.md) и managed-only. Поэтому если команде нужны оба файла сразу, каждый разработчик включает это у себя сам.

Сам стандарт фиксирует меньше, чем можно подумать по его распространённости. Сайт agents.md называет формат «README для агентов», выделенным и предсказуемым местом для контекста и инструкций, которые помогают кодовым агентам работать с проектом, и утверждает, что им пользуются больше 60 тысяч open-source-проектов. При этом это сайт с FAQ, а не версионированная спецификация: у него нет ни номера версии, ни даты, ни нормативных формулировок. Обязательных полей тоже нет. Это обычный Markdown, и побеждает файл, ближайший к редактируемому. Для своей задачи этого хватает: из 33 инструментов, под которые генерирует AgentsMesh, корневой AGENTS.md читают 17, с Claude Code их стало 18.

С остальным хуже. Agent Plugins 1.0.0, спецификацию переносимых пакетов, поддерживают мейнтейнеры из Amazon, Cursor, Microsoft, OpenAI и Vercel. Она определяет ровно два типа компонентов: навыки и MCP-серверы. Остальное отложено прямо в тексте спецификации:

Другие предложенные типы компонентов, такие как команды, хуки, агенты, правила и LSP-серверы, пока слишком зависят от конкретного клиента для стабильного переносимого контракта и остаются вне формата v1, пока их форматы не сойдутся.

Разрешения исключены отдельной строкой: версия 1.0.0 «не определяет модель доверия, систему разрешений или требования к песочнице для плагинов». Для слэш-команд, сабагентов, хуков, разрешений и ignore-файлов кросс-инструментального стандарта сейчас нет. И даже у навыков есть пробел: Agent Skills стандартизирует формат SKILL.md, но не место на диске. Claude Code читает .claude/skills/, а предложение об общей папке .agents/skills/ всё ещё открыто, хотя её часто описывают как решённый вопрос.

AgentsMesh посчитала нативную поддержку по тем же 33 инструментам. Правила понимают все 33, навыки 31, MCP-серверы 27, сабагентов 21, хуки 18, разрешения всего 11.

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

С разрешениями так не выйдет. В Claude Code есть полноценная модель allow и deny, у большинства инструментов что-то слабее, устроенное иначе или вообще ничего. Переносимого способа сказать «никогда не запускай terraform apply» так, чтобы это соблюдал каждый ассистент в команде, нет.