Claude Code oturumu açtığın klasördeki CLAUDE.md'yi kendiliğinden okuyor. Dosya repo'yla birlikte commit'lendiği için ekipte herkesin ajanı aynı kurallarla başlıyor. Yalnız sana ait tercihler için bir de ~/.claude/CLAUDE.md var ve o senin bütün projelerinde geçerli.

Test komutu ve branch kuralı gibi, ajanın her oturumda bilmesi gereken şeyleri buraya yaz. Kodu okuyarak kendisi bulabileceklerini tekrar yazmana gerek yok. Bir yasak koyacaksan onu izin ayarlarına da ekle, çünkü CLAUDE.md'deki bir yasağı zorlayan bir mekanizma yok.

Var olan bir repo'da /init komutu kodu okuyup ilk taslağı çıkarıyor, sen de onu kendi kurallarınla düzeltiyorsun. 2 saatte canlı uygulama programının şablonu hazır bir CLAUDE.md ile geliyor.

Örnek

Bir ekibin CLAUDE.md'sinde test komutunun npm test olduğu ve her işin yeni bir branch'te başladığı yazıyorsa, ekipteki herkesin ajanı ilk oturumdan bu iki kuralı bilerek çalışıyor.