Claude Code читает AGENTS.md: изменения в версии 2.1.277

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

Если в одном репозитории работают Claude Code и ещё несколько инструментов, выбранный режим Project instructions определяет, какие файлы инструкций загрузит Claude Code. Ниже рассмотрены все четыре режима и переход с прежнего способа настройки.

Дополнительные сведения о конфигурации инструментов собраны в руководствах Ailoot.

Что изменилось в поддержке AGENTS.md в Claude Code 2.1.277?#

В официальном CHANGELOG.md Claude Code на GitHub это изменение описано так:

Иными словами, если в проекте нет CLAUDE.md, Claude Code читает вместо него AGENTS.md. Переключатель находится в разделе «Project instructions» команды /config; на Bedrock, Vertex и Foundry функция пока недоступна.

До выхода этой версии отсутствие CLAUDE.md, .claude/CLAUDE.md и CLAUDE.local.md в рабочей папке и её родительских каталогах не приводило к загрузке AGENTS.md. Для этого требовался явный импорт, символическая ссылка или ручной хук. Теперь при доступной функции файл подхватывается автоматически.

Какие файлы мешают автоматически загружать AGENTS.md#

Личный файл ~/.claude/CLAUDE.md с правилами оформления кода не мешает загрузить проектный AGENTS.md. А вот любой CLAUDE.local.md в рабочей папке — в том числе неотслеживаемый Git файл с личными заметками — блокирует автоматическую загрузку AGENTS.md в режиме по умолчанию. Явный импорт всё ещё работает. Чтобы напрямую читать оба файла, выбери другой режим.

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

no CLAUDE.md found; AGENTS.md loaded: /home/you/repo/AGENTS.md

Файл AGENTS.md во вложенной папке загружается, когда Claude открывает находящийся там файл с помощью инструмента Read. В режиме claude-md-or-agents-md это происходит, только если во вложенной папке нет собственного CLAUDE.md, .claude/CLAUDE.md или CLAUDE.local.md. Для режима claude-md-and-agents-md действует общее правило: оба файла читаются вместе, сначала CLAUDE.md, затем AGENTS.md в каждом каталоге. Имена AGENTS.local.md, AGENTS.override.md и содержимое каталога .agents/ автоматически не загружаются.

О конфигурации рабочей среды ИИ-агента и файлов с контекстом проекта читайте в руководствах Ailoot.

Четыре режима Project instructions: что выбрать#

Описания в таблице основаны на документации Anthropic. Последний столбец подсказывает, в каких случаях подходит каждый режим:

Режим можно задать и напрямую в settings.json, не пользуясь интерфейсом:

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

Claude Code игнорирует это значение в настройках project и local. Согласно документации Anthropic, задать его можно в ~/.claude/settings.json, файле, указанном через --settings, или в управляемой организацией конфигурации.

Если общий файл инструкций для нескольких ИИ-инструментов в репозитории уже настроен, механизм импорта @ по-прежнему работает.

Почему в /config нет раздела Project instructions#

Узнай установленную версию командой claude --version. Если она ниже 2.1.277, обнови Claude Code. Если версия соответствует требованию, но раздел не появился, проверь остальные пункты выше. Пока функция недоступна, можно продолжать пользоваться импортом @AGENTS.md в CLAUDE.md.

Как поступить с прежним импортом @AGENTS.md#

Способ перехода зависит от того, как файл подключался раньше. Для начала, как описано в предыдущем разделе, проверь, доступна ли функция в текущей сессии.

