CLAUDE.md ve memory
Repo kuralları (CLAUDE.md), kullanıcı kuralları (~/.claude/CLAUDE.md), .claude/rules ve memory arasındaki farkları context layering ile gör.
Öğreneceklerin
- CLAUDE.md, rules ve memory arasındaki sınırı kavra
- Hangi katmanın hangi katmanı ezdiğini anla
- Kuralları nereye yazman gerektiğine karar ver
Claude Code oturumu açtığında karşına gelen bütün “context” tek bir yerden gelmez. Birden fazla katman üst üste binmiş halde model’e enjekte edilir. Bunu doğru kullanmazsan kurallar çakışır, bazıları boşa gider.
Katmanlar
1. Sistem promptu — Anthropic tarafından sabit. Tool tanımları, güvenlik kuralları, varsayılan davranış. Senin elinde değil, ama bilmen iyi: temeli o belirler.
2. CLAUDE.md (repo) — Repo kökünde. Bu repo’ya özel kurallar: tech stack, test komutu, dosya organizasyonu, “yapma” listesi, “yap” listesi. Her oturumda otomatik yüklenir. ≤200 satır tut, daha uzunsa katı sınırlar konulmalı (Anthropic’in kendi tavsiyesi).
3. .claude/rules/*.md — CLAUDE.md çok şişerse parçalara böl. Her dosya bir konu (örn. testing.md, git-flow.md, style.md). CLAUDE.md @.claude/rules/testing.md ile referans verebilir veya rules otomatik yüklenir (ayar fark eder).
4. ~/.claude/CLAUDE.md (kullanıcı) — Senin kişisel tercihlerin. “Türkçe yanıt ver”, “kod yorumu yazma”, “her zaman plan mode’da başla” gibi. Tüm projelerde geçerli.
5. Memory — Kalıcı not defteri. /remember veya programatik olarak yazılan, oturumlar arası kalan, kullanıcı bazlı bilgiler. CLAUDE.md “kural” iken memory “öğrenilmiş gerçek”.
6. Turn (kullanıcı promptu + tool çıktıları) — Şu anki konuşma. En değişken, en güçlü.
Hangi katmana ne yazılır
| Yer | Ne yaz |
|---|---|
CLAUDE.md (repo) | Bu repo’ya özel: stack, komutlar, “test’i şu klasöre koy” |
.claude/rules/*.md | CLAUDE.md > 200 satır olunca konu bazlı bölme |
~/.claude/CLAUDE.md | Kişisel tercihler, dil, yazım stili |
memory (/remember) | Tek seferlik öğrenilen gerçek (örn. “DB ismi app_prod”) |
| Turn promptu | Geri kalan her şey |
Çakışma kuralı
İki katman aynı şeyi farklı söylüyorsa alt katman kazanır. Yani anlık prompt > memory > kullanıcı CLAUDE.md > rules > repo CLAUDE.md > sistem.
İpucu: CLAUDE.md güncellersen oturumu yeniden başlat — yeni kurallar yüklü gelsin.
Sıradaki
Slash commands ve built-in komutları göreceğiz: hazır olanlar (/help, /compact, /review…) + kendi .claude/commands/*.md ile özel komut nasıl yazılır.