Версия Markdown

AI-translated from English; not yet reviewed by a fluent editor.

# Claude Code может пропускать AGENTS.md при отключённой телеметрии

> Встроенная поддержка файлов AGENTS.md в Claude Code зависит от версии, доступа к функциям, поставщика и приоритета файлов. В собственных строках телеметрии выпущенного плагина agents-md не записываются пути и текст файлов.

By BIG CHANGE Editorial

Published: 2026-09-23T13:54:58.721Z
Updated: 2026-09-23T13:54:58.721Z
Canonical: https://bigchange.ai/blog/claude-code-agents-md-telemetry-feature-flags

![A desktop monitor shows a minimal project-instructions view with plain AGENTS.md and CLAUDE.md labels above a keyboard and mouse.](https://bigchange.ai/api/media/file/claude-code-project-instructions-hero-v2.png)
AI-generated conceptual illustration by BIG CHANGE.

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

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

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

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

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

В [примечаниях к выпуску 2.1.277](https://github.com/anthropics/claude-code/releases/tag/v2.1.277), датированных 18 сентября, сказано, что Claude Code читает `AGENTS.md` при условии, что в проекте нет файла `CLAUDE.md`. В примечаниях также говорится, что на момент запуска поддержка не распространялась на Bedrock, Vertex и Foundry.

В актуальной [документации о памяти проекта](https://code.claude.com/docs/en/memory) также исключены первый сеанс после установки или обновления до поддерживаемой версии и сеансы с выключенным встроенным плагином.

В публикации Пржемека Шиповского, [ставшей поводом для обсуждения,](https://blog.szypowi.cz/p/claude-code-reads-agents.md-only-when-telemetry-is-on) описывается проверка в canary-сборке 2.1.280. По его словам, `DISABLE_TELEMETRY` и `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` помешали ему загрузить `AGENTS.md`, тогда как соседний `CLAUDE.md` импорт сработал. BIG CHANGE не воспроизвела проверку платной модели. В актуальной документации Anthropic независимо указаны те же условия доступности.

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

В документации Anthropic о [переменных среды](https://code.claude.com/docs/en/env-vars) говорится, что любое непустое значение переменной `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](https://github.com/anthropics/claude-code/blob/v2.1.280/mods/agents-md/README.md) говорится, что пропущенные вызовы телеметрии отбрасываются, не меняя остальную работу плагина. В репозитории есть [обзор модулей](https://github.com/anthropics/claude-code/blob/v2.1.280/mods/README.md), где телеметрия и `agents-md` названы отдельными встроенными модулями.

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

23 сентября BIG CHANGE скачала `agents-md` README и [модуль регистрации](https://github.com/anthropics/claude-code/blob/v2.1.280/mods/agents-md/hooks/register.ts) в ветке `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`; в более ранних версиях с поддержкой эта команда файл не показывала.

## Sources

- [Claude Code читает AGENTS.md, только если телеметрия включена](https://blog.szypowi.cz/p/claude-code-reads-agents.md-only-when-telemetry-is-on) — Опубликованный отчёт Пржемека Шиповского о проверках на тестовом канале версии 2.1.280 и обходном решении. BIG CHANGE не воспроизводила тест платной модели; статья отделяет наблюдения автора от официальной документации и интерпретации исходного кода.
- [Выпуск Claude Code v2.1.277](https://github.com/anthropics/claude-code/releases/tag/v2.1.277) — Официальная запись о выпуске, добавившем поддержку AGENTS.md и исключившем Bedrock, Vertex и Foundry из доступности на момент запуска.
- [Как Claude запоминает контекст проекта](https://code.claude.com/docs/en/memory) — Текущая официальная документация о минимальной версии, приоритете файлов, режимах инструкций проекта, недоступных сеансах, диагностике и запасном варианте с импортом CLAUDE.md.
- [Переменные среды Claude Code](https://code.claude.com/docs/en/env-vars) — Актуальная официальная документация о том, что отказ от телеметрии также отключает получение флагов функций и тем самым делает недоступной прямую загрузку AGENTS.md, а также перечисляет другие затронутые сеансы.
- [Встроенный модуль agents-md: исходный код и поведение в Claude Code v2.1.280](https://github.com/anthropics/claude-code/blob/v2.1.280/mods/agents-md/README.md) — Описание выпущенного кода: режимы работы с файлами инструкций, приоритет и необязательные записи телеметрии. Указывается, что записи содержат счётчики и фиксированные варианты, а не пути или текст файлов.
- [Встроенные модули Claude Code, v2.1.280](https://github.com/anthropics/claude-code/blob/v2.1.280/mods/README.md) — Обзор выпущенного кода подтверждает, что телеметрия и agents-md — отдельные встроенные плагины, а исходники с соответствующим тегом поставляются в составе Claude Code.
- [Модуль регистрации agents-md, Claude Code v2.1.280](https://github.com/anthropics/claude-code/blob/v2.1.280/mods/agents-md/hooks/register.ts) — Выпущенный исходный файл регистрации, изученный вместе с README. При проверке 23 сентября его байты совпадали с соответствующим файлом в основной ветке.