Terminal açık, proje klasörü hazır, bir de claude yazıyorsunuz. Birkaç saniye içinde yapay zeka projenizin tüm dosyalarını tarıyor, bağlamı kuruyor ve siz ne yapmak istediğinizi söyleyene kadar bekliyor. Claude Code tam olarak bu: IDE bağımsız, terminal tabanlı bir kodlama asistanı.
Bu rehber, Claude Code’a yeni başlayanlar için günlük kullanımda işe yarayan pratiklerden oluşuyor.
Başlamadan Önce: Neye İhtiyacınız Var?
Claude Code ücretsiz plan ile çalışmıyor. İki seçenek var:
Pro plan ($20/ay): En temiz başlangıç noktası. Kurulumdan sonra direkt kullanıma geçiyorsunuz.
API kredisi: platform.anthropic.com adresinden hesap açtığınızda yaklaşık $5 ücretsiz kredi geliyor. Aylık 50 oturumun altındaysanız abonelikten daha ekonomik.
Kurulum tek satır:
npm install -g @anthropic-ai/claude-code
API anahtarınızı kalıcı olarak tanıtın:
echo 'export ANTHROPIC_API_KEY="sk-ant-xxxxxxxx"' >> ~/.zshrc source ~/.zshrc
Proje klasörünüze girip claude yazmanız yeterli.
CLAUDE.md: Hafıza Sorununun Çözümü
Claude Code’un bilmesi gereken en kritik detay: her oturum sıfırdan başlar. Dün birlikte yazdığınız auth modülünü, hangi stack kullandığınızı, ne konuştuğunuzu bir sonraki oturumda bilmiyor.
CLAUDE.md bu sorunu çözüyor. Projeye girdiğinde otomatik okunan, bağlamı kuran bir talimat dosyası. Siz her seferinde projeyi yeniden anlatmak yerine Claude bu dosyayı okuyarak devam ediyor.
İki katmanlı çalışıyor:
- ~/.claude/CLAUDE.md — Sizin genel çalışma tarzınız, tüm projelerde geçerli
- /projeniz/CLAUDE.md — O projeye özel kurallar, takımla paylaşılır
Global dosyaya ne yazmalı: Projeden bağımsız, size özel tercihler.
## Genel Tercihler - Her zaman LTS/stable versiyonları kullan - Değişiklik yapmadan önce ne yapacağını söyle, onay al - Commit mesajları conventional commits formatında olsun - console.log bırakma - İzinsiz bağımlılık ekleme
Proje dosyasına ne yazmalı: O projeye özel, başka projede geçersiz bilgiler.
# Proje: Sipariş API ## Stack - Node.js 22 LTS, Express 5, TypeScript - PostgreSQL 17, Prisma ## Proje Durumu - Tamamlanan: Auth, ürün listeleme - Devam eden: Ödeme modülü - Sonraki: Bildirim sistemi
Büyük Projelerde Doğru Yaklaşım
“Şu projeyi yap” deyip tek seferde her şeyi yazdırmak cazip geliyor. Pratikte token maliyetini değil, hata maliyetini artırıyor.
2000 satır kod yazdırırsanız Claude 2000 satır yazar. Bir hata bulduğunuzda düzeltme istersiniz, Claude 2000 satırı tekrar okur. Bu döngü 3-4 kez dönerse maliyet katlanır. Modül modül ilerlerseniz her düzeltme sadece o modülün kodunu kapsar, maliyet küçük kalır, kontrol sizde kalır.
Doğru sıra şu:
1. Önce iskelet:
“Proje yapısını oluştur. Klasör yapısını kur, boş dosyaları yerleştir. Henüz kod yazma.”
2. Modül modül ilerle:
“Auth modülünü yaz. Sadece login ve register endpoint’i. Diğer modüllere geçme.”
3. Modül bitti, yeni oturum aç:
exit cd /projem && claude "CLAUDE.md'yi oku. Auth tamamlandı, şimdi ürün modülüne geçiyoruz."
Token Maliyetini Düşüren Küçük Detaylar
Claude’un her mesajında iki yön var: siz ne gönderdiniz (input), Claude ne yazdı (output). Output token, input token’dan genellikle birkaç kat daha pahalı. Yani Claude ne kadar çok açıklama yazarsa o kadar çok harcıyor.
CLAUDE.md’nize şunu eklerseniz her oturumda token tasarrufu yapıyorsunuz:
## Çalışma Stili - Açıklama yazma, direkt kodu yaz - Değişiklik öncesi sadece dosya adını ve ne yapacağını söyle - Bir modül bitmeden diğerine geçme
Bir de konuşma geçmişi var. Oturum uzadıkça her mesajda tüm geçmiş tekrar gönderiliyor. 50 mesajlık bir oturum 5 mesajlıktan çok daha pahalı. Modül bitti mi, yeni oturum açın.
Ertesi Gün Projeye Dönmek
Gün sonu CLAUDE.md’deki proje durumunu güncelleyin, git commit atın:
## Proje Durumu - Tamamlanan: Auth, ürün listeleme - Devam eden: Ödeme modülü (Stripe entegrasyonu yarım kaldı) - Bilinen sorunlar: Login rate limiting henüz yok
Ertesi sabah tek satırla devam:
"CLAUDE.md'yi oku, kaldığımız yerden devam et."
Claude dosyayı okur, ilgili kod dosyalarını tarar, bağlamı kurar. Sıfırdan anlatmak zorunda kalmazsınız.
Maliyet Beklentisi
API kredisi ile çalışıyorsanız modül bazlı tahmin şöyle:
- Küçük modül (auth, basit CRUD): $0.05 – $0.15
- Orta modül (ödeme entegrasyonu, bildirimler): $0.20 – $0.40
- Proje iskeleti: $0.10 – $0.20
$5 kredi ile 20-30 modül rahat çıkıyor. Gerçek kullanım alışkanlığınızı gördükten sonra Pro’ya geçip geçmeyeceğinize karar verirsiniz.
Sonuç
Claude Code’u verimli kullanmanın özü şu: Claude’a ne yapması gerektiğini değil, nasıl çalışması gerektiğini öğretin.
CLAUDE.md bunu kalıcı hale getiriyor. Global dosyada genel tercihlerinizi, proje dosyasında o projeye özel kuralları tutun. Modül modül ilerleyin, oturumları küçük tutun, proje durumunu güncel tutun.
Geri kalanını Claude hallediyor.
No comments