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

В выпущенном agents-md плагине загрузка файлов отделена от необязательных записей телеметрии. Эти записи содержат счётчики и варианты из фиксированного списка, но не пути и не текст файлов. Зависимость возникает уровнем выше: удалённый флаг определяет, доступен ли встроенный загрузчик.

Главное изменение

  • Что изменилось: Теперь локальный файл инструкций зависит от удалённого этапа включения функции: доступ к флагам определяет, доступен ли в Claude Code встроенный механизм чтения файла AGENTS.md.
  • Почему это важно: Два разработчика на одном коммите могут получить разные инструкции проекта из-за различий в версии, поставщике или настройках конфиденциальности. Из-за этого поведение агента сложнее воспроизвести в команде.
  • За чем следить: Команды с несколькими поставщиками или ограниченными сетевыми средами могут считать загрузку инструкций зависимостью среды выполнения, проверять её в каждой конфигурации и использовать импорт CLAUDE.md как переносимый запасной вариант.

Что подтверждают выпуск и публикация

В примечаниях к выпуску 2.1.277, датированных 18 сентября, сказано, что Claude Code читает AGENTS.md при условии, что в проекте нет файла CLAUDE.md. В примечаниях также говорится, что на момент запуска поддержка не распространялась на Bedrock, Vertex и Foundry.

В актуальной документации о памяти проекта также исключены первый сеанс после установки или обновления до поддерживаемой версии и сеансы с выключенным встроенным плагином.

В публикации Пржемека Шиповского, ставшей поводом для обсуждения, описывается проверка в canary-сборке 2.1.280. По его словам, DISABLE_TELEMETRY и CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC помешали ему загрузить AGENTS.md, тогда как соседний CLAUDE.md импорт сработал. BIG CHANGE не воспроизвела проверку платной модели. В актуальной документации Anthropic независимо указаны те же условия доступности.

Доступность функций и запись телеметрии — разные вещи

В документации Anthropic о переменных среды говорится, что любое непустое значение переменной DISABLE_TELEMETRY, включая 0 или false, отключает телеметрию и получение флагов функций. DO_NOT_TRACK, DISABLE_GROWTHBOOK и CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC тоже могут остановить получение флагов. Сеансы через сторонних поставщиков исключены, если хост встраиваемого приложения не задаёт CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST; сеансы через шлюз Claude Apps также исключены.

В README выпущенного плагина agents-md говорится, что пропущенные вызовы телеметрии отбрасываются, не меняя остальную работу плагина. В репозитории есть обзор модулей, где телеметрия и agents-md названы отдельными встроенными модулями.

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

23 сентября BIG CHANGE скачала agents-md README и модуль регистрации в ветке main и в теге 2.1.280, выпущенном 22 сентября; файлы в обеих парах совпадали побайтно.

Когда Claude Code загружает файл

Для доступного и включённого плагина режим по умолчанию использует такой приоритет:

Файлы инструкций

Результат по умолчанию

AGENTS.md, если в проекте нет файла инструкций Claude

AGENTS.md загружается

Файл проекта CLAUDE.md, .claude/CLAUDE.md или CLAUDE.local.md в рабочем каталоге или выше

Прямая загрузка AGENTS.md уступает место этим файлам

Пользовательский или управляемый CLAUDE.md, или .claude/rules/

Эти файлы не вытесняют AGENTS.md

Настройка инструкций проекта в /config включает оба типа файлов. Параметр JSON задаётся в пользовательских настройках, --settings или управляемых настройках; файлы настроек проекта и локальные настройки игнорируются.

Запасной вариант — явный импорт

Для сеансов без встроенной поддержки Anthropic рекомендует добавить CLAUDE.md рядом с общим файлом. Его содержимое:

@AGENTS.md

Импорт включает файл напрямую; текстовая просьба прочитать его оставляет это решение на усмотрение модели.

Проверьте версию командой claude --version и раздел «Инструкции проекта» в /config. В версии 2.1.280 команда /memory или /context показывает непосредственно загруженный AGENTS.md; в более ранних версиях с поддержкой эта команда файл не показывала.