Claude Code читає AGENTS.md лише з увімкненою телеметрією

Claude Code 2.1.277 отримав підтримку AGENTS.md: у проєкті без CLAUDE.md інструмент має читати альтернативний файл інструкцій. Розслідування, опубліковане на blog.szypowi.cz, показує, що ця підтримка тихо залежить від увімкненої телеметрії та іншого необов'язкового трафіку.

Завантажувач чекає на віддалений прапорець

Завантажувач AGENTS.md постачається як вбудований плагін agents-md. У збірці 2.1.280 його реєстрація виставляє isOnByDefault у false, а доступність визначає віддалений прапорець функції tengu_agents_md_mod, де false — значення за замовчуванням. Якщо прапорець не вдається отримати, плагін недоступний, і локальний файл не читається — хоча читання markdown із робочої теки не потребує мережі взагалі. Автор знайшов причину в issue #95690 на GitHub і додав власні вимірювання.

Канареечні тести без телеметрії

Тест був мінімальним: порожня тека лише з AGENTS.md, що містив контрольне слово, і запит до CLI назвати це слово без читання файлів. Кожну конфігурацію запускали двічі, бо перша сесія лише отримує прапорець.

Із CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1 або DISABLE_TELEMETRY=1 файл не завантажувався; довелося очистити обидві змінні. Значення 0 не допомагає — рахується будь-яке. Блок env у .claude/settings.json проєкту не дає ефекту, тож увімкнути функцію для одного репозиторію неможливо. Перевизначення рівня сесії через --settings працює, починаючи з другої сесії. У жодному разі попередження не друкується. Сторонні шлюзи, Bedrock і Vertex мають ту саму проблему, бо там прапорець теж не може стати true.

Обхідний шлях

CLAUDE.md підтримує імпорти @path, і вони не обмежені прапорцем. Однорядковий CLAUDE.md поряд із AGENTS.md завантажує його навіть із вимкненою телеметрією — той самий канареечний тест повертає слово. Ціна — один зайвий файл на репозиторій, саме те навантаження, яке підтримка AGENTS.md мала прибрати.

Чому тиша — найгірше

Автор вважає, що вимкнена телеметрія має коштувати лише діагностики, і що віддалений перемикач не має сенсу для функції, чиє єдине джерело вже лежить на диску. Обмеження найбільше б'є по тих, кому AGENTS.md найпотрібніший: хто тримає один файл інструкцій для кількох агентів, і команди, які політикою вимикають необов'язковий трафік. Оскільки нічого не логується, більшість вирішить, що модель проігнорувала інструкції. Він просить попередження під час запуску, коли AGENTS.md є, але пропущений, а також AGENTS.md рівня користувача й нативну підтримку спільного шляху .agents/skills, який Codex уже читає. Поки що він тримає однорядковий CLAUDE.md і symlink для скілів.