Claude Code, CLAUDE.md bulunmadığında artık AGENTS.md dosyasını okuyor

Claude Code'a AGENTS.md fallback'i eklendi

Anthropic'in terminal tabanlı kodlama agent'i Claude Code, bir depoda CLAUDE.md bulunmadığında proje talimatlarının kaynağı olarak artık AGENTS.md dosyasını okuyor. Bu değişiklik resmi Claude Code changelog'unun en yeni kaydında yer alıyor ve Hacker News ana sayfasında öne çıkarıldı.

Fallback nasıl çalışıyor

Changelog'a göre bu davranış bir yerine getirme değil, bir fallback. Halihazırda CLAUDE.md içeren projeler tam olarak önceki gibi çalışmaya devam ediyor; yalnızca bu dosya yoksa agent bunun yerine AGENTS.md dosyasını arıyor. Geliştiriciler, hangi dosyanın proje talimat kaynağı sayılacağını /config menüsündeki "Project instructions" ayarından görüntüleyebilir veya değiştirebilir.

Dağıtımla ilgili bir uyarı var: changelog, bu özelliğin henüz Claude Code'un Bedrock, Vertex ve Foundry sürümlerinde bulunmadığını belirtiyor; yani aracı bu kurumsal kanallar üzerinden çalıştıran ekipler bunu şimdilik göremeyecek.

Depo başına tek talimat dosyasına doğru

AGENTS.md, depo düzeyinde agent talimatları için yükselen bir standart: genellikle repo kökünde bulunan, yapım komutlarını, kod stilini ve bir yapay zeka asistanının uyması gereken kısıtlamaları belgeleyen düz bir Markdown dosyası. En büyük cazibesi taşınabilirliği. Birden fazla asistanı destekleyen depolar çoğu zaman her araç için ayrı bir özel dosya bulundurmak zorunda kalıyordu — Claude Code için CLAUDE.md ya da Cursor için .cursorrules gibi — ve aynı yönergeler tekrarlanıyor, zamanla birbirinden kopma riski taşıyordu.

AGENTS.md dosyasını tanıyarak Claude Code, bir deponun tek bir kanonik talimat dosyası bulundurmasını ve yalnızca bir araç için CLAUDE.md kopyası bakımını yapmasını gereksiz kılıyor. Yerel dosya varlığında önceliği koruduğu için bu değişiklik geriye dönük uyumlu: kimse geçiş yapmak zorunda değil, ancak yeni projeler ve çok araçlı ekipler baştan itibaren AGENTS.md üzerinde standartlaşabilir.

Sürüme dahil edilen diğer değişiklikler

Aynı changelog kaydı bir dizi başka değişiklik de içeriyor. Yeni bir ortam değişkeni olan CLAUDE_GATEWAY_PROXY_IS_EGRESS_BOUNDARY=1, tek çıkış yolunun bir forward proxy olduğu Claude apps gateway kurulumlarını hedefliyor: bu değişken ayarlandığında, giden isteler ana makine adını yerel olarak çözmek yerine proxy'ye iletiyor. Gateway upstream'leri ayrıca artık bir sağlayıcının önünde çalışan proxy için statik bir headers haritası tanımlayabiliyor.

Düzeltme tarafında ise sürüm oldukça kapsamlı. claude -p ile başlatılan headless çalıştırmalar ve Agent SDK oturumları, bir iç hatadan sonra artık sonuç vermeden beklemiyor; hatayı bildirip çıkış kodu 1 ile sonlanıyorlar. Eski bir paketli CLI'nin, örneğin bir IDE uzantısı içinde dağıtılanın, güncel sürümle birlikte çalıştığında kullanıcıları oturumdan çıkaran bir hata düzeltildi. Ayrıca uzun bir plugin, sandbox ve render düzeltmesi listesinin yanı sıra ~/.claude içindeki hatalı biçimlendirilmiş değerlerin ve terminal renk kodları içeren prompt'ların tetiklediği çökmeler de dahil olmak üzere çok sayıda crash giderildi.

Neden önemli

Talimat dosyası parçalanması, bakımcılar için sessiz bir yük olageldi: her araç kendi dosyasını istiyordu ve bunları eşit tutmak manuel bir işti. Alanın en önde gelen kodlama agent'lerinden birinin AGENTS.md'yi fallback olarak okuması, ekosistemi; depo talimatlarının bir kez yazılıp geliştiricinin hangi asistanı açarsa açsın dikkate alındığı, tek bir ortak standarda doğru itiyor.

Tasarım tercihi en az özellik kadar önemli. Anthropic, geçiş yerine uyumluluğu seçti ve CLAUDE.md önceliğini koruyarak benimseme maliyetini sıfıra indirirken AGENTS.md'yi yeni depolar için güvenli bir varsayılan haline getirdi. Yakın vadedeki boşluk ise Bedrock, Vertex ve Foundry üzerindeki kurumsal dağıtımlar; onlar özelliğin kendi kanallarına ulaşmasını beklemek zorunda kalacak.