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. Ниже - условия для каждого из 4 режимов и порядок перехода со старой настройки.

В Telegram-канале - новости вайб-кодинга: инструменты, находки, ошибки.

Что изменилось в версии 2.1.277?

Официальный CHANGELOG.md проекта Claude Code на GitHub формулирует это так:

Перевод: добавлена поддержка AGENTS.md - в проекте без 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 с настройками стиля кода, он не помешает Claude Code прочитать проектный AGENTS.md. Но любой CLAUDE.local.md в рабочей папке - даже не добавленный в Git, для личных заметок - блокирует автоматическое чтение AGENTS.md в режиме по умолчанию. Явный импорт продолжает работать; для прямого чтения обоих файлов нужно сменить режим.

Если в Project instructions выбран режим с прямым чтением (раздел «4 режима Project instructions - какой выбрать» ниже) и в рабочей директории и выше нет CLAUDE.md, .claude/CLAUDE.md или CLAUDE.local.md, при старте сессии Claude Code читает каждый AGENTS.md и .claude/AGENTS.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 читаются вместе, в каждой директории сначала CLAUDE.md, потом AGENTS.md. Автоматически не читаются AGENTS.local.md, AGENTS.override.md и всё, что лежит в директории .agents/.

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

4 режима Project instructions - какой выбрать

Поведение режимов в таблице описано по документации Anthropic. В правой колонке - рекомендации по выбору:

Выбрать режим можно и без интерфейса - через settings.json:

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

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

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

Почему Project instructions нет в /config

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

Что делать со старым импортом @AGENTS.md

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

• CLAUDE.md с @AGENTS.md-импортом. Можно оставить как есть - Claude Code не прочитает файл дважды ни при каком значении Project instructions. Удалять CLAUDE.md необязательно: импорт уже даёт Claude доступ к содержимому AGENTS.md. Загрузку через импорт проверяй по-прежнему через /memory; прямой вопрос Claude о содержимом инструкций годится лишь как слабая проверка.
• CLAUDE.md, который словами просит прочитать AGENTS.md. Такая просьба не является импортом и сама по себе не гарантирует загрузку файла. Замени формулировку на @AGENTS.md-импорт, если хочешь оставить CLAUDE.md (например, для инструментов, которые его тоже читают). Если решишь удалить CLAUDE.md целиком и у тебя выбран режим claude-md-or-agents-md, сначала проверь, что в CLAUDE.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 остаётся при режиме claude-md-and-agents-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

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

Если нужно пересмотреть содержимое большого проектного файла инструкций, есть отдельный разбор - как настраивать CLAUDE.md и не раздувать его. Он посвящён структуре инструкций, а условия загрузки AGENTS.md описаны выше. Для рабочих заметок между сессиями пригодится разбор второго мозга в Claude Code - о персональной памяти поверх проектных инструкций.

Что дальше

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