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

Лид

В версии Claude Code 2.1.277 компания Anthropic объявила о поддержке формата AGENTS.md — стандарта инструкций для AI-агентов, разработанного OpenAI. Однако выяснилось, что функция молча не работала у всех, кто отключил телеметрию или пользуется облачными шлюзами AWS Bedrock и Google Vertex AI. Баг признан Anthropic, исправление вышло в версии 2.1.281.

Что случилось

Claude Code 2.1.277 добавил поддержку AGENTS.md, но загрузчик файла был скрыт за удалённым feature flag (флагом функциональности). При отключённой телеметрии или выключенном неэссенциальном трафике локальный AGENTS.md просто игнорировался — без каких-либо предупреждений.

По задумке, начиная с версии 2.1.277, Claude Code должен читать AGENTS.md в проекте, где нет CLAUDE.md. Но функция реализована как встроенный плагин, отключённый по умолчанию и управляемый удалённым feature flag от Anthropic — Statsig gate tengu_agents_md_mod.

Если телеметрия отключена или используется сторонний шлюз (Bedrock, Vertex), флаг никогда не получал значение true — и чтение локального markdown-файла, которое вообще не требует сети, молча блокировалось серверным переключателем.

Как это работало внутри

Загрузчик поставляется как встроенный плагин agents-md. Значение isOnByDefault у плагина равно false. Функция isAvailable обращается к удалённому флагу tengu_agents_md_mod с false в качестве запасного значения. Если Claude Code не может получить флаг — плагин недоступен, и локальный файл не читается вовсе.

flowchart TD
    A[Запуск Claude Code] --> B{Телеметрия включена?}
    B -- Да --> C[Запрос к Statsig: tengu_agents_md_mod]
    B -- Нет --> D[Флаг не получен]
    C --> E{Флаг = true?}
    E -- Да --> F[AGENTS.md загружен ✅]
    E -- Нет --> G[AGENTS.md пропущен ❌]
    D --> G
    G --> H[Сессия запускается без project instructions]
    H --> I[Пользователь не получает предупреждения]

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

Кто обнаружил и как доказал

Проблему задокументировал разработчик Пшемыслав Шыповиц (Przemysław Szypowicz). Он показал, что при установленных переменных DISABLE_TELEMETRY=1 или CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1 файл никогда не загружается и пользователь не получает никакого предупреждения.

Шыповиц доказал это с помощью тестовой папки, содержащей только AGENTS.md с уникальным словом-маяком (canary word).

«Я намеренно отключил телеметрию и ожидал, что это лишит меня диагностики — и ничего больше. Здесь это молча лишило меня функциональности.»

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

Реакция сообщества и Anthropic

Тема набрала 432 очка и 239 комментариев на Hacker News, превратившись в один из самых обсуждаемых инцидентов недели в AI-сообществе.

В треде на Hacker News представитель Anthropic mpoteat признал, что флаг использовался как удалённый аварийный выключатель для запуска, назвал произошедшее «полностью человеческой ошибкой» и сообщил, что исправление выйдет в версии 2.1.281.

@AGENTS.md

Что изменилось в исправленной версии

После исправления загрузка AGENTS.md не зависит от получения feature flag, поэтому работает на Bedrock, Vertex и Foundry, при отключённой телеметрии и в первой сессии после установки или обновления.

Контекст и значение для отрасли

Поддержка AGENTS.md была реализована как внутренний «мод» (mod) — плагин, встраивающийся в оболочку Claude Code, которая собирает контекст, вызывает инструменты и управляет сессией, а не в саму модель.

До появления поддержки AGENTS.md команды, использующие несколько AI-агентов в одном репозитории, были вынуждены вручную синхронизировать файлы или использовать симлинки. Этот обходной путь держался лишь в небольших проектах.

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