CLAUDE.md dosyası

Claude Code’un en kullanışlı özelliklerinden biri CLAUDE.md dosyasıdır. Claude Code’a projen hakkında kalıcı bir bellek kazandırır.

Ders videosu

Hangi sorunu çözer?

CLAUDE.md olmadan Claude Code’u açtığında, her seferinde sıfırdan başlar. Şunları yeniden yapması gerekir:

• Codebase’ini yeniden keşfetmek
• Hangi dependency’lerin gerektiğini çıkarmak
• Hangi feature’ların zaten implement edildiğini anlamak

Bazen varsayımlar yapar, bu da Claude’u doğru yöne çekmeni zorlaştırır.

CLAUDE.md bunu çözer. Projenin root dizinine koyduğun bir Markdown dosyasıdır ve Claude Code her session başlangıcında otomatik olarak okur. Bunu codebase’in için bir onboarding script’i olarak düşün — CLAUDE.md’nin içeriği prompt’una eklenir.

Bir örnek

Tipik bir CLAUDE.md şöyle görünür:

# Proje

Bu, App Router, Tailwind ve Drizzle ORM kullanan bir Next.js 15 uygulamasıdır.

# Komutlar
- Dev server: `pnpm dev`
- Testleri çalıştır: `pnpm test`
- Lint: `pnpm lint`

# Code Style
- 2-space indentation kullan
- Named export tercih et
- Tüm API route'ları `app/api/` altında olacak
- Mümkün olduğunda API route yerine server action kullan

Düz ve basit. Artık Claude Code’a bir React component oluşturmasını söylediğinde, stil için Tailwind kullanmasını ve code convention’larına uymasını zaten biliyor olacak.

CLAUDE.md takımlar içindir

CLAUDE.md’yi version control’a (git’e) commit edebilir ve etmelisin de — böylece tüm ekibin faydalanır. Aslında bellek dosyalarında bir hiyerarşi var:

Seviye	Yer	Kim için
Project-level CLAUDE.md	Projenin root dizini	Ekiple paylaşılır
User-level CLAUDE.md	Configuration klasörün	Sadece sen — tüm projelerine uygulanır. Kişisel tercihlerini buraya koy.

İpuçları

Düzeltmeleri belleğe kaydet

Kendini Claude’u tekrar tekrar düzeltirken bulursan — örneğin “her zaman API route yerine server action kullan” diyor olsan — Claude’a bu kuralı belleğe kaydetmesini açıkça söyle. Bir sonraki açılışta bilecek.

Proje dökümanlarına referans ver

Projende Claude’un başvurmasını istediğin dökümantasyon varsa, @ sembolü ile dosya yolunu kullan:

## README.md

Daha fazla bilgi gerekirse oku: @README.md

Önce CLAUDE.md olmadan başla

CLAUDE.md’siz başlamanı öneririz — böylece hangi alanlarda sürekli course-correct etmen gerektiğini görürsün. Bu, CLAUDE.md’ni kompakt ve sadece gerekli bilgiye odaklı tutmana yardım eder.

Hazır olduğunda /init komutunu çalıştır — Claude senin için bir CLAUDE.md oluşturur.

Özet

Frustrating (sinir bozucu) bir Claude Code session’ı ile verimli bir session arasındaki fark çoğu zaman context’e iner — ve CLAUDE.md o context’i sağlamanın yoludur. Stack’inle, tercihlerinle ve komutlarınla başla, oradan ilerle.

Sırada ne var?

Bir sonraki derste subagent’ları işleyeceğiz — context yönetimini ve uzmanlaşmış görevleri ana ajandan ayırmanın güçlü bir yolu.