Rehber

Claude Code CLAUDE.md'yi dikkate almıyorsa: sebepler ve denetim

CLAUDE.md bağlamdır, zorunlu bir yapılandırma değildir: Claude dosyayı okur ve uymaya çalışır, ancak bunun garantisi yoktur. Bir talimat dikkate alınmıyorsa sebep genellikle dosyanın yüklenmemesi ya da talimatın belirsiz, çelişkili veya uzun bir dosyanın sonlarında olmasıdır.

Ahmet Karaca · 30 Ekim 2026

Claude Code neden CLAUDE.md'yi dikkate almıyor?

Anthropic'in belgeleri bu konuda açıktır. CLAUDE.md'nin içeriği sistem isteminden sonra bir kullanıcı mesajı olarak iletilir ve özellikle belirsiz ya da çelişkili talimatlarda tam uyum garanti edilmez. Her seferinde geçerli olması gereken bir talimat bu yüzden aşağıda anlatılan başka bir yöntem gerektirir.

Dosya yüklendi mi?

İlk denetlenecek şey budur; Claude'un göremediği bir dosyada ifadeyi düzeltmek işe yaramaz.

/context komutunu çalıştırıp Memory files bölümüne bakın. Açılışta yüklenmesi gereken dosyalar orada listelenir.
Alt klasördeki bir CLAUDE.md burada görünmez, çünkü Claude o klasördeki bir dosyayla çalışırken yüklenir. Yüklendiğinde terminalde dosyanın yolunu içeren bir Loaded satırı çıkar.
InstructionsLoaded hook'u hangi talimat dosyasının ne zaman ve neden yüklendiğini kaydedebilir; yola bağlı kurallarda ve alt klasör dosyalarında işe yarar.

Talimat yeterince açık mı?

Talimatlar, doğrulanabilecek kadar somut olduklarında en iyi sonucu verir.

Belirsiz	Somut
Kodu düzgün biçimlendir	2 boşluk girinti kullan
Değişikliklerini test et	Commit'ten önce `npm test` çalıştır
Dosyaları düzenli tut	API işleyicileri `src/api/handlers/` altındadır

İki talimat birbiriyle çelişiyor mu?

İki dosya aynı davranış için farklı yönlendirme veriyorsa Claude birini rastgele seçebilir. Çelişkiler CLAUDE.md dosyalarında, alt klasörlerdeki dosyalarda ve .claude/rules/ altında aranmalıdır.

Bir talimat, Claude Code'un kendi eklediği yönlendirmeyle de çakışabilir. Belgeler, commit ve pull request kuralları için yerleşik talimatların includeGitInstructions ayarıyla kapatılmasını, atıf metninin de attribution ile belirlenmesini öneriyor.

Dosya çok mu uzun?

Belgeler dosya başına 200 satırın altını öneriyor; daha uzun dosyalar daha fazla bağlam tüketir ve uyumu azaltır. Kod tabanının yalnız bir bölümünü ilgilendiren talimatlar, yalnız Claude eşleşen dosyalarla çalışırken yüklenen yola bağlı kurallara taşınabilir. @path ile içe aktarma düzeni kolaylaştırır ama bağlamı azaltmaz, çünkü içe aktarılan dosyalar da birlikte yüklenir.

İstek üzerine yüklenen dosyalar için bir sınır daha vardır. Dosya başına sınırı aşan bir alt klasör CLAUDE.md'si ya da kural dosyası Claude'a yalnız kısmen ulaşır; sonraki talimatlar Claude geri kalanını okuyana kadar bağlamda bulunmaz. 200K bağlam penceresinde sınır 40.000 karakterdir; macOS ve Linux'ta wc -m karakter sayısını gösterir.

Bir talimat her zaman geçerli olacaksa ne yapılmalı?

Hook kullanılmalıdır. Hook'lar oturumun belirli noktalarında kabuk komutu olarak çalışır ve Claude'un kararından bağımsız uygulanır; bu yüzden her commit'ten önce ya da her düzenlemeden sonra olması gereken işlere uygundur. Bir eylemi tamamen engellemek için belgeler PreToolUse hook'unu gösteriyor.

Bir dosyanın tamamı sistem istemi düzeyinde etkili olacaksa açılışta --append-system-prompt kullanılabilir; ancak bu seçenek etkileşimli kullanımdan çok betiklere uygundur.

Claude Code AGENTS.md'yi neden okumuyor?

Claude Code varsayılan olarak AGENTS.md dosyasını yalnız çalışma klasöründe ve üst klasörlerde CLAUDE.md, .claude/CLAUDE.md ya da CLAUDE.local.md yoksa okur; kişisel ~/.claude/CLAUDE.md bu hesaba girmez. Ayrıca v2.1.277 ya da sonrası gerekir. Denetlemek için /memory çalıştırılıp dosyanın yolu aranabilir. İçinde @AGENTS.md satırı bulunan bir CLAUDE.md iki dosyayı da geçerli kılar.

Kaynaklar, kontrol tarihi: 30 Ekim 2026

Coredence nerede devreye giriyor

Bir dosya, doğru olmaktan çıktığında da uygulanmaz olur; elle yazılan talimatlar zamanla gerçek çalışma biçiminden uzaklaşır. Coredence kendi oturumlarını, commit'lerini ve notlarını okuyor, onları doğdukları izlere bağlı anılara dönüştürüp pekiştiriyor. Davranışın bir anıyla çeliştiğinde üzerine yazmak yerine hangisinin doğru olduğunu sana soruyor. Sonuç Claude Code'a her oturumda yüklenen bir beceri olarak ulaşı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