Claude Code'a native AGENTS.md desteği geldi; varsayılan olarak CLAUDE.md öncelikli

Anthropic'in terminal tabanlı kodlama ajanı Claude Code artık AGENTS.md dosyasını native olarak okuyor. dev.to'da yayımlanan bir yazıya göre bu değişiklik 18 Eylül'de geldi ve araçlar arası talimat standardı desteğindeki son boşluklardan birini sessizce kapattı — ancak varsayılan davranış basit bir "artık çalışıyor" cümlesinden daha ince ayrıntılı.

AGENTS.md nedir

AGENTS.md, yapay zekâ kodlama ajanları için bir kılavuz görevi gören, açık ve araçtan bağımsız bir Markdown dosyasıdır: projenin nasıl derleneceğini ve test edileceğini, hangi stil kurallarının geçerli olduğunu, hangi dizinlerin yasak olduğunu ve dağıtımların nasıl yapıldığını kaydeder. Depo kökünde ya da monorepolerde alt dizinlerin içinde yer alır ve dev.to'ya göre Codex, Cursor, Gemini CLI ve Copilot dahil yirmiden fazla araç tarafından zaten okunmaktadır. Amaç, satıcıya özel talimat dosyaları yığınını — CLAUDE.md, .cursorrules, .github/copilot-instructions.md — her ajanın okuyabileceği, tescil şemasi ya da özel sözdizimi olmayan tek bir düz belgeyle değiştirmektir.

Şimdiye kadar bu düzeni isteyen Claude Code kullanıcıları boşluğu kendileri kapatmak zorundaydı. dev.to yazısı yaygın geçici çözümleri sıralıyor: CLAUDE.md'yi AGENTS.md'ye sembolik bağla bağlamak (bazı dosya sistemlerinde ve checkout'larda bozuluyordu), kayıt sırasında bir dosyayı diğerine ekleyen betikler çalıştırmak, tek işi dosyayı bağlama (context) enjekte etmek olan topluluk eklentileri kurmak ya da iki dosyayı elle tutturmak ve birbirlerinden kopmamalarını ummak.

Birleşme değil, fallback

Yeni desteğin kilit ayrıntısı, birleşme (merge) değil fallback olarak çalışmasıdır. Claude Code çalışma dizinini ve onun üstündeki tüm üst dizinleri kontrol eder; o zincirin herhangi bir yerinde bir CLAUDE.md varsa AGENTS.md tamamen yok sayılır. Yalnızca kapsam içinde hiç CLAUDE.md olmadığında Claude Code bunun yerine AGENTS.md'yi okur. Özellik yerleşik bir eklenti olarak uygulanmıştır; davranışın sabit kodlanmış değil yapılandırılabilir olması bu yüzdendir.

Kullanıcılar bunu /config menüsündeki "Project instructions" altından değiştirebilir; dört mod vardır:

• claude-md-or-agents-md (varsayılan): çalışma dizininin üstünde herhangi bir yerde CLAUDE.md varsa onu oku, yoksa AGENTS.md'ye düş.
• claude-md-and-agents-md: her iki dosyayı da yükle; talimatlar çakıştığında CLAUDE.md öncelik alır.
• claude-md: AGENTS.md'yi tamamen yok say; 2.1.277 sürümünden önceki davranışla aynı.
• managed-only: kurumsal uyumluluk kurulumlarına yönelik olarak, depoya işlenmiş ve özel talimat dosyalarını bırakıp kurum tarafından yönetilen yapılandırmayı tercih et.

Monorepolar ve kaba kenarlar

Yalnızca CLAUDE.md'yi AGENTS.md'ye sembolik bağla bağlayan tek depolu kurulumlar varsayılan modda bu bağı kaldırabilir. Monorepolar bu kadar şanslı değil. Örneğin apps/api/ içindeki iç içe bir AGENTS.md, ağacın daha üstünde herhangi bir CLAUDE.md varsa devralınmaz; çünkü fallback kontrolü her aramada ayrı ayrı yapılır ve üstteki dosya kazanır. dev.to'ya göre bu durum için belgelenmiş yöntem, iç içe AGENTS.md'nin yanına onu bir @AGENTS.md referansıyla içe aktaran küçük bir CLAUDE.md koymak ya da claude-md-and-agents-md moduna geçerek her iki dosyanın her yerde yüklenmesini sağlamaktır.

CLAUDE.md ile tam eşdeğer olduğunu varsaymadan önce dikkat edilmesi gereken başka sınırlamalar da var. Destek henüz Bedrock, Vertex veya Foundry dağıtımlarında mevcut değil. İç içe AGENTS.md dosyaları dosya okumalarında bağlama ekleniyor ancak context compaction sonrası geri yüklenmiyor, /memory içinde görünmüyor ve --add-dir ile eklenen dizinler kendi AGENTS.md'lerini hiç katmıyor.

Neden önemli

Tek ajan çalıştıran bir ekip için pek bir şey değişmez. Değer, birden çok ajan tek bir depoyu paylaştığı anda ortaya çıkar — bir görev sınıfı için Claude Code, bir başkası için Cursor veya Codex ajanı, artı bir CI ile tetiklenen inceleyici — ve dev.to yazısı bunun giderek standart hâline geldiğini savunuyor. Kökte yalnızca bir AGENTS.md ile gelen bir depo artık sıfır yapılandırmayla Claude Code, Cursor, Codex ve Copilot tarafından aynı şekilde okunuyor.

Geriye kalan karar çoğunlukla mevcut Claude Code kullanıcılarına ait. Çoğunda zaten bir CLAUDE.md bulunduğundan, varsayılan mod Claude Code'un o dosyayı okumaya devam etmesi, diğer tüm araçların ise AGENTS.md okuması anlamına geliyor ve ikisinin bilinçli olarak eşitlenmesi gerekiyor. dev.to yazısında önerilen yaklaşım, AGENTS.md'yi herkesin aldığı araçlar arası temel olarak görmek ve CLAUDE.md'yi Claude'a özel ek unsurlar — hook yapılandırması ve izin modları gibi — için saklamak; bunu claude-md-and-agents-md ya da açık bir içe aktarmayla katmanlamak. Bir kez ve bilinçli olarak verilen bu karar, "bu araç aslında hangi talimat dosyasını okuyor" sorusunun tekrarlayan bir mesele olmasını engelliyor.