Rehber

CLAUDE.md, AGENTS.md, GEMINI.md: hangi araç hangi dosyayı okur

Her kodlama ajanı kendi talimat dosyasını okur, çoğu AGENTS.md dosyasını da okuyabilir. Bir depo tek bir ortak AGENTS.md tutup yalnız tek bir aracın ihtiyaç duyduğu şeyleri ekleyebilir. Kişisel tercihler ise ev klasöründe ayrı bir dosyada durmalıdır.

Ahmet Karaca · 30 Ekim 2026

Hangi araç hangi dosyayı okur?

Araç	Proje dosyası	Kişisel dosya	AGENTS.md
Claude Code	`CLAUDE.md`	`~/.claude/CLAUDE.md`	Projede `CLAUDE.md` yoksa okur
Codex	`AGENTS.md`	`~/.codex/AGENTS.md`	Kendi biçimi
Cursor	`.cursor/rules/*.mdc`	Ayarlardaki kullanıcı kuralları	Okur
VS Code'da Copilot	`.github/copilot-instructions.md`	`~/.copilot/copilot-instructions.md`	Okur
Gemini CLI	`GEMINI.md`	`~/.gemini/GEMINI.md`	`context.fileName` ile ayarlanırsa okur

Her dosyanın kendi rehberi var: CLAUDE.md, AGENTS.md, Cursor kuralları, Copilot talimatları ve GEMINI.md.

Birkaç araç tek dosyayı nasıl paylaşır?

Ortak talimatları AGENTS.md dosyasında tutmak, kopya oluşturmadan çoğu araca ulaşır. İki araç için ek bir adım gerekir.

Claude Code AGENTS.md dosyasını kendiliğinden yalnız projede CLAUDE.md yoksa okur. Varsa ortak dosyayı içe aktaran bir CLAUDE.md, Claude'a ikisini birden verir ve Claude Code'a özgü talimatlara da yer bırakır:

@AGENTS.md

## Claude Code

src/billing/ altındaki değişikliklerde plan modunu kullan.

CLAUDE.md dosyasından AGENTS.md dosyasına sembolik bağ da kullanılabilir; ancak projede Windows kullanan biri varsa belgeler içe aktarmayı öneriyor, çünkü orada bu bağlar yönetici hakkı ya da Geliştirici Modu gerektiriyor.

Gemini CLI için dosya adının settings.json içinde belirtilmesi gerekir:

{
  "context": {
    "fileName": ["AGENTS.md", "GEMINI.md"]
  }
}

Proje dosyasına ne, kişisel dosyaya ne yazılır?

Proje dosyası, kodda çalışan herkes için geçerli olanı tutar: komutlar, kurallar, dokunulmayacak dosyalar. Depoya girer ve paylaşılır. Kişisel dosya ise senin nasıl çalışmayı tercih ettiğini tutar; her projede seninle gelir ve çalışma arkadaşlarına dayatılmaz.

Ortak bir depoya giren kişisel tercih herkesin talimatı olur; kişisel dosyada tutulan bir proje komutu ise başkalarında eksik kalır.

Bir dosya neden bazen etkisiz kalır?

Bu dosyalar zorunlu ayar değil, model için bağlamdır; bu yüzden ilk adım dosyanın yüklendiğini doğrulamaktır: Claude Code'da /context, Gemini CLI'da /memory show. Claude Code için sebepler ve denetimler CLAUDE.md'nin dikkate alınmaması rehberinde yer alıyor.

Kaynaklar, kontrol tarihi: 30 Ekim 2026

Coredence nerede devreye giriyor

Ortak bir AGENTS.md projeyle ilgili kısmı çözer. Kişisel dosyalar ise her araç için ayrı kopyalar olarak kalır ve zamanla birbirinden ayrılır. Coredence kendi oturumlarından, commit'lerinden ve notlarından nasıl çalıştığına dair tek bir kayıt oluşturuyor ve açtığın her aracın kişisel dosyasına yazıyor: ~/.codex/AGENTS.md, ~/.gemini/GEMINI.md ve ~/.copilot/copilot-instructions.md. Bunu kendi işaretli bölümünde yapıyor, senin yazdıklarına dokunmuyor. Claude Code bunu bir beceri olarak alıyor.

Coredence macOS 14 ve sonrası (Apple silicon) ile Windows 10 ve sonrasında çalışıyor; Coredence hesabı gerekmiyor. Pekiştirme için bir model gerekiyor ve onu sen seçiyorsun: Claude Code aboneliğin, kendi API anahtarın ya da Ollama ile yerel bir model. Bu yollarla Coredence'ın kendisi ücretsiz. Açık kaynak değil, kendi ücretli planları da henüz satışta değil.

Tarayıcında dene