Claude Code abaikan AGENTS.md saat telemetri dimatikan
Judul asli: Claude Code reads AGENTS.md only when telemetry is on [fixed]
Mengapa Ini Penting
Fitur inti terkunci di balik network call mencerminkan desain yang bertentangan dengan privasi pengguna.
Claude Code 2.1.277 tambahkan dukungan AGENTS.md, tetapi fitur ini terkunci di balik remote feature flag. Pengguna yang menonaktifkan telemetri atau nonessential traffic tidak dapat memuat file lokal tersebut tanpa peringatan apapun.
Claude Code versi 2.1.277 mengumumkan dukungan AGENTS.md sebagai alternatif CLAUDE.md untuk instruksi proyek. Namun, peneliti Przemek menemukan bahwa fitur ini tidak berfungsi saat telemetri dimatikan.
Akar masalahnya ada di plugin bawaan bernama agents-md. Nilai isOnByDefault plugin ini adalah false, dan ketersediaannya bergantung pada remote feature flag bernama tengu_agents_md_mod. Jika Claude Code tidak bisa mengambil flag tersebut — seperti saat CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1 atau DISABLE_TELEMETRY=1 aktif — plugin tidak tersedia dan file AGENTS.md diabaikan begitu saja.
Pengujian menunjukkan beberapa fakta penting: menetapkan nilai variabel ke 0 tidak membantu karena dokumentasi menyatakan nilai apapun dianggap aktif. Pengaturan env di .claude/settings.json untuk repo tertentu juga tidak berpengaruh. Yang lebih mengkhawatirkan, tidak ada peringatan sama sekali — sesi berjalan normal, model menjawab tanpa instruksi proyek, tanpa notifikasi file dilewati.
Masalah serupa juga menimpa pengguna Bedrock dan Vertex karena flag tidak bisa resolve ke true di gateway pihak ketiga tersebut.
Workaround sementara: buat CLAUDE.md berisi satu baris @AGENTS.md. Pendekatan import ini tidak bergantung pada feature flag, sehingga file tetap terbaca meski telemetri dimatikan.