cn claudenews Ara /
Modül 2 · Getting Hands On · ⏱ 10 dakika

Proje kurulumu

Project setup

Bu derste neler öğreneceksin

  • Claude Code'u doğru dizinden başlatmanın neden önemli olduğunu kavramak
  • .gitignore, node_modules ve büyük dosyaların context'e taşma riskini azaltmak
  • İlk oturumda projenin haritasını çıkartmak

Claude Code, başlatıldığı dizini projenin kökü olarak kabul eder. Bu basit gerçek, deneyiminin %50’sini belirler.

1. Doğru kökten başla

claude komutunu mutlaka repo kökünde çalıştır:

cd ~/projects/my-app
claude

Eğer alt klasörde başlatırsan Claude:

  • Üstteki package.json, tsconfig.json, CLAUDE.md’yi göremez
  • Sister modüllere ulaşamaz
  • Build/test komutları yanlış yerden çalışır

2. Gürültüyü temizle

Claude codebase’i keşfederken .gitignore ve .claudeignore (varsa) kurallarına saygı duyar — ama her şeyi otomatik dışlamaz. Şunları gözden geçir:

  • node_modules/ → kesinlikle ignore
  • dist/, build/, .next/ → ignore
  • *.log → ignore
  • secrets/, .env* → kesinlikle ignore
  • Büyük binary/asset klasörleri → genelde ignore

.gitignore zaten doğruysa ekstra iş yok. Değilse .claudeignore ile özelinde dışlayabilirsin.

3. Projenin haritasını çıkart

İlk oturumda harika bir prompt:

Bu repo'nun yüksek seviye yapısına bak. Hangi dilde, hangi framework'lerde,
hangi ana klasörler ne yapıyor? Tek paragrafta özetle.

Claude muhtemelen şunları yapacak:

  • Glob "**/package.json" veya **/pyproject.toml
  • Read README.md
  • Birkaç Grep ile entry point’leri arar
  • Özet döner

Bu özetin bir kısmı mental modelini kalibre eder; sonraki promptların buna dayanır.

4. CLAUDE.md var mı?

Repo kökünde CLAUDE.md dosyası varsa, Claude her oturumda otomatik okur. Yoksa, şimdi oluşturmak geleceğin için en iyi yatırım:

# Claude'a kendisi oluşturtabilirsin:
> /init

Veya manuel yaz: stack, çalışma kuralları, test komutları, deploy nasıl yapılır, hangi konvansiyonlar var.

5. Mevcut araçları doğrula

Claude’un erişebileceği shell’i kontrol et:

Bu projede testler nasıl çalıştırılır? npm test mi, başka bir komut mu?
Cevabını CLAUDE.md'de yoksa README.md'ye veya package.json scripts'e bakarak ver.

Claude doğru komutu bulduğunda zihninde kalıcı bir bağ kurar — sonraki “testleri çalıştır” promptlarında otomatik kullanır (oturum içinde).

Özet

  • Repo kökünden başlat
  • .gitignore / .claudeignore ile gürültüyü temizle
  • İlk promptla harita çıkar
  • CLAUDE.md varsa kullan, yoksa /init ile oluştur
  • Test/build/lint komutlarını oturumda doğrula

Sırada ne var?

Bir sonraki derste context eklemek — Claude’un gözlemleyemediği bilgileri (issue, doc, screenshot, kalıp) ona nasıl aktaracağımıza bakacağız.