Claude Code Kullanım Kılavuzu

Claude Code Nedir?

Claude Code, Anthropic tarafından geliştirilen, geliştiricilere yazılım mühendisliği görevlerinde yardımcı olan interaktif bir komut satırı aracıdır. Kod yazma, hata ayıklama, refactoring ve daha fazlası için yapay zeka destekli çözümler sunar.

Yenilik: Claude Sonnet 4.5 model desteği ile daha güçlü analiz ve kod üretimi!

Başlangıç

Kurulum

Claude Code’u yüklemek için:

npm install -g @anthropic-ai/claude-code

İlk Kullanım

Claude Code’u başlatmak için:

claude

İpucu: Yardım almak için /help komutunu kullanabilirsiniz.

Temel Özellikler

Kod Analizi

Mevcut kod tabanlarını anlama ve analiz etme. Claude Code, projenizi inceleyerek yapı ve mantığı kavrar.

Hata Ayıklama

Hataları hızlıca bulma ve düzeltme. Otomatik test çalıştırma ve sorun giderme.

Kod Yazma

Yeni özellikler ekleme, fonksiyonlar yazma ve kod oluşturma.

Refactoring

Kodu iyileştirme, optimize etme ve daha okunabilir hale getirme.

Test Yönetimi

Test yazma, çalıştırma ve test kapsamını artırma.

Dokümantasyon

Kod için açıklama ve dokümantasyon oluşturma.

Gelişmiş Özellikler

Plan Modu

Kod çalıştırmadan önce güvenli analiz ve planlama yapmanızı sağlar. Değişiklik yapmadan önce stratejinizi gözden geçirebilirsiniz.

Extended Thinking

Karmaşık problemler için daha derin düşünme ve analiz. Zor görevlerde daha iyi sonuçlar elde edersiniz.

Paralel Oturumlar

Git worktree’leri kullanarak aynı anda birden fazla görev üzerinde çalışma.

Özel Slash Komutları

Projeye özel otomasyon komutları oluşturma. Sık kullanılan işlemleri tek komutla gerçekleştirin.

/review-pr 123 – Pull request inceleme
/deploy prod – Deployment işlemi

Entegrasyonlar

GitHub Actions: CI/CD pipeline’ları ile entegrasyon
GitLab CI/CD: GitLab otomasyonu
VS Code: VS Code editör entegrasyonu
JetBrains IDEs: IntelliJ, PyCharm vb. desteği
AWS Bedrock: AWS altyapısında çalışma
Google Vertex AI: Google Cloud entegrasyonu
MCP Sunucuları: Model Context Protocol desteği

Genişletilebilirlik

Subagents (Alt Ajanlar)

Belirli görevler için özelleştirilmiş yapay zeka ajanları oluşturabilirsiniz.

Plugins (Eklentiler)

Yeniden kullanılabilir bileşenler ve yetenekler ile Claude Code’u genişletin.

Skills (Yetenekler)

Sınırlı araç erişimi ile odaklanmış yetenekler geliştirin.

Yaygın Kullanım Senaryoları

Yeni kod tabanını anlama: “Bu projenin yapısını açıkla”
Hata düzeltme: “Auth sistemindeki hatayı bul ve düzelt”
Özellik ekleme: “Kullanıcı profili sayfası ekle”
Kod iyileştirme: “Bu fonksiyonu optimize et”
Test yazma: “calculateTotal fonksiyonu için test yaz”
Refactoring: “Bu komponenti daha modüler hale getir”
Git işlemleri: “Değişiklikleri commit et”
Pull request oluşturma: “Bu branch için PR oluştur”

İpuçları ve En İyi Pratikler

Net Talimatlar: Claude Code’a ne istediğinizi açıkça belirtin. Detaylı açıklamalar daha iyi sonuçlar verir.

Adım Adım İlerleyin: Büyük görevleri küçük parçalara bölün. Claude Code her adımı takip edebilir.

Kodu Gözden Geçirin: Claude Code’un önerilerini her zaman inceleyin ve test edin.

Context Sağlayın: İlgili dosyaları ve bilgileri paylaşın. Daha fazla context, daha iyi sonuçlar demektir.

Güvenlik

