CLAUDE.md Rehberi: Claude Code'u Projenize Nasıl Tanıtırsınız?

CLAUDE.md nedir?

CLAUDE.md, Claude Code'un bir projeye başladığında otomatik olarak yüklediği bağlam dosyasıdır. Geliştirici takımının proje mimarisini, kodlama standartlarını, önemli uyarıları ve sık kullanılan komutları bu dosyaya yazması; Claude'un her oturumda yeniden öğrenmek zorunda kalmadan projeye uygun hareket etmesini sağlar.

Hiyerarşik yüklenme

Claude Code, CLAUDE.md dosyalarını birden fazla konumdan yükler ve hepsini birleştirir. Kullanıcı düzeyindeki ~/.claude/CLAUDE.md dosyası tüm projelerde geçerli kişisel tercihleri barındırır. Proje kökündeki CLAUDE.md takım genelinde paylaşılan standartları içerir. Alt dizinlerdeki CLAUDE.md dosyaları ise o dizine özgü ek talimatlar sağlar.

• Kullanıcı düzeyi: Kişisel tarz, tercih edilen dil veya genel güvenlik uyarıları.
• Proje düzeyi: Mimari kararlar, yasak kütüphaneler, test çerçevesi standartları.
• Alt dizin düzeyi: Backend ve frontend gibi farklı katmanlara özel kurallar.

CLAUDE.md'ye ne yazılmalı?

En değerli içerikler şunlardır: projeyi çalıştırma ve test etme komutları, mimari genel bakış ve ana modüllerin açıklaması, yasaklanan kalıplar veya kütüphaneler, kodlama standartları ve stil kılavuzu, ortam kurulumu ve önemli environment variable'lar. Dokümantasyon yazmak yerine Claude'a talimat verir gibi kısa, doğrudan cümleler kullanmak daha etkili sonuç verir.

Pratik şablonlar

İyi bir CLAUDE.md şunları içerir: ## Proje başlığı altında tek cümle açıklama, ## Komutlar altında build/test/lint komutları, ## Mimari altında ana dizin yapısı, ## Kurallar altında yasak ve zorunlu pratikler, ## Güvenlik altında dokunulmaması gereken dosyalar veya servisler. Dosya uzunluğu genellikle 50-200 satır arasında kalmalıdır; çok uzun CLAUDE.md dosyaları bağlam penceresini doldurup daha acil içerikleri dışarıda bırakabilir.

Ekip için faydalar

CLAUDE.md proje repository'sine eklendiğinde tüm ekip üyeleri ve CI/CD ortamları aynı Claude davranışını alır. Yeni geliştirici onboarding'i de hızlanır: Claude, projeyi yeni üyeye açıklarken CLAUDE.md bağlamını temel alır. Bu nedenle iyi yazılmış bir CLAUDE.md aslında canlı bir teknik rehber işlevi görür.

Kaynaklar

Bu rehber Claude Code memory dokümantasyonu temel alınarak hazırlanmıştır.