✅ Claude Code AI Asistan Özellikleri

• ✅ Doğal dille kod yazma ("React'ta login sayfası oluştur" gibi)
• ✅ Çoklu dosya düzenleme (tüm proje üzerinde çalışabilir)
• ✅ Hata tespiti ve düzeltme (bug fixing, debugging)
• ✅ Kod refactoring (clean code, optimization)
• ✅ Proje analizi (architecture understanding)
• ✅ Türkçe dil desteği (native Turkish support)
• ✅ Git entegrasyonu (commit, merge, review)
• ✅ Terminal üzerinden çalışma (CLI interface)

Karşılaştırma: Geleneksel vs AI Destekli Geliştirme

✅ Sistem Gereksinimleri

• ✅ Windows 10 veya Windows 11
• ✅ PowerShell 5.1+ (varsayılan olarak yüklü)
• ✅ En az 4 GB RAM
• ✅ İnternet bağlantısı
• ✅ Yönetici (Admin) erişimi (kurulum için)

✅ Gerekli Yazılımlar

• ✅ Node.js 18+ ve npm
  • İndirme: nodejs.org
  • LTS (Long Term Support) versiyonu öneriliyor
• ✅ Git Bash (Claude Code için zorunlu!)
  • İndirme: git-scm.com/downloads/win
• ✅ Claude aboneliği veya API anahtarı
  • Claude Pro ($20/ay)
  • Claude Max ($100/ay)
  • veya Anthropic Console API key

Windows Terminal Yapısı

# Windows'ta 3 ana terminal seçeneği:
1. PowerShell (Windows varsayılan)
2. Git Bash (Claude Code için gerekli)
3. CMD (eski command prompt)

# Claude Code, PowerShell'de çalışmaz!
# Git Bash kurulumu zorunludur!

1.1 Node.js İndirme

İndirme Adresi: nodejs.org

• ✅ LTS (Long Term Support) versiyonunu indirin
• ✅ Güncel LTS: Node.js 20.x veya 22.x
• ❌ Current sürümünü değil, LTS'yi seçin

1.2 Node.js Kurulumu

Kurulum Adımları:

1. node-vXX.X.X-x64.msi dosyasını çalıştırın
2. "Next" ile ilerleyin
3. "Accept" ile lisansı kabul edin
4. Varsayılan yol: C:\Program Files\nodejs
5. "Tools for Native Modules" kutusunu işaretleyin
6. "Install" ile kurulumu başlatın
7. Kurulum bitince bilgisayarı yeniden başlatın

1.3 Node.js Kurulum Kontrolü

# PowerShell'i açın (yeniden başlattıktan sonra!)
# Başlat > PowerShell

# Node.js versiyonunu kontrol edin
node --version
# Çıktı: v20.x.x veya v22.x.x

# npm versiyonunu kontrol edin
npm --version
# Çıktı: 10.x.x veya daha yeni

# Eğer "command not found" hatası alırsanız:
# Bilgisayarı yeniden başlatın veya PATH'i kontrol edin

⚠️ Sorun Giderme: Node.js Tanınmıyor

# PATH'i kontrol et
$env:Path

# Node.js PATH'i manuel ekle
[Environment]::SetEnvironmentVariable("Path", $env:Path + ";C:\Program Files\nodejs", "User")

# PowerShell'i kapat ve yeniden aç
# Tekrar kontrol et
node --version

2.1 Git Bash İndirme

İndirme Adresi: git-scm.com/downloads/win

• ✅ Standalone Installer seçeneğini indirin
• ✅ 64-bit versiyonu seçin
• ✅ Dosya adı: Git-2.XX.X-64-bit.exe

2.2 Git Bash Kurulumu

Kurulum Adımları:

1. Git-2.XX.X-64-bit.exe dosyasını çalıştırın
2. "Next" ile ilerleyin
3. Kurulum yolu: C:\Program Files\Git (varsayılan)
4. Önemli: "Git Bash Here" seçeneğini işaretleyin
5. "Use Git from the Windows Command Prompt" seçin
6. "Checkout Windows-style, commit Unix-style" seçin
7. "Use MinTTY" terminal seçeneğini seçin
8. "Install" ile kurulumu başlatın

2.3 Git Bash Kurulum Kontrolü

# PowerShell'de Git kontrolü
git --version
# Çıktı: git version 2.XX.X.windows.X

