# Claude Code читает AGENTS.md: изменения в версии 2.1.277 > 18 сентября 2026 года в Claude Code 2.1.277 появилась прямая поддержка AGENTS.md. Разбираем условия загрузки файла, четыре режима Project instructions и переход со старого импорта. Source: https://ailoot.ai/blog/ru/claude-code-agents-md-support/ Canonical: https://ailoot.ai/blog/ru/claude-code-agents-md-support/ Language: ru Publisher: Ailoot (https://ailoot.ai/) Translation: guide-041 Revision: sha256-199d66035fbc2fad091d187f212d052ca66cfa43ab7bab9149b60f3a288a898d 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](https://ailoot.ai/docs/).
[Практические руководства Ailoot](https://ailoot.ai/docs/)
## Что изменилось в поддержке AGENTS.md в Claude Code 2.1.277?
Коротко С 18 сентября 2026 года Claude Code автоматически загружает `AGENTS.md`, если в цепочке каталогов от рабочей папки вверх нет `CLAUDE.md`, `.claude/CLAUDE.md` или `CLAUDE.local.md`. Наличие любого из этих файлов отключает автоматическую загрузку `AGENTS.md` через Project instructions. Явный импорт `@AGENTS.md` из `CLAUDE.md` продолжает работать. Пользовательский `~/.claude/CLAUDE.md`, организационный `CLAUDE.md` и файлы `.claude/rules/` загружаются независимо от выбранного проектного режима. Режим можно изменить командой `/config`. Функция пока не поддерживается в Bedrock, Vertex и Foundry.
В официальном CHANGELOG.md Claude Code на GitHub это изменение описано так:

Added AGENTS.md support: in a project with no CLAUDE.md, Claude Code reads AGENTS.md instead; change it under "Project instructions" in /config (not yet on Bedrock, Vertex or Foundry)

— Anthropic, запись в CHANGELOG.md репозитория claude-code, коммит ca02e7d, https://github.com/anthropics/claude-code/commit/ca02e7deeb0707f558b0afd7e9e5d67a382e12b3
Иными словами, если в проекте нет `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 Code ищет `CLAUDE.md`, `.claude/CLAUDE.md` и `CLAUDE.local.md` в рабочем каталоге и выше по дереву. Пользовательский `~/.claude/CLAUDE.md`, организационный `CLAUDE.md` и содержимое `.claude/rules/` не препятствуют загрузке `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](https://ailoot.ai/docs/).
[Практические руководства Ailoot](https://ailoot.ai/docs/)
## Четыре режима Project instructions: что выбрать
Коротко В разделе Project instructions команды `/config` доступны четыре значения: `claude-md-or-agents-md` (по умолчанию — один из двух файлов), `claude-md-and-agents-md` (оба файла), `claude-md` (автоматически загружается только `CLAUDE.md`, даже если в проекте есть лишь `AGENTS.md`) и `managed-only` (при запуске загружаются только организационный `CLAUDE.md` и автопамять, без проектных и пользовательских файлов). Изменение вступает в силу со следующего отправленного сообщения и применяется в каждой новой сессии.
Описания в таблице основаны на документации Anthropic. Последний столбец подсказывает, в каких случаях подходит каждый режим: | Значение | Какие файлы загружает Claude Code | Когда выбирать | |----|----|----| | `claude-md-or-agents-md` | `CLAUDE.md` либо, если в рабочей папке и родительских каталогах нет `CLAUDE.md`, `.claude/CLAUDE.md` и `CLAUDE.local.md`, файл `AGENTS.md` | Режим по умолчанию, если в репозитории используется один из двух типов файлов и выше нет файлов, блокирующих загрузку `AGENTS.md` | | `claude-md-and-agents-md` | Оба файла: в каждом каталоге сначала `CLAUDE.md`, затем `AGENTS.md` | Когда общий для инструментов `AGENTS.md` нужен вместе с коротким `CLAUDE.md` для Claude или когда требуется загрузка `AGENTS.md`, несмотря на наличие `CLAUDE.local.md` | | `claude-md` | Только `CLAUDE.md`; автоматическое чтение `AGENTS.md` через Project instructions отключено, даже если в проекте присутствует лишь `AGENTS.md`. Явный импорт `@AGENTS.md` из `CLAUDE.md` продолжает работать | Если содержимое `AGENTS.md` предназначено для другого инструмента и может сбить Claude с толку | | `managed-only` | При запуске сессии загружаются только управляемый организацией `CLAUDE.md` и автопамять. Проектные, локальные и пользовательские файлы `CLAUDE.md`, `.claude/rules/` и все `AGENTS.md` не входят в начальный набор. При этом файлы `CLAUDE.md` и `.claude/rules/` во вложенных каталогах всё равно загружаются, если Claude позднее открывает там файл. Режим ограничивает начальный набор, но не полностью изолирует сессию от проектных файлов | Для организаций, которым важно контролировать, с каким набором инструкций Claude Code начинает сессию независимо от `CLAUDE.md` или `AGENTS.md` в проекте | Режим можно задать и напрямую в `settings.json`, не пользуясь интерфейсом: ```json { "pluginConfigs": { "agents-md@builtin": { "options": { "instructionFiles": "claude-md-and-agents-md" } } } } ``` Claude Code игнорирует это значение в настройках `project` и `local`. Согласно документации Anthropic, задать его можно в `~/.claude/settings.json`, файле, указанном через `--settings`, или в управляемой организацией конфигурации. Если общий файл инструкций для нескольких ИИ-инструментов в репозитории уже настроен, механизм импорта `@` по-прежнему работает. ## Почему в /config нет раздела Project instructions
Коротко По документации Anthropic раздел Project instructions может не отображаться по нескольким причинам: - Установлена версия Claude Code старше или младше требуемой — ниже 2.1.277. - В сессии недоступны флаги функций Anthropic: например, при подключении через Bedrock или другого стороннего провайдера либо при отключённой телеметрии. - Сразу после установки или обновления с более ранней версии открыта первая сессия. Если это единственная причина, раздел появится в следующей сессии. Сам `AGENTS.md` загрузится только при соблюдении условий выбранного режима. - Встроенный плагин `agents-md` выключен в `/plugin`.
Узнай установленную версию командой `claude --version`. Если она ниже 2.1.277, обнови Claude Code. Если версия соответствует требованию, но раздел не появился, проверь остальные пункты выше. Пока функция недоступна, можно продолжать пользоваться импортом `@AGENTS.md` в `CLAUDE.md`. ## Как поступить с прежним импортом @AGENTS.md
Коротко Импорт `@AGENTS.md` в `CLAUDE.md` и символическую ссылку можно сохранить: в любом режиме содержимое файла не будет прочитано дважды. Если в `CLAUDE.md` только текстовая просьба прочитать `AGENTS.md`, замени её импортом, если намерен оставить этот файл. Перед удалением `CLAUDE.md` перенеси нужные инструкции и проверь требования выбранного режима. При переходе на прямую загрузку отключи `SessionStart`-хук, который вручную выводил содержимое `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 загружен
Коротко Начиная с версии 2.1.280 файл `AGENTS.md`, загруженный через Project instructions, отображается в `/memory` и в перечне Memory files команды `/context`. В версиях 2.1.277–2.1.279 его там нет, хотя эти команды показывают загруженные `CLAUDE.md` и другие файлы памяти. Если в этих версиях отсутствуют блокирующие файлы, при запуске сессии можно проверить строку `AGENTS.md loaded`. Вопрос Claude о содержании инструкций — лишь слабая проверка: ответ не отличает прямую загрузку от `@`-импорта и может основываться на тексте, добавленном хуком `SessionStart`. Поэтому такой вопрос имеет смысл задавать только в новой сессии после отключения этого хука.
У прямой загрузки такого `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` и официальным журналом изменений.
### Источники - [Claude Code: запись о версии 2.1.277 в CHANGELOG.md на GitHub, 18 сентября 2026 года](https://github.com/anthropics/claude-code/commit/ca02e7deeb0707f558b0afd7e9e5d67a382e12b3) - [Документация Claude Code: как система запоминает проектные инструкции, раздел AGENTS.md](https://code.claude.com/docs/en/memory)
[Практические руководства Ailoot](https://ailoot.ai/docs/)
[Открыть Ailoot](https://ailoot.ai/)
## Вопросы и ответы ### Почему AGENTS.md не загружается, хотя файл существует? В стандартном режиме CLAUDE.md, .claude/CLAUDE.md или CLAUDE.local.md в рабочей или родительской папке блокируют автоматический выбор AGENTS.md. Проверьте версию Claude Code, доступность функции и режим Project instructions в /config. ### Как проверить прямую загрузку после удаления ручного hook? Откройте новую сессию без старого вывода SessionStart. Начиная с 2.1.280 проверьте /memory или список Memory files в /context. В 2.1.277–2.1.279 ориентируйтесь на стартовую строку загрузки при отсутствии блокирующих CLAUDE.md. Пересказ самого Claude — слабое подтверждение. ## Ailoot · Компания и портфель её проектов Ailoot опирается на накопленный опыт работы, большую клиентскую базу, стабильный сервис и постоянный контроль KPI. Компания и портфель её проектов: миллионы клиентов; продажи на миллиарды ежемесячно. Этот опыт Ailoot использует для API-доступа к нейросетям в продуктах клиентов, агентах, приложениях и автоматизациях.