Anla Dene

Claude · Gelişmiş · 201 Claude Code temeli · Konu 5 / 10

3.5 CLAUDE.md ve /init

Projeni bir kez anlat, her oturumda hatırlasın.

Bu sayfada ne öğreneceksin

Kısaca

Resmî dokümana göre her oturum yeni bir bağlam penceresiyle başlar ve oturumlar arasında bilgi taşıyan iki mekanizma vardır: senin yazdığın CLAUDE.md dosyaları ve Claude'un kendi tuttuğu otomatik bellek (auto memory).

CLAUDE.md, proje klasörünün köküne koyduğun bir Markdown dosyasıdır. Claude Code onu her oturum başında otomatik okur. Dokümana göre dosyanın içeriği sistem isteminin parçası olarak değil, sistem isteminden sonra bir kullanıcı mesajı olarak iletilir.

En önemli ayrım: CLAUDE.md bağlamdır, zorlanan bir ayar değildir. Dokümana göre Claude bu dosyaları bağlam olarak ele alır; kuralı kesin uygulama garantisi yoktur. Doküman uzun dosyaların daha çok bağlam tükettiğini ve uyumu düşürdüğünü söylüyor. Dosya ne kadar sadeyse Claude onun o kadarını izler.

Adım adım

  1. /init ile başla, sonra sadeleştir. Resmî best-practices sayfasına göre /init kod tabanından başlangıç sürümünü üretir; ondan sonraki iş çoğunlukla satır silmektir. Claude'u hangi konuda sürekli düzeltmen gerektiğini gördükçe yalnızca gerekli bilgileri tut.
  2. Hazır olunca /init çalıştır. Claude Code'u proje klasöründe aç ve /init yaz. Dokümana göre Claude kod tabanını inceler ve keşfettiği derleme komutlarını, test talimatlarını ve proje kurallarını içeren bir başlangıç CLAUDE.md oluşturur. Dosya zaten varsa üzerine yazmaz, iyileştirme önerir. Beklenen sonuç: proje kökünde bir CLAUDE.md.
  3. Dosyayı oku ve düzelt. Dokümana göre oradan sonra Claude'un kendi başına bulamayacağı talimatlarla geliştir. Yanlış ya da gereksiz satırı sil.
  4. Yerini bil. Proje dosyası ./CLAUDE.md ya da ./.claude/CLAUDE.md yolunda durabilir. Aşağıdaki tabloda dört kapsam var.
  5. Doğru şeyleri yaz. Her oturumda Claude'un bilmesi gereken gerçekler: derleme ve test komutları, kurallar, proje yapısı, "her zaman şunu yap" türü kurallar. Dokümana göre çok adımlı bir prosedür ya da kod tabanının yalnızca bir bölümünü ilgilendiren bilgi CLAUDE.md'ye değil skill'e ya da yola özel kurala (.claude/rules/) gider.
  6. Kuralı ölçülebilir yaz. "Düzgün biçimlendir" yerine "iki boşluk girinti kullan". Vurgu eklemek (ÖNEMLİ, MUTLAKA gibi) çoğunlukla Claude'un kuralı aşırı uygulamasına yol açar; kuralı düz ve net yaz. İstisnasız olması gereken kural için hook ya da deny kuralı kullan.
  7. Yüklendiğini doğrula. Oturum içinde /context yaz ve Memory files listesine bak. /memory ise CLAUDE.md dosyalarını listeler ve editörde açar.
  8. Düzeltmeleri dosyaya işle. Claude'u aynı konuda tekrar tekrar düzeltiyorsan ona açıkça "bunu CLAUDE.md'ye ekle" de. Güncelliğini yitirmiş ya da çelişen satırları sil.

CLAUDE.md nerede durur

Dokümana göre dosya birkaç yerde olabilir ve hepsi birlikte yüklenir (birbirinin üzerine yazmaz):

KapsamKonumKimle paylaşılır
Kurum politikası (Managed policy)İşletim sistemine göre sabit bir sistem yolu; BT ya da DevOps yönetirKuruluştaki herkes
Kullanıcı (User)~/.claude/CLAUDE.mdYalnızca sen, tüm projelerde
Proje (Project)./CLAUDE.md ya da ./.claude/CLAUDE.mdEkip, kaynak kontrol (git) ile
Yerel (Local)./CLAUDE.local.md (.gitignore'a ekle)Yalnızca sen, yalnızca bu proje

Proje dosyası kaynak kontrolle ekiple paylaşılır; böylece ekip de yararlanır. Kişisel tercihlerin için kullanıcı ya da yerel dosyayı kullan. Büyük dosyayı parçalamak için dosya içinde @dosya/yolu ile başka dosyaları içe aktarabilirsin; ama içe aktarılan dosyalar da başlangıçta yüklenir, yani bağlam yükünü azaltmaz, sadece düzen sağlar. Projede AGENTS.md varsa Claude Code bazı koşullarda onu CLAUDE.md yerine okuyabilir; ayrıntı için dokümana bak.

Katı kural nereye yazılır

Kurs, her kuralın önce CLAUDE.md'ye ait olup olmadığını sormanı söylüyor. "Asla main dalına push etme" gibi tehlikeli bir kuralı CLAUDE.md'ye yazarsan Claude'un okuyup uyacağını umarsın. Çoğu zaman uyar, ama "çoğu zaman" bu kadar tehlikeli bir şey için yetmez. Dokümanın çözümü: bir eylemi Claude ne karar verirse versin engellemek istiyorsan PreToolUse hook kullan. Hook, Claude bir eylemi yapmadan önce çalışan koddur ve eylemi gerçekten engelleyebilir.

Hazır prompt

Önce Claude Code'u proje klasöründe başlat, sonra oturum içinde şunu yaz:

/init

Kural eklemek için (kurgusal örnek):

Bunu CLAUDE.md dosyasına ekle: yeni sayfaları sayfalar/ klasörüne, her sayfa için ayrı bir dosya olarak koy.

Kurgusal "kafe-menu" projesi için sade bir CLAUDE.md taslağı (kendi projene göre değiştir):

# Proje
Bu proje, bir kafenin menüsünü gösteren küçük bir web sayfasıdır (index.html, stil.css).

# Komutlar
- Testleri çalıştır: npm test

# Kurallar
- İki boşluk girinti kullan.
- Yeni sayfaları sayfalar/ klasörüne, her sayfa için ayrı dosya olarak ekle.
- Renkleri doğrudan yazma, stil.css içindeki değişkenleri kullan.

README'deki bilgiler de yüklensin: @README.md

Dosya yüklendi mi diye bakmak için (oturum içinde):

/context

Sık yapılan hata

Video

Video: yakında.

Kaynak

Son doğrulama: 2026-11-02

Anla Dene bağımsız bir eğitim sitesidir; Anthropic, OpenAI ya da Google ile bağlantılı değildir. Ürün adları sahiplerine aittir.

anladene.com · Anla Dene Akademi · Gizlilik