# Git Bash'in yerini bul
Get-Command bash -ErrorAction SilentlyContinue

# Tipik yollar:
# C:\Program Files\Git\bin\bash.exe
# C:\Program Files (x86)\Git\bin\bash.exe

2.4 Git Bash PATH Ayarı (Claude Code İçin)

# Environment Variable ekle (Kalıcı)
[System.Environment]::SetEnvironmentVariable('CLAUDE_CODE_GIT_BASH_PATH', 'C:\Program Files\Git\bin\bash.exe', 'User')

# PowerShell'i KAPAT ve YENİDEN AÇ

# Kontrolü
$env:CLAUDE_CODE_GIT_BASH_PATH
# Çıktı: C:\Program Files\Git\bin\bash.exe

⚠️ Alternatif: Geçici PATH Ayarı

# Sadece bu PowerShell oturumu için
$env:CLAUDE_CODE_GIT_BASH_PATH = "C:\Program Files\Git\bin\bash.exe"

# Bu yöntemde her PowerShell açılışında tekrar yazman gerekir!

3.1 Mevcut Kurulumu Kaldırma (Varsa)

# PowerShell'de eski kurulumu kaldır
npm uninstall -g @anthropic-ai/claude-code

# Önbelleği temizle
npm cache clean --force

# Claude ayar dosyalarını sil
Remove-Item -Recurse -Force $env:USERPROFILE\.claude -ErrorAction SilentlyContinue
Remove-Item -Recurse -Force $env:APPDATA\claude-code -ErrorAction SilentlyContinue

# Kontrol et (artık tanımamalı)
claude --version
# Hata verirse başarılı!

3.2 Claude Code Kurulumu

# Global kurulum (önerilen)
npm install -g @anthropic-ai/claude-code

# Kurulum 1-2 dakika sürebilir, bekleyin...

# Kurulum başarılı mesajı görmelisiniz:
# + @anthropic-ai/claude-code@X.X.X
# added XX packages in XXs

3.3 Kurulum Kontrolü

# Claude Code versiyonunu kontrol et
claude --version
# Çıktı: claude-code version X.X.X

# veya
claude doctor
# Sistem bilgilerini ve kurulum durumunu gösterir

3.4 İlk Çalıştırma ve Kimlik Doğrulama

# Claude Code'u başlat
claude

# İlk çalıştırmada:
# 1. Tarayıcı penceresi açılacak
# 2. Claude hesabınla giriş yap (Pro/Max veya API key)
# 3. Terminal stilini seç
# 4. İzinleri onayla

# Başarılı giriş sonrası:
# Claude> ▊ (komut bekleniyor)

3.5 API Key ile Giriş (Alternatif)

# Anthropic Console'dan API key al
# https://console.anthropic.com/

# Environment variable olarak ayarla
[System.Environment]::SetEnvironmentVariable('ANTHROPIC_API_KEY', 'sk-ant-api03-xxxx', 'User')

# PowerShell'i yeniden başlat
# Artık otomatik giriş yapacak

# API kullanımı ÜCRETLI - dikkatli kullan!
# Claude Max aboneliği daha ekonomik olabilir.

❌ Hata 1: "Git-bash gerekli" Hatası

# Hata mesajı:
# Claude Code on Windows requires git-bash

# Çözüm 1: Git Bash'in kurulu olduğundan emin ol
git --version

# Çözüm 2: PATH ayarla
[System.Environment]::SetEnvironmentVariable('CLAUDE_CODE_GIT_BASH_PATH', 'C:\Program Files\Git\bin\bash.exe', 'User')

# Çözüm 3: bash.exe'yi bul
Get-ChildItem -Path "C:\Program Files" -Filter "bash.exe" -Recurse -ErrorAction SilentlyContinue

# Bulunan path'i kullan
[System.Environment]::SetEnvironmentVariable('CLAUDE_CODE_GIT_BASH_PATH', 'BULUNAN-PATH', 'User')

# PowerShell'i KAPAT ve YENİDEN AÇ

❌ Hata 2: "command not found: claude"

# Neden: npm global path tanınmıyor

# Çözüm 1: npm global path'i bul
npm config get prefix
# Çıktı: C:\Users\KULLANICI\AppData\Roaming\npm

# Çözüm 2: PATH'e ekle
$npmPath = npm config get prefix
[Environment]::SetEnvironmentVariable("Path", $env:Path + ";$npmPath", "User")

