--- title: "Claude Code ve Codex'te AGENTS.md kullan" description: "Codex varsayılan olarak AGENTS.md dosyasını okur. Claude Code 2.1.277 ve sonrası, projende CLAUDE.md yoksa onu okur. İkisini birden tutmak için CLAUDE.md dosyana @AGENTS.md ekle." canonical: "https://logbrew.co/tr/guides/agents-md" last_updated: "2026-11-10" --- # Claude Code ve Codex'te AGENTS.md kullan Codex varsayılan olarak `AGENTS.md` dosyasını okur. Claude Code 2.1.277 ve sonrası, projende `CLAUDE.md` yoksa onu okur. İkisini birden tutmak için `CLAUDE.md` dosyana `@AGENTS.md` ekle. 10 Kasım 2026 tarihinde Claude Code 2.1.319 ve Codex CLI 0.167.0 ile test edildi [Furkan Erday](https://github.com/furkanerday) tarafından. Furkan Erday, LogBrew'un kurucusu. LogBrew'u her gün Claude Code ve Codex ile geliştiriyor. Canonical: https://logbrew.co/tr/guides/agents-md ## Her ajan `AGENTS.md` dosyasını ne zaman yükler | Projendeki dosyalar | Claude Code | Codex | | --- | --- | --- | | Yalnızca `AGENTS.md` | Yüklendi | Yüklendi | | `AGENTS.md` ve `CLAUDE.md` | Atlandı | Yüklendi | | `@AGENTS.md` içe aktaran bir `CLAUDE.md` | Yüklendi | Yüklendi | | `AGENTS.md` dosyasına sembolik bağlantı olan `CLAUDE.md` | Yüklendi | Yüklendi | | `AGENTS.md` ve `CLAUDE.local.md` | Atlandı | Yüklendi | Her ajanın ilk isteğiyle gönderdiği talimatları okuduk. ## İki ajan için 1 dosya kur ### AGENTS.md dosyasını proje kökünde yaz Build komutlarını, test komutlarını ve kod kurallarını 1 dosyaya koy. İki ajan da onu Git deponun kökünden bulunduğun klasöre kadar okur. ### Claude Code'u güncelle Claude Code, 2.1.277 sürümünden itibaren `AGENTS.md` dosyasını kendisi okur. Eski sürümlerde sonraki adımdaki içe aktarma gerekir. ```bash claude update ``` ### AGENTS.md dosyasını CLAUDE.md içinden içe aktar Bulunduğun klasörde ya da üst klasörlerde bir `CLAUDE.md`, `.claude/CLAUDE.md` veya `CLAUDE.local.md` varsa Claude Code `AGENTS.md` dosyasını okumaz. İkisini birden yüklemek için `CLAUDE.md` dosyana bu satırı ekle. ```bash @AGENTS.md ``` ### Ya da CLAUDE.md'yi AGENTS.md'ye bağla `CLAUDE.md` dosyan yalnızca içe aktarma satırını içerecekse onun yerine sembolik bağlantı yap. ```bash ln -s AGENTS.md CLAUDE.md ``` ### Ya da ikisini bir ayarla yükle Bir `CLAUDE.local.md` tutup yine de `AGENTS.md` dosyasını yüklemek için bunu `~/.claude/settings.json` dosyasına ekle. Oturum içinde `/config` altındaki Project instructions seçeneği aynı değeri ayarlar. ```bash { "pluginConfigs": { "cc-plugin-agents-md@builtin": { "options": { "instructionFiles": "claude-md-and-agents-md" } } } } ``` ### Codex'in neyi yüklediğini kontrol et Bunu çalıştığın klasörde çalıştır. Codex dokümantasyonu, Codex yüklediği talimatları geri söylesin diye bu komutu verir. ```bash codex --ask-for-approval never "Summarize the current instructions." ``` ## Test ederken gördüklerimiz İki ajanı da yerel bir test sunucusuna yönlendirdik ve her birinin ilk isteğiyle gönderdiği talimatları okuduk. Böylece her ajanın hangi dosyaları yüklediği tam olarak görünür. Projede `CLAUDE.md` yokken Claude Code `AGENTS.md` dosyasını yükledi ve debug logu `no CLAUDE.md found; AGENTS.md loaded` yazdı. Yanında bir `CLAUDE.md` varken Claude Code `AGENTS.md` dosyasını atladı. `@AGENTS.md` içe aktarmasıyla ya da sembolik bağlantıyla `AGENTS.md` metni tam olarak bir kez göründü. Yukarıdaki `pluginConfigs` ayarı, projede bir `CLAUDE.local.md` varken de iki dosyayı yükledi. Codex önce `~/.codex/AGENTS.md`, sonra kökteki `AGENTS.md`, sonra bulunduğun klasördeki dosyayı yükledi. Bir `AGENTS.override.md`, kendi klasöründeki `AGENTS.md` dosyasının yerini aldı. Codex, biz `project_doc_fallback_filenames` listesine ekleyene kadar `CLAUDE.md` dosyasını atladı. İki dosya da varken Codex, yedek dosya adı ayarlı olsa bile yalnızca `AGENTS.md` dosyasını yükledi. ## AGENTS.md mi CLAUDE.md mi Codex her klasörde `AGENTS.override.md` ya da `AGENTS.md` dosyasını, ayrıca genel `~/.codex/AGENTS.md` dosyasını okur. Varsayılan toplam sınır 32 KiB'dir. `CLAUDE.md` dosyasını yalnızca `project_doc_fallback_filenames` içinde listelersen okur. Claude Code önce `CLAUDE.md` dosyasını okur. `AGENTS.md` ve `.claude/AGENTS.md` dosyalarını yalnızca geçerli bir proje `CLAUDE.md` dosyası yoksa okur. Kişisel `~/.claude/CLAUDE.md` dosyan bu kurala girmez, bu yüzden `AGENTS.md` ile birlikte yüklenir. ## GitHub kayıtları ne diyor 409 yorumlu #6235, Claude Code'dan AGENTS.md desteği istedi. Bir Anthropic mühendisi 17 Ağustos 2026'da kaydı yukarıdaki içe aktarma ve sembolik bağlantı çözümüyle kapattı. Claude Code artık dosyayı kendisi okuyor. #31005 ayrıca `.agents/skills/` desteği istiyor ve hâlâ açık. ## Sık sorulan sorular ### Claude Code AGENTS.md okur mu? Evet, 2.1.277 sürümünden itibaren okur. Bunun için bulunduğun klasörde ya da üst klasörlerde `CLAUDE.md`, `.claude/CLAUDE.md` veya `CLAUDE.local.md` olmamalı. Bunu 2.1.319 sürümünde doğruladık. ### AGENTS.md mi kullanmalıyım, CLAUDE.md mi? Ekibinde Codex ya da başka bir ajan kullanan biri varsa `AGENTS.md` kullan. `CLAUDE.md` dosyasını yalnızca Claude Code'a özel kurallar için tut ve içinden `@AGENTS.md` ile içe aktar. ### CLAUDE.md dosyasını AGENTS.md'ye sembolik bağlantıyla bağlayabilir miyim? Evet. Testimizde Claude Code bağlı dosyayı içe aktarmadaki gibi bir kez yükledi. ### Codex CLAUDE.md okur mu? Varsayılan olarak okumaz. `~/.codex/config.toml` dosyasına `project_doc_fallback_filenames = ["CLAUDE.md"]` ekle. ## Canlı ortam hatalarını ajanına ver LogBrew MCP sunucusunu bağla, Claude Code ya da Codex onayladığın projelerin hatalarını, loglarını ve trace'lerini okusun. Cömert ücretsiz planla başla, kart gerekmez. [Ajanını bağla](https://logbrew.co/tr/agents) ## Kaynaklar - [Claude Code docs, How Claude remembers your project](https://code.claude.com/docs/en/memory#agents-md) - [Codex docs, Custom instructions with AGENTS.md](https://learn.chatgpt.com/docs/agent-configuration/agents-md) - [anthropics/claude-code#6235](https://github.com/anthropics/claude-code/issues/6235) - [anthropics/claude-code#31005](https://github.com/anthropics/claude-code/issues/31005) ## AI kodlama ajanları için diğer rehberler - [Claude Code ve Codex'e MCP sunucusu ekle](https://logbrew.co/tr/guides/mcp-server-claude-code-codex) - [Claude overloaded 529 ve rate limit 429 hatalarını çöz](https://logbrew.co/tr/guides/claude-overloaded-rate-limit-error) - [Claude Code, Codex ve tarayıcı JavaScript'indeki hataları çöz](https://logbrew.co/tr/guides)