Claude Code kullanırken güvenlik en önemli önceliklerden biridir:

Hassas bilgileri (.env, credentials) commit etmemeye dikkat edin
Sandbox modu ile güvenli test ortamı oluşturun
IAM yapılandırması ile erişim kontrolü sağlayın
Kod değişikliklerini her zaman gözden geçirin
SQL injection, XSS gibi güvenlik açıklarına dikkat edin

Slash Komutlar Referansı

Claude Code’da kullanabileceğiniz yerleşik komutlar:

Komut	Açıklama	Örnek Kullanım
`/help`	Yardım menüsünü gösterir	`/help`
`/clear`	Konuşma geçmişini temizler	`/clear`
`/reset`	Oturumu sıfırlar	`/reset`
`/exit`	Claude Code’dan çıkar	`/exit`
`/model`	Model seçimini değiştirir	`/model sonnet`
`/settings`	Ayarları görüntüler/düzenler	`/settings`

Özel Slash Komutları Oluşturma

.claude/commands/ dizininde Markdown dosyaları oluşturarak kendi komutlarınızı tanımlayabilirsiniz.

Örnek: .claude/commands/review-pr.md

---
description: "Pull request'i incele"
---

Şu PR'ı detaylıca incele: {{ args[0] }}
- Kod kalitesini kontrol et
- Güvenlik açıklarını ara
- Test coverage'ı kontrol et

Konfigürasyon ve Ayarlar

settings.json Dosyası

Claude Code ayarları ~/.config/claude-code/settings.json dosyasında saklanır.

Model Ayarları ▼

{
  "defaultModel": "sonnet",
  "models": {
    "sonnet": "claude-sonnet-4-5-20250929",
    "opus": "claude-opus-4-20250514",
    "haiku": "claude-3-5-haiku-20241022"
  }
}

API Ayarları ▼

{
  "apiKey": "your-api-key-here",
  "apiEndpoint": "https://api.anthropic.com",
  "timeout": 120000,
  "maxRetries": 3
}

Uyarı: API anahtarınızı asla public repository’lerde paylaşmayın!

Güvenlik Ayarları ÖNEMLİ ▼

{
  "sandbox": {
    "enabled": true,
    "allowedCommands": ["npm", "git", "node"],
    "blockedPaths": ["/etc", "/sys", "/proc"]
  },
  "gitSafety": {
    "preventForceP push": true,
    "requireCommitReview": true
  }
}

UI ve Davranış Ayarları ▼

{
  "ui": {
    "theme": "dark",
    "showLineNumbers": true,
    "syntaxHighlighting": true
  },
  "behavior": {
    "autoSave": true,
    "verboseLogging": false,
    "confirmDestructiveActions": true
  }
}

Ortam Değişkenleri

Değişken	Açıklama	Örnek
`ANTHROPIC_API_KEY`	API anahtarı	`sk-ant-...`
`CLAUDE_MODEL`	Varsayılan model	`sonnet`
`CLAUDE_SANDBOX`	Sandbox modunu etkinleştir	`true`

Hooks (Kancalar) Sistemi Gelişmiş

Hooks, Claude Code olaylarına yanıt olarak otomatik shell komutları çalıştırmanızı sağlar.

Kullanılabilir Hook’lar

user-prompt-submit

Kullanıcı her prompt gönderdiğinde tetiklenir.

echo "Prompt: $PROMPT"

tool-call

Claude bir araç çağırdığında tetiklenir.

echo "Tool: $TOOL_NAME"

file-write

Dosya yazma işleminden önce tetiklenir.

prettier --write "$FILE_PATH"

git-commit

Git commit yapılmadan önce tetiklenir.

npm run lint && npm test

Hook Yapılandırma Örneği

settings.json içinde:

{
  "hooks": {
    "user-prompt-submit": "git diff --staged",
    "file-write": "prettier --write {{file_path}}",
    "git-commit": "npm run lint && npm test"
  }
}

İpucu: Hook’lar başarısız olursa (non-zero exit code), Claude Code işlemi durdurur ve size bilgi verir.

Pratik Kullanım Örnekleri

1. React Komponenti Oluşturma

