Claude Code telemetri kapalıyken yerel AGENTS.md dosyasını sessizce atlıyor
Öne çıkanlar
- Telemetri veya zorunlu olmayan ağ trafiği kapatıldığında AGENTS.md dosyası uyarı verilmeden atlanıyor.
- Yerel dosya okuma işlemi, varsayılan olarak kapalı gelen tengu_agents_md_mod adlı uzaktan sunucu bayrağına bağımlı çalışıyor.
- Bedrock, Vertex AI veya proxy kullanan geliştiriciler de bayrağa erişemedikleri için aynı sorunu yaşıyor.
- Sorun, proje dizinine '@AGENTS.md' içeren tek satırlık bir CLAUDE.md dosyası konularak aşılabiliyor.
Claude Code yazılımının 2.1.277 sürümünde kullanıma sunulan AGENTS.md proje talimatları desteğinin, telemetri veya zorunlu olmayan ağ trafiği kapatıldığında devre dışı kaldığı belirlendi. Yapılan teknik incelemeler, yerel diskteki bir dosyayı okuma işlevinin sunucu taraflı bir özellik bayrağına (feature flag) bağlandığını ortaya koydu. Sistem ağ üzerinden bu bayrağı alamadığında, yerel talimat dosyası herhangi bir uyarı verilmeden yok sayılıyor.
Araştırma, 'CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC' veya 'DISABLE_TELEMETRY' ortam değişkenleri tanımlandığında 'agents-md' eklentisinin otomatik olarak kapalı kaldığını gösterdi. Yapılan testlerde, değişkenlere sıfır değeri verilmesinin ya da proje ayarlarına eklenmesinin durumu çözmediği kaydedildi. Ayrıca Amazon Bedrock, Google Cloud Vertex AI veya üçüncü taraf ağ geçitleri kullanan kurumsal ekiplerin de sunucu bayrağına erişemediği için aynı sessiz hatayla karşılaştığı aktarıldı.
Kullanıcılar sorunun üstesinden gelmek için geçici bir çözüm geliştirdi. Telemetri kapalıyken talimatları yüklemek isteyenlerin, proje dizinine '@AGENTS.md' satırını içeren tek satırlık bir CLAUDE.md dosyası eklemesi gerekiyor. Gizlilik ayarlarının yerel dosya işleme mekanizmalarını sessizce bozmaması gerektiğini belirten kullanıcılar, Anthropic'in kademeli dağıtım denetimlerini yerel özelliklerden ayırmasını veya açık bir hata mesajı sunmasını bekliyor.
Bu özet yapay zekâ ile hazırlanmıştır; ayrıntılar ve doğrulama için orijinal kaynağa başvurun.