AnswersPublished18 sources
Claude Code artık CLAUDE.md yoksa AGENTS.md okuyabiliyor
18 Eylül 2026 tarihli Claude Code 2.1.277, projede CLAUDE.md yoksa AGENTS.md dosyasını proje yönergeleri olarak okuyabiliyor. Özellik, /config içindeki “Project instructions” ayarından değiştirilebiliyor; Bedrock, Vertex ve Foundry dağıtımlarında henüz desteklenmiyor.
YayımlayanGPT-5.6 Terra ile düzenlendiGörseller GPT Image 2 ile oluşturuldu
Research answer
Key takeaways
- 18 Eylül 2026 tarihli Claude Code 2.1.277, projede CLAUDE.md yoksa AGENTS.md dosyasını proje yönergeleri olarak okuyabiliyor.
- Özellik, /config içindeki “Project instructions” ayarından değiştirilebiliyor; Bedrock, Vertex ve Foundry dağıtımlarında henüz desteklenmiyor.
- AGENTS.md depo düzeyinde ortak yönergeler içindir; SKILL.md ise isteğe bağlı, yeniden kullanılabilir uzmanlık paketlerini tanımlar.
AI Prompt
openai.comCreate a landscape editorial hero image for this Studio Global article: What changed in Claude Code version 2.1.277, released on September 18, 2026, regarding support for the open AGENTS.md project-instructions f. Article summary: Claude Code 2.1.277 adds native, opt-in-configurable fallback support for `AGENTS.md`: a repository without `CLAUDE.md` can now supply Claude Code’s project instructions through the shared open format instead. It is a fa. Topic tags: general, general web, user generated. Style: premium digital editorial illustration, source-backed research mood, clean composition, high detail, modern web publication hero. Use reference image context only for broad subject, composition, and topical grounding; do not copy the exact image. Avoid: logos, brand marks, copyrighted characters, real person likenesses, fake screenshots, UI text, readable text, watermarks, charts with fa
Claude Code 2.1.277 ile birlikte açık AGENTS.md yönerge biçimi için yerel destek geldi. Varsayılan senaryoda, projede CLAUDE.md yoksa Claude Code proje yönergelerini AGENTS.md dosyasından okuyor. Böylece ortak ajan yönergesi kullanan depoların, yalnızca Claude Code için ayrıca bir dosya oluşturması gerekmiyor. 1
Geri dönüş kuralı nasıl çalışıyor?
Sürüm notlarının açıkladığı varsayılan davranış basit:
- Projede
CLAUDE.mdyoksa: Claude Code, proje yönergeleri içinAGENTS.mdkullanabiliyor.1
- Projede
CLAUDE.mdvarsa:CLAUDE.md, Claude Code’un yerleşik proje-yönerge dosyası olmaya devam ediyor. Sürüm duyurusunda, varsayılan davranışta iki dosyanın otomatik olarak birleştirileceği belirtilmiyor.
Bu davranış, Claude Code içindeki /config komutunda yer alan Project instructions bölümünden etkinleştirilebiliyor veya değiştirilebiliyor. Anthropic, özelliğin Amazon Bedrock, Google Vertex AI ve Azure AI Foundry üzerindeki Claude Code dağıtımlarında henüz desteklenmediğini söylüyor. 1
AGENTS.md nedir ve neden önemli?
AGENTS.md, kodlama ajanlarına depoya özgü bağlam ve talimat vermek için kullanılan açık, Markdown tabanlı bir biçim. Kısaca, “ajanlar için README” olarak düşünülebilir. Proje yapısı, kurulum adımları, derleme ve test komutları, kodlama kuralları ve katkı beklentileri gibi bilgileri içerebilir. 19
32
Biçim; OpenAI Codex, Amp, Google Jules, Cursor ve Factory’nin de dahil olduğu ekosistemler arası bir iş birliğinden doğdu. Bugün Linux Foundation bünyesindeki Agentic AI Foundation tarafından yönetiliyor. Proje, 60 binden fazla açık kaynak depoda kullanıldığını bildiriyor. 19
21
Listelenen ekosistemde OpenAI Codex, Google Jules, Cursor, GitHub Copilot’un coding agent’ı, Gemini CLI, Aider, Zed, Warp, VS Code, Devin, JetBrains Junie, Factory, Goose ve OpenCode gibi araçlar bulunuyor. Yine de her aracın dosya bulma, alt dizin kuralları ve öncelik sırası farklı olabileceğinden, dosyanın depoda bulunması tüm araçlarda aynı şekilde yükleneceği anlamına gelmiyor. 19
Ekipler için pratik kazanım
Claude Code yerel destek sunmadan önce, AGENTS.md standardını benimseyen ekiplerin genellikle ayrı bir CLAUDE.md tutması gerekiyordu. Alternatif olarak CLAUDE.md dosyasını AGENTS.mdye sembolik bağlantı yapıyor ya da yalnızca ortak dosyayı içe aktaran küçük bir CLAUDE.md oluşturuyorlardı. Önceki rehberler, Claude Code AGENTS.mdyi doğrudan okumadığı için bu içe aktarma ve sembolik bağlantı yöntemlerini geçici çözüm olarak öneriyordu. 10
Yeni geri dönüş desteği, Claude’a özgü ek yönergelere ihtiyaç duymayan depolarda bu bakım yükünü azaltıyor. Tek bir ortak dosya, hem Claude Code’a hem de uyumlu diğer araçlara temel çalışma kurallarını sağlayabiliyor.
Bu, bütün yönerge sistemlerinin artık tamamen eşdeğer olduğu anlamına gelmiyor. Ekiplerin her kodlama ajanının dosyaları nasıl keşfettiğini, dizine özel yönergeleri nasıl uyguladığını ve çakışmaları nasıl çözdüğünü doğrulaması hâlâ önemli.
AGENTS.md ve SKILL.md aynı şey değil
AGENTS.md ile SKILL.md birbirinin alternatifi değil; farklı amaçlara hizmet eden tamamlayıcı biçimler.
AGENTS.md, belirli bir depoda çalışmak için kalıcı, depo düzeyindeki bağlamı ve kuralları taşır.19
32
SKILL.md, yeniden kullanılabilir bir Agent Skill paketinin parçasıdır. Bu paket; yönergeler, meta veriler ve isteğe bağlı destekleyici kaynaklar içerebilir. Claude, ilgili olduğunda özel iş akışları veya alan bilgisi sağlamak için skill’leri kullanır.33
Claude Code, skill’lerinin araçlar arası Agent Skills standardını izlediğini belirtiyor. Dokümantasyondaki bir proje skill’i örneği, .claude/skills/<ad>/SKILL.md biçiminde kendi klasöründe yer alıyor. 37
39
Devam eden sınırlamalar
Bu sürüm bir yönerge dosyası geri dönüş mekanizması ekliyor; tüm ajan kurallarıyla evrensel uyumluluk getirmiyor.
Örneğin Claude Code’un belgelenmiş proje skill konumu .claude/skills/<ad>/SKILL.md. 2.1.277 değişiklik notu AGENTS.md proje yönergelerini kapsıyor, ancak .agents/skills/ klasörünün keşfedileceğini duyurmuyor. 1
37
Aynı şekilde, belgelenen varsayılan geri dönüş davranışı CLAUDE.md ile AGENTS.md için otomatik bir birleştirme kuralı olarak görülmemeli. Bir depo hem taşınabilir ortak kurallara hem Claude’a özel davranışlara ihtiyaç duyuyorsa, dosyalar arasındaki ilişkiyi açıkça tanımlamak daha güvenli olur.
Mevcut Claude Code projeleri için önerilen düzen
Halihazırda CLAUDE.md kullanan bir proje için mantıklı yaklaşım şu olabilir:
- Araçtan bağımsız, genel depo kurallarını
AGENTS.mdiçinde tutun. - Claude Code’a özgü yönergeleri
CLAUDE.mdiçinde bırakın. - Gerektiğinde
CLAUDE.mdiçinden ortak rehbere açıkça atıf yapın veya onu içe aktarın; iki dosyanın kendiliğinden birlikte yükleneceğini varsaymayın.
Bu düzen, ortak kuralların taşınabilirliğini korurken Claude’a özel iş akışlarını ayrı tutar. Claude Code 2.1.277 bu nedenle önemli bir birlikte çalışabilirlik adımı: CLAUDE.md bulunmadığında, AGENTS.md öncelikli bir depo Claude Code ile de çalışabilir. Ancak yönerge ve skill keşif kurallarının tüm araçlarda artık aynı olduğu sonucu çıkarılmamalı.
Studio Global AI
Continue your research
This page includes a source-backed answer you can continue inside Studio Global.
People also ask
What is the short answer to "Claude Code artık CLAUDE.md yoksa AGENTS.md okuyabiliyor"?
18 Eylül 2026 tarihli Claude Code 2.1.277, projede CLAUDE.md yoksa AGENTS.md dosyasını proje yönergeleri olarak okuyabiliyor.
What are the key points to validate first?
18 Eylül 2026 tarihli Claude Code 2.1.277, projede CLAUDE.md yoksa AGENTS.md dosyasını proje yönergeleri olarak okuyabiliyor. Özellik, /config içindeki “Project instructions” ayarından değiştirilebiliyor; Bedrock, Vertex ve Foundry dağıtımlarında henüz desteklenmiyor.
What should I do next in practice?
AGENTS.md depo düzeyinde ortak yönergeler içindir; SKILL.md ise isteğe bağlı, yeniden kullanılabilir uzmanlık paketlerini tanımlar.