Prompt: “Kullanıcı profili için bir React komponenti oluştur. Props olarak name, email ve avatar alsın. TypeScript kullan.”

Sonuç: Claude Code, TypeScript ile yazılmış, prop validation içeren tam bir React komponenti oluşturur ve gerekli test dosyalarını ekler.

2. API Endpoint Test Etme

Prompt: “/api/users endpoint’ini test et ve hataları düzelt”

Sonuç: Claude Code endpoint’i çağırır, yanıtları analiz eder, hataları bulur ve düzeltmeler önerir.

3. Database Migration Oluşturma

Prompt: “Users tablosuna ‘phone_number’ ve ‘verified’ alanları ekleyen bir migration oluştur”

Sonuç: Projenizin ORM yapısına uygun migration dosyası oluşturur (Prisma, TypeORM, vb.)

4. Kod Refactoring

Prompt: “src/utils/helpers.js dosyasındaki tüm fonksiyonları TypeScript’e çevir ve unit test ekle”

Sonuç: JavaScript dosyasını TypeScript’e dönüştürür, tip tanımlamaları ekler ve Jest testleri oluşturur.

5. Git Workflow Otomasyonu

Prompt: “Feature branch oluştur, değişiklikleri commit et ve PR aç”

Sonuç: Yeni branch oluşturur, değişiklikleri anlamlı commit mesajı ile commit eder ve GitHub’da PR açar.

Karmaşık Senaryolar

Mikroservis API Geliştirme

Prompt: “Express.js kullanarak bir authentication mikroservisi oluştur. JWT token, refresh token, rate limiting ve Redis cache içersin. Docker ile çalışsın.”

# Claude Code şunları otomatik oluşturur: – Express.js server yapısı – JWT authentication middleware – Redis cache entegrasyonu – Rate limiting implementasyonu – Dockerfile ve docker-compose.yml – API dokumentasyonu – Unit ve integration testleri

Sorun Giderme

API Bağlantı Hataları ▼

Sorun: “API connection failed” hatası alıyorum

Çözümler:

API anahtarınızı kontrol edin: echo $ANTHROPIC_API_KEY
İnternet bağlantınızı test edin
Firewall ayarlarınızı kontrol edin
Proxy kullanıyorsanız, proxy ayarlarını yapılandırın

# API anahtarını yeniden ayarlayın
export ANTHROPIC_API_KEY="your-api-key"
claude

Yavaş Yanıt Süreleri ▼

Sorun: Claude Code çok yavaş yanıt veriyor

Çözümler:

Daha hızlı model kullanın (Haiku)
Prompt’larınızı daha spesifik yapın
Gereksiz context’i temizleyin: /clear
Extended thinking modunu kapatın (basit görevler için)

Dosya İzinleri Sorunları ▼

Sorun: “Permission denied” hataları

Çözümler:

Proje dizininde yazma izniniz olduğundan emin olun
Sandbox ayarlarını kontrol edin
Git repository ayarlarını gözden geçirin

# Dizin izinlerini kontrol et
ls -la
# Gerekirse izinleri düzelt
chmod -R u+w .

Token Limit Hataları ▼

Sorun: “Token limit exceeded” hatası

Çözümler:

Konuşma geçmişini temizleyin: /clear
Büyük dosyaları parçalara bölün
Task tool kullanarak alt görevler oluşturun
Gereksiz dosya okumalarından kaçının

Git İşlemleri Başarısız Oluyor ▼

Sorun: Git commit veya push başarısız oluyor

Çözümler:

Git yapılandırmanızı kontrol edin
Pre-commit hook’larınızı gözden geçirin
Branch izinlerinizi kontrol edin
Remote repository bağlantısını test edin

# Git durumunu kontrol et
git status
git config --list

# Remote bağlantısını test et
git remote -v
git fetch --dry-run

Debug Modu

Detaylı loglama için debug modunu etkinleştirin:

# Debug mode ile başlat
CLAUDE_DEBUG=true claude

# Logları dosyaya kaydet
claude --verbose > debug.log 2>&1

Yardım ve Destek

Claude Code kullanırken yardıma mı ihtiyacınız var?

Yardım komutu: /help
Dokümantasyon: docs.claude.com/claude-code
Geri bildirim: GitHub Issues