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
- CLAUDE.md'nin ne işe yaradığını, nerede durduğunu ve
/init'in ne yaptığını - İçine ne yazılacağını ve kuralların nasıl yazılırsa tutacağını
- CLAUDE.md'nin bir bağlam olduğunu, zorlanan bir ayar olmadığını ve katı kuralın nereye yazılacağını
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
- /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.
- Hazır olunca
/initçalıştır. Claude Code'u proje klasöründe aç ve/inityaz. 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. - 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.
- Yerini bil. Proje dosyası
./CLAUDE.mdya da./.claude/CLAUDE.mdyolunda durabilir. Aşağıdaki tabloda dört kapsam var. - 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. - 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.
- Yüklendiğini doğrula. Oturum içinde
/contextyaz ve Memory files listesine bak./memoryise CLAUDE.md dosyalarını listeler ve editörde açar. - 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):
| Kapsam | Konum | Kimle paylaşılır |
|---|---|---|
| Kurum politikası (Managed policy) | İşletim sistemine göre sabit bir sistem yolu; BT ya da DevOps yönetir | Kuruluştaki herkes |
| Kullanıcı (User) | ~/.claude/CLAUDE.md | Yalnızca sen, tüm projelerde |
| Proje (Project) | ./CLAUDE.md ya da ./.claude/CLAUDE.md | Ekip, 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
- Her sorunda bir kural ekleyip dosyayı şişirmek. Dosya uzadıkça Claude kuralların bir kısmını gözden kaçırır. Kısa tut, işe yaramayan satırı sil. Dokümanda dosya uzunluğu için bir öneri var; güncel değeri memory sayfasında oku.
- "En iyi uygulamaları izle" gibi belirsiz kural yazmak. Kontrol edemeyeceğin kuralı Claude da kontrol edemez. "Yeni API yollarını src/api/handlers içine, her yol için ayrı dosya olarak koy" gibi yaz.
- Çelişen talimatlar bırakmak. Dokümana göre iki talimat birbiriyle çelişirse Claude birini rastgele seçebilir. CLAUDE.md dosyalarını arada gözden geçir.
- Zorunlu kuralı sadece CLAUDE.md'ye yazmak. Mutlaka engellenmesi gereken eylem için hook kullan.
- Sohbette verdiğin kuralın kalıcı olacağını sanmak. Yalnızca konuşmada söylediğin talimat bağlam sıkıştırılınca kaybolabilir. Kalıcı olmasını istiyorsan CLAUDE.md'ye ekle.
- Gizli bilgiyi dosyaya yazmak. Proje CLAUDE.md'si ekiple paylaşılan bir dosyadır. Bu yüzden parola ya da anahtar yazma (bizim önerimiz).
Video
Video: yakında.
Kaynak
- Anthropic Academy, Claude Code 101: The CLAUDE.md file (sorun, örnek, ekip kullanımı, ipuçları, /init)
- Anthropic Academy, Claude Code in Action: A CLAUDE.md that follows (rehberlik mi zorlama mı, dört konum, import, kuralı nasıl yazmalı)
- Claude Code dokümanı: How Claude remembers your project (konumlar, /init, /memory, /context, bağlam olarak ele alma, hook ile zorlama, sorun giderme)
- Claude Code dokümanı: How Claude Code works (sıkıştırma sonrası kalıcı kurallar)
Son doğrulama: 2026-11-02