Claude Code 2.1.280: vypnutá telemetrie blokovala AGENTS.md
V testovaných verzích záviselo načtení místního AGENTS.md na vzdáleném feature flagu. Článek ukazuje reprodukci, spolehlivý import přes CLAUDE.md i hranice tohoto zjištění.
Claude Code 2.1.277 přidal podporu souboru AGENTS.md: pokud projekt nemá CLAUDE.md, nástroj měl načíst instrukce právě z něj. Przemek Szypowicz ale ve verzích 2.1.277 až 2.1.280 naměřil, že při zakázané telemetrii nebo ostatním nepovinném síťovém provozu se místní soubor nenačetl. Claude Code přitom nevypsal žádné varování.
Místní soubor závisí na vzdáleném přepínači
Szypowicz dohledal v balíku Claude Code 2.1.280 vestavěný plugin agents-md. V tehdejším sestavení měl plugin výchozí hodnotu isOnByDefault nastavenou na false a dostupnost ověřoval přes vzdálený feature flag tengu_agents_md_mod. Když klient tento přepínač nezískal, použila se rovněž hodnota false a AGENTS.md se přeskočil.
To vysvětluje spojení s telemetrií: proměnné CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1 a DISABLE_TELEMETRY=1 zabránily v autorově konfiguraci získání flagu. Pouhé nastavení těchto proměnných na 0 nepomohlo, protože podle dokumentace se jako aktivní počítá jejich přítomnost bez ohledu na hodnotu.
Jak test probíhal
Autor vytvořil prázdný adresář obsahující pouze AGENTS.md s kontrolním slovem PERIWINKLE. Poté spustil claude -p a požádal model o kontrolní slovo, aniž by mu dovolil soubor přímo číst. Každou konfiguraci ověřoval ve dvou sessions: první získala feature flag a druhá jej použila.
S některou z blokujících proměnných se instrukce nenačetly. Po odstranění obou proměnných začal test od druhé session vracet správné slovo. Nepomohlo ani jejich vymazání přes blok env v projektovém .claude/settings.json. Fungovalo až přepsání nastavení při spuštění:
claude --settings '{"env":{"DISABLE_TELEMETRY":"","CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC":""}}'
Stejné chování popisuje issue v oficiálním repozitáři Claude Code také pro první session po instalaci či upgradu a pro prostředí s third-party gatewayemi, Amazon Bedrockem nebo Vertex AI, kde se vzdálený přepínač nemohl vyhodnotit jako zapnutý.
Obejití bez zapnutí telemetrie
Praktičtější řešení využívá importy podporované v CLAUDE.md. Vedle existujícího AGENTS.md stačí vytvořit jednořádkový soubor:
echo '@AGENTS.md' > CLAUDE.md
Při autorově opakování stejného canary testu se pak instrukce načetly i s CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1. Cenou je další soubor v každém repozitáři, ale není nutné kvůli místním instrukcím povolit telemetrii.
Výsledek pochází z testu jednoho autora a z jeho rozboru konkrétních verzí Claude Code, nikoli z oficiálního vyjádření Anthropic. Pro uživatele, kterým nástroj zdánlivě ignoruje AGENTS.md, je proto nejdřív užitečné ověřit verzi, přítomnost uvedených proměnných a chování v nové session. Hlavní problém není samotná existence feature flagu, ale tiché přeskočení souboru bez informace, že se projektové instrukce k modelu vůbec nedostaly.
Jak ověřit aktuální verzi
Jde o časově omezené zjištění, ne o tvrzení o všech budoucích verzích Claude Code. Implementace pluginu se může změnit nezávisle na článku. Před zásahem do nastavení je proto bezpečnější zopakovat canary test v nové prázdné složce a zkontrolovat aktuální dokumentaci pluginu agents-md.
Pokud se kontrolní slovo nenačte, jednořádkový import přes CLAUDE.md zůstává snadno auditovatelnou variantou: nevyžaduje povolení telemetrie a přímo říká, odkud mají projektové instrukce přijít. Pro tým je zároveň vhodné testovat načtení instrukcí v CI nebo při aktualizaci nástroje, protože tiché selhání může změnit práci agenta s repozitářem bez chyby v samotném promptu.