# Çözüm 3: PowerShell'i yeniden başlat
# Çözüm 4: Kontrol et
claude --version

❌ Hata 3: "Permission denied" / İzin Hatası

# Neden: npm izin sorunu

# Çözüm 1: npm'i kullanıcı dizinine yapılandır
npm config set prefix "$env:APPDATA\npm"
[Environment]::SetEnvironmentVariable("Path", $env:Path + ";$env:APPDATA\npm", "User")

# Çözüm 2: Yeniden kur
npm cache clean --force
npm install -g @anthropic-ai/claude-code

# ⚠️ ASLA sudo kullanma!

❌ Hata 4: "Node.js tanınmıyor"

# Neden: Node.js kurulmamış veya PATH hatası

# Çözüm 1: Node.js'i yeniden kur
# nodejs.org adresinden LTS versiyonunu indir

# Çözüm 2: PATH manuel ekle
[Environment]::SetEnvironmentVariable("Path", $env:Path + ";C:\Program Files\nodejs", "User")

# Çözüm 3: Bilgisayarı yeniden başlat

❌ Hata 5: "Authentication failed"

# Neden: Giriş yapılmamış veya API key yanlış

# Çözüm 1: Yeniden giriş yap
claude

# Çözüm 2: API key kontrol et
$env:ANTHROPIC_API_KEY
# Doğru mu?

# Çözüm 3: API key yeniden ayarla
[System.Environment]::SetEnvironmentVariable('ANTHROPIC_API_KEY', 'YENİ-KEY', 'User')

# PowerShell'i yeniden başlat

⚠️ Genel Sorun Giderme Kontrol Listesi

# 1. Versiyonları kontrol et
node --version    # v18+ olmalı
npm --version     # 9+ olmalı
git --version     # 2.X olmalı
claude --version  # Kuruluysa versiyon gösterir

# 2. PATH kontrolü
$env:Path
# Şunları içermeli:
# - C:\Program Files\nodejs
# - C:\Users\KULLANICI\AppData\Roaming\npm
# - C:\Program Files\Git\bin

# 3. Git Bash kontrolü
$env:CLAUDE_CODE_GIT_BASH_PATH
# C:\Program Files\Git\bin\bash.exe olmalı

# 4. Hepsi yoksa PowerShell'i YENİDEN BAŞLAT!

Sabah Rutini

# 1. PowerShell'i aç
# Başlat > PowerShell

# 2. Proje klasörüne git
cd D:\Projeler\myapp

# 3. Claude Code'u başlat
claude

# 4. Proje analizi yap
> Bu projeyi analiz et ve CLAUDE.md oluştur

Claude Code Kullanım Modları

Mod 1: İnteraktif Mod (Önerilen)

# Proje klasöründe
claude

# İçeride komutlar:
> index.html'i göster
> Navbar'ı responsive yap
> Footer'a sosyal medya ikonları ekle
> Tüm CSS dosyalarını minify et
> /help        # Yardım
> /exit        # Çıkış

Mod 2: Direkt Komut

# Tek komut, cevap al, çık
claude "app.js'deki syntax hatalarını bul ve düzelt"

# veya
claude "Python FastAPI sunucusu oluştur"

Mod 3: Proje ile Başlatma

# Belirli görevle başla
claude "Bu React projesine login sayfası ekle"

Türkçe Komut Örnekleri

# Dosya işlemleri
"config.php dosyasını göster"
"Tüm .js dosyalarını listele"
"components klasöründeki dosyaları analiz et"

# Kod yazma
"React'ta kullanıcı profili komponenti oluştur"
"Python'da JSON API endpoint yaz"
"Node.js Express server kur"

# Hata düzeltme
"app.js'deki hatayı bul ve düzelt"
"test suite'i çalıştır ve başarısız testleri düzelt"
"ESLint uyarılarını gider"

# Refactoring
"Bu fonksiyonu daha okunabilir yap"
"CSS'i Tailwind'e çevir"
"Async/await kullanarak yeniden yaz"

# Dokümantasyon
"README.md dosyası oluştur"
"Bu API için Swagger dokümantasyonu yaz"
"Kod yorumları ekle"

# Git işlemleri
"Son 5 commit'i analiz et"
"Release notes oluştur"
"Commit mesajı öner"

Slash Komutları (İnteraktif Modda)

/help          # Tüm komutları göster
/clear         # Konuşmayı temizle (yeni görev için)
/cost          # Maliyet bilgisi (API kullanımı)
/model         # Model değiştir (Sonnet, Opus, Haiku)
/ide           # VS Code entegrasyonu aktive et
/rewind        # Önceki duruma geri dön (Ctrl+Z gibi)
/exit          # Claude Code'dan çık

VS Code Entegrasyonu

# VS Code'dan Terminal aç (Ctrl + `)

# Claude'u başlat
claude

# IDE modunu aktive et
> /ide

# Artık VS Code ile entegre çalışıyor!
# - Dosya değişiklikleri otomatik görünür
# - Git entegrasyonu aktif
# - Debug modu kullanılabilir

Git ile Birlikte Kullanım

# Workflow örneği
cd D:\Projeler\myapp

# 1. Claude ile kod yaz
claude "Login sayfası oluştur: email, password, remember me"

# 2. Değişiklikleri gör
git status
git diff

# 3. Test et (local)
npm run dev

# 4. Commit
git add .
git commit -m "Login sayfası eklendi: form validation, remember me özelliği"

# 5. Push
git push origin main

Faydalı PowerShell Kısayolları

# Geçmiş komutları arama
# Ctrl + R

# Otomatik tamamlama
# Tab tuşu

# Hızlı dizin değiştirme
cd D:\Projeler
cd myapp

# Klasör ağacını göster
tree /F

# Dosya içeriğini göster
Get-Content index.html

# Alias tanımlama (kısayol)
Set-Alias c claude
# Artık "c" yazınca claude çalışır!

Model Seçimi ve Optimizasyon

# Sonnet 4.5 (Varsayılan - Hızlı ve Dengeli)
[System.Environment]::SetEnvironmentVariable('ANTHROPIC_MODEL', 'claude-sonnet-4-5-20250929', 'User')

# Opus 4 (Karmaşık görevler - Daha yavaş, daha güçlü)
[System.Environment]::SetEnvironmentVariable('ANTHROPIC_MODEL', 'claude-opus-4-20250514', 'User')

# Haiku 4 (Basit görevler - Çok hızlı, ekonomik)
[System.Environment]::SetEnvironmentVariable('ANTHROPIC_MODEL', 'claude-haiku-4-20250514', 'User')

# PowerShell'i yeniden başlat

PowerShell Profile Konfigürasyonu

# PowerShell profilini düzenle
notepad $PROFILE

# Ekle:
# Claude Code için ayarlar
$env:CLAUDE_CODE_GIT_BASH_PATH = "C:\Program Files\Git\bin\bash.exe"
$env:ANTHROPIC_MODEL = "claude-sonnet-4-5-20250929"

# Alias'lar
Set-Alias c claude
function ccd { cd D:\Projeler; claude }

# Kaydet ve kapat
# PowerShell'i yeniden başlat

Çoklu Proje Yönetimi

# Proje klasör yapısı
D:\Projeler\
├── proje1\
├── proje2\
└── proje3\

# Hızlı geçiş fonksiyonu (Profile'a ekle)
function goto-p1 { cd D:\Projeler\proje1; claude }
function goto-p2 { cd D:\Projeler\proje2; claude }
function goto-p3 { cd D:\Projeler\proje3; claude }

# Kullanım
goto-p1  # proje1'e git ve Claude'u başlat

Toplu İşlemler

# Tüm projeleri güncelle
$projects = @("proje1", "proje2", "proje3")
foreach ($p in $projects) {
    cd "D:\Projeler\$p"
    git pull
    claude "Projeyi analiz et ve CLAUDE.md güncelle"
}

# Tüm testleri çalıştır
$projects = @("proje1", "proje2", "proje3")
foreach ($p in $projects) {
    cd "D:\Projeler\$p"
    claude "Tüm testleri çalıştır ve sonuçları raporla"
}

CLAUDE.md Dosyası (Proje Konteksti)

# CLAUDE.md dosyası oluştur (proje root'da)
claude "Bu proje için detaylı CLAUDE.md oluştur"

# İçinde olması gerekenler:
- Proje açıklaması
- Teknoloji stack
- Dizin yapısı
- Kurulum adımları
- API endpoints
- Veritabanı şeması
- Deployment bilgisi

# Claude bu dosyayı okuyup projeyi anlayacak!