CLAUDE.md dosyası nedir, nasıl yazılır? Hazır şablonla
CLAUDE.md, Claude Code'un her oturumda okuduğu ve projenin kurallarını öğrendiği bir not dosyası. Ne işe yaradığını, içine ne yazılacağını ve kopyalayıp kullanabileceğin Türkçe bir şablonu paylaştık.
Yapay TU Editör · 2 dk okuma
CLAUDE.md, proje klasörünün içinde duran ve Claude Code'un her oturumun başında otomatik okuduğu sade bir metin dosyası. İçine projenin ne olduğu, hangi komutlarla çalıştırıldığı, kod yazım kuralları ve kaçınılması gereken şeyler yazılır. Böylece her seferinde aynı şeyleri tekrar anlatmana gerek kalmaz. Claude Code'da /init komutu bu dosyanın ilk taslağını otomatik oluşturur.
Claude Code ile çalışmaya başlayan herkes bir süre sonra aynı şeyi fark ediyor: her yeni oturumda aynı şeyleri anlatıyorsun. "Bu proje Türkçe bir site, İngilizce metin yazma." "Testleri şu komutla çalıştır." "Şu klasöre dokunma." Claude Code her oturumu sıfırdan başlattığı için dünkü konuşmayı hatırlamıyor.
CLAUDE.md bu sorunun çözümü. Projenin kalıcı hafızası gibi düşünebilirsin.
CLAUDE.md nasıl çalışıyor
Proje klasörüne CLAUDE.md adında bir dosya koyduğunda, Claude Code her oturumun başında bu dosyayı otomatik olarak okur ve içindekileri kural olarak kabul eder. Dosya sade bir metin; .md uzantısı Markdown formatında olduğunu gösteriyor, yani başlıklar için #, maddeler için - kullanıyorsun.
Üç seviyede kullanılabiliyor:
- Proje klasöründe: Sadece o projeye özel kurallar. En yaygın kullanım.
- Kullanıcı klasöründe (
~/.claude/CLAUDE.md): Tüm projelerinde geçerli kişisel tercihler. Örneğin "benimle her zaman Türkçe konuş." - Alt klasörlerde: Büyük projelerde belli bir bölüme özel kurallar.
En hızlı başlangıç: /init
Elle yazmak zorunda değilsin. Claude Code'u proje klasöründe başlatıp şunu yaz:
/init
Claude Code projeyi inceler ve bir CLAUDE.md taslağı oluşturur. Bu taslak genelde iyi bir başlangıçtır, ama her zaman kendi bildiklerinle düzenlemen gerekir; çünkü projenin yazılı olmayan kurallarını sadece sen biliyorsun.
İçine ne yazılmalı
İyi bir CLAUDE.md beş soruya cevap verir:
- Bu proje ne? Bir iki cümlelik özet.
- Nasıl çalıştırılır? Kurulum, başlatma, test komutları.
- Nasıl yazılır? Kod stili, isimlendirme, dil tercihi.
- Nelere dokunulmaz? Hassas dosyalar, canlı sistemler, gizli bilgiler.
- İş nasıl bitmiş sayılır? Değişiklikten sonra neyin kontrol edileceği.
Kopyalayıp kullanabileceğin şablon
Aşağıdaki şablonu kendi projene göre düzenleyebilirsin:
# Proje: Kişisel blog sitesi
Türkçe bir blog. Statik site, framework yok. Yazılar icerik/ klasöründe.
## Komutlar
- Siteyi oluştur: node build.mjs
- Yerelde aç: npx serve dist
## Kurallar
- Sitedeki tüm metinler Türkçe.
- Yeni bağımlılık eklemeden önce sor.
- Mevcut kodun stilini taklit et; yorum satırı az olsun.
## Dokunma
- .env dosyası ve içindeki anahtarlar
- dist/ klasörü (otomatik üretiliyor, elle düzenleme)
## Bitirmeden önce
- Siteyi yeniden oluştur ve hata olmadığını kontrol et.
- Ne değiştirdiğini kısaca özetle.
Sık yapılan hatalar
Çok uzun yazmak. Dosya her oturumda okunuyor. On sayfalık bir CLAUDE.md hem kotanı yer hem de önemli kuralları kalabalığın içinde kaybettirir. Kısa ve net yaz.
Belirsiz kurallar. "Kodu temiz yaz" bir kural değil, bir dilek. "Fonksiyonlar 40 satırı geçmesin" bir kural.
Kodda zaten olanı tekrarlamak. Klasör yapısını uzun uzun anlatmana gerek yok; Claude Code bunu kendisi görebiliyor. Senin bildiğin ama koddan anlaşılmayan şeyleri yaz.
Güncellememek. Proje değiştikçe dosya eskir. Claude Code bir konuda tekrar tekrar hata yapıyorsa, bu genelde CLAUDE.md'ye bir satır eklemen gerektiğinin işareti.
Hazır bir başlangıç noktası
Dünyada en çok kullanılan CLAUDE.md dosyalarından biri, Andrej Karpathy'nin yapay zekâyla kod yazma gözlemlerinden derlenen ve GitHub'da 217 binden fazla yıldız alan dosya. Claude'a önce düşünmeyi, sade kalmayı ve sadece gerekeni değiştirmeyi öğretiyor. Kurulumunu Claude'u uçuran 5 ücretsiz GitHub reposu yazımızda bulabilirsin.
Sık sorulanlar
CLAUDE.md dosyası nereye konur?
En yaygın yer projenin ana klasörü. Ayrıca kullanıcı klasöründeki .claude dizinine konan bir CLAUDE.md tüm projelerde geçerli genel kuralları tutar. Alt klasörlere konan dosyalar da o klasöre özel kurallar için kullanılabilir.
CLAUDE.md ne kadar uzun olmalı?
Kısa olması daha iyi. Her oturumda okunduğu için uzun bir dosya her seferinde token harcar ve önemli kurallar kalabalıkta kaybolur. Genelde bir iki sayfayı geçmeyen, madde madde bir dosya yeterli.
Bu dosyayı ChatGPT ile de kullanabilir miyim?
Doğrudan değil, çünkü CLAUDE.md Claude Code'a özel bir dosya adı. Ama içindeki kuralları ChatGPT'nin özel talimatlar bölümüne ya da bir sohbetin başına yapıştırarak benzer bir etki elde edebilirsin.
Haftada bir e-posta. Sadece işe yarayanlar.
Haftanın en iyi yapay zekâ araçları ve yeni rehberler. Reklam yok, istediğin an çık.
İyi prompt yazmanın 7 kuralı (örneklerle)