• CLAUDE.md с импортом @AGENTS.md. Его можно оставить: Claude Code не загрузит файл повторно ни при одном режиме Project instructions. Удалять CLAUDE.md не обязательно — импорт уже предоставляет доступ к содержимому AGENTS.md. Как и раньше, импорт можно проверить командой /memory; прямой вопрос Claude о содержании инструкций даёт лишь слабое подтверждение.
• CLAUDE.md с просьбой прочитать AGENTS.md, сформулированной обычным текстом. Такая запись не равнозначна импорту и не гарантирует, что файл загрузится. Если CLAUDE.md нужно сохранить, замени просьбу директивой @AGENTS.md, например для совместимости с инструментами, которые тоже читают CLAUDE.md. Если ты удаляешь CLAUDE.md целиком и выбран режим claude-md-or-agents-md, сначала перенеси уникальные инструкции и убедись, что ни в рабочей папке, ни выше по дереву нет другого CLAUDE.md, .claude/CLAUDE.md или CLAUDE.local.md. Иначе Claude Code будет читать оставшийся файл вместо AGENTS.md. После удаления проверь, что режим переключился: если блокирующих файлов больше нет, в интерактивной сессии должна появиться строка AGENTS.md loaded. Если CLAUDE.md остаётся, а режим claude-md-and-agents-md загружает оба файла, проверь /memory — эта возможность доступна в версиях 2.1.280 и новее. По ответу Claude нельзя определить, загрузил ли он файл напрямую или через импорт.
• CLAUDE.md — символическая ссылка на AGENTS.md. Её можно оставить: ни в одном режиме повторного чтения не будет. Прежде чем удалять ссылку при режиме claude-md-or-agents-md, сохрани необходимые инструкции и проверь, что в рабочей папке и родительских каталогах нет других CLAUDE.md, .claude/CLAUDE.md или CLAUDE.local.md. Для проверки используй строку AGENTS.md loaded при запуске сессии без блокирующих файлов либо /memory в версии 2.1.280 или новее. Если при режиме claude-md-and-agents-md файл CLAUDE.md остаётся, прямой вопрос Claude — только слабая проверка. Одного отсутствия ошибки недостаточно, чтобы подтвердить загрузку.
• Хук SessionStart, вручную добавляющий содержимое AGENTS.md. При прямой загрузке такой хук помещает в контекст вторую копию файла. Пока он включён, ответ на вопрос о содержании инструкций не доказывает прямую загрузку: Claude может опираться на текст, который добавил хук. Переходи в следующем порядке:
  1. Убедись, что функция доступна: установлена версия не ниже 2.1.277, сессия получает флаги функций, плагин включён, а первая после установки или обновления сессия уже завершена. Выбери режим прямого чтения — не claude-md и не managed-only. Для режима по умолчанию проверь также, что блокирующих файлов нет.
  2. Отключи хук.
  3. Заверши текущую сессию и открой новую. Хук SessionStart добавляет текст при запуске, поэтому уже открытая сессия сохраняет этот текст в контексте. Ответ Claude о загруженных инструкциях в такой сессии не подтвердит их прямое чтение.
  4. Проверь загрузку в новой сессии. В версии 2.1.280 или новее путь к AGENTS.md отображается в /memory. В версиях 2.1.277–2.1.279, если блокирующих файлов нет, при запуске ориентируйся на строку AGENTS.md loaded: документация описывает её для случая, когда CLAUDE.md не найден. Если ты оставляешь CLAUDE.md и включаешь claude-md-and-agents-md, способы проверки ограничены: в этих версиях /memory не показывает AGENTS.md, документация не описывает для такого случая строку загрузки, а пересказ инструкций не позволяет отличить прямое чтение от импорта @ в CLAUDE.md. Обновись до версии 2.1.280 или новее и проверь /memory.

Как убедиться, что AGENTS.md загружен#

У прямой загрузки такого AGENTS.md есть ещё два отличия от CLAUDE.md. Хуки InstructionsLoaded не запускаются для AGENTS.md, прочитанного напрямую; они работают, если файл подключён через синтаксис @ из CLAUDE.md или через символическую ссылку CLAUDE.md. Кроме того, для каталогов, добавленных флагом --add-dir вместе с переменной CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD, загружается только их CLAUDE.md; находящийся там AGENTS.md не подключается.

Если нужно пересмотреть большой проектный файл инструкций, руководства Ailoot объясняют, как организовать содержимое CLAUDE.md и избежать его чрезмерного разрастания. Условия загрузки AGENTS.md описаны выше.

Что учесть дальше#

Поддержка появилась 18 сентября 2026 года в версии 2.1.277. Anthropic может уточнять поведение режимов в последующих выпусках, поэтому перед изменением конфигурации важного проекта сопоставь изложенное с актуальными параметрами /config и официальным журналом изменений.