İçindekiler
Claude Code Nedir?
Claude Code, Anthropic tarafından geliştirilen terminal tabanlı bir AI kodlama asistanıdır. Doğrudan terminalinizden çalışarak dosya okuma/yazma, git işlemleri, test çalıştırma ve karmaşık kodlama görevlerini otomatik olarak gerçekleştirebilir.
Diğer AI araçlarından farklı olarak Claude Code agentic bir yapıdadır — yani sadece öneri vermekle kalmaz, dosya sisteminizde gezinir, kodu okur ve düzenler, terminalde komut çalıştırır. Bir "AI pair programmer"dan çok, "AI developer" gibi düşünün.
Dosya Yönetimi
Proje dosyalarını okur, yazar, düzenler. Glob ve Grep ile arama yapar.
Git Entegrasyonu
Commit, PR, diff, branch işlemlerini otomatik yapar.
Test Çalıştırma
Test yazma, çalıştırma ve hata düzeltme döngüsü.
Kod Analizi
Bug bulma, güvenlik açığı tespiti, performance review.
Web Araştırma
Dokümantasyon okuma, API referansları, web arama.
MCP Desteği
Model Context Protocol ile harici araç entegrasyonu.
Kurulum ve İlk Ayarlar
Sistem Gereksinimleri
İşletim Sistemi
macOS 12+, Ubuntu 20.04+, Windows 10+ (WSL2 önerilir)
Node.js
Node.js 18+ (LTS önerilir: v20 veya v22)
Anthropic Hesabı
Pro ($20/ay) veya Max ($100/ay) abonelik
Adım 1: Node.js Kurulumu
# macOS (Homebrew ile)
brew install node
# Windows (winget ile)
winget install OpenJS.NodeJS.LTS
# Linux (nvm önerilir)
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
nvm install 20
nvm use 20
# Kontrol
node --version # v20.x.x veya üzeri
Adım 2: Claude Code Kurulumu
# Global kurulum
npm install -g @anthropic-ai/claude-code
# Güncelleme
npm update -g @anthropic-ai/claude-code
# Versiyon kontrolü
claude --version
Adım 3: İlk Çalıştırma
# Proje dizinine git
cd ~/projects/my-app
# Claude Code'u başlat
claude
# İlk çalıştırmada Anthropic hesabınızla giriş yapacaksınız
# Tarayıcı açılır, izinleri onaylayın
Windows Kullanıcıları İçin
Windows'ta Claude Code direkt çalışır, ancak en iyi deneyim için WSL2 (Windows Subsystem for Linux) kullanmanızı öneririz. VS Code + WSL2 entegrasyonu ile native Linux ortamında çalışabilirsiniz.
Temel Komutlar ve Kullanım
Başlatma Yöntemleri
# İnteraktif mod (en yaygın)
claude
# Tek seferlik komut
claude "bu projedeki tüm hataları bul ve düzelt"
# Pipe ile kullanım
cat error.log | claude "bu hata loglarını analiz et"
# Belirli dosya ile
claude "src/auth.ts dosyasına JWT refresh token ekle"
# Resume (önceki oturumu devam ettir)
claude --resume
Slash Komutları
| Komut | Açıklama | Örnek Kullanım |
|---|---|---|
/help |
Yardım menüsünü gösterir | Komutları öğrenmek için |
/clear |
Konuşma geçmişini temizler | Token tasarrufu için |
/commit |
Otomatik git commit oluşturur | Değişiklikleri kaydetmek için |
/review |
Kod incelemesi yapar | PR öncesi review için |
/fast |
Hızlı mod aç/kapat | Basit görevler için |
Ctrl+C |
Mevcut işlemi iptal eder | Uzun süren görevleri durdurmak için |
Pratik Kullanım Örnekleri
Bug Fix
claude "src/api/auth.ts dosyasında login
fonksiyonu 401 hatası veriyor.
Hatayı bul ve düzelt."
Yeni Özellik
claude "Bu projeye dark mode toggle ekle.
localStorage'da tercihi kaydet.
Tailwind dark: prefix kullan."
Test Yazma
claude "src/utils/ altındaki tüm
utility fonksiyonları için Jest
unit testleri yaz. Edge case'leri
de kapsa."
Refactoring
claude "components/Dashboard.tsx çok
büyük (500+ satır). Mantıklı
alt componentlere böl ve
custom hooks çıkar."
CLAUDE.md ile Proje Yönetimi
CLAUDE.md dosyası, Claude Code'a projeniz hakkında bağlam veren özel bir konfigürasyon dosyasıdır. Proje kökünde oluşturduğunuzda, Claude her oturumda bu dosyayı otomatik okur ve talimatlarınıza uyar.
# CLAUDE.md - Proje Konfigürasyonu
## Proje Bilgileri
- **Proje:** E-Ticaret SaaS Platformu
- **Tech Stack:** Next.js 15, TypeScript, Tailwind 4, Supabase, Drizzle ORM
- **Node:** v20 LTS
- **Paket Yöneticisi:** pnpm
## Kod Standartları
- TypeScript strict mode kullan
- `any` tipini ASLA kullanma
- Tüm componentler function component olmalı
- Dosya isimleri kebab-case (my-component.tsx)
- CSS için Tailwind utility-first yaklaşım
## Proje Yapısı
```
src/
├── app/ # Next.js App Router sayfaları
├── components/ # Paylaşılan UI componentleri
├── lib/ # Utility fonksiyonlar ve config
├── server/ # Server actions ve API logic
└── types/ # TypeScript type tanımları
```
## Veritabanı
- Supabase PostgreSQL
- Drizzle ORM ile schema tanımları src/server/db/schema.ts
- Migration: `pnpm db:push`
## Komutlar
- `pnpm dev` - Development server
- `pnpm build` - Production build
- `pnpm test` - Jest testleri
- `pnpm lint` - ESLint check
## Önemli Kurallar
- API route'larda her zaman auth() kontrolü yap
- Form validasyonu için Zod kullan
- Tüm UI componentlerinde loading/error/empty state handle et
- Commit mesajları conventional commits formatında
İpucu: Katmanlı CLAUDE.md
Claude Code 3 seviyede CLAUDE.md dosyasını destekler:
~/.claude/CLAUDE.md — Global kurallar (tüm projeler)
./CLAUDE.md — Proje kökü kuralları
./src/CLAUDE.md — Alt dizin özel kuralları
İleri Seviye Kullanım
Hooks (Otomatik Aksiyonlar)
Hooks, belirli olaylarda otomatik çalışan shell komutlarıdır. ~/.claude/settings.json dosyasında tanımlanır.
// ~/.claude/settings.json
{
"hooks": {
"on_tool_call": [
{
"tool": "Write",
"command": "echo 'Dosya yazıldı: $FILE_PATH'"
}
],
"on_commit": [
{
"command": "npm run lint"
}
]
}
}
MCP Server Entegrasyonu
Model Context Protocol (MCP) ile harici araçları Claude Code'a bağlayabilirsiniz.
// .claude/settings.json (proje seviyesi)
{
"mcpServers": {
"context7": {
"command": "npx",
"args": ["-y", "@upstash/context7-mcp"]
},
"supabase": {
"command": "npx",
"args": ["-y", "supabase-mcp-server"],
"env": {
"SUPABASE_URL": "https://xxx.supabase.co",
"SUPABASE_KEY": "your-service-key"
}
}
}
}
Paralel Görevler (Background Tasks)
# Claude Code içinde, birden fazla dosyayı
# aynı anda düzenlemesini isteyebilirsiniz:
"Şu 3 görevi paralel yap:
1. src/components/Header.tsx'e mobile menu ekle
2. src/styles/globals.css'e responsive breakpoint'ler ekle
3. src/lib/utils.ts'e formatDate helper fonksiyonu yaz"
Vibe Coding Workflow ile Claude Code
Plan Mode ile Planlama
"Bu projeye kullanıcı authentication sistemi ekleyeceğim. Önce plan yap." — Claude Code codebase'i analiz eder ve plan oluşturur.
Adım Adım İmplementasyon
Her adımı ayrı ayrı onaylarsınız. Claude dosyaları oluşturur, düzenler ve test eder.
Test ve Doğrulama
"Testleri çalıştır ve hataları düzelt" — Claude testleri çalıştırır, başarısız olanları otomatik düzeltir.
Commit ve PR
/commit ile otomatik commit mesajı, ardından PR oluşturma ve açıklama yazma.
Abonelik Planları
Free Tier
- Sınırlı kullanım (günlük limit)
- Claude Sonnet modeli
- Temel dosya okuma/yazma
- Git entegrasyonu
Pro Plan
- Claude Opus erişimi
- Yüksek kullanım limiti
- Tüm araçlar ve özellikler
- MCP Server desteği
- Öncelikli destek
Max Plan
- En yüksek limitler
- Tüm modeller (Opus, Sonnet, Haiku)
- 20x daha fazla kullanım
- Kurumsal özellikler
- Hızlı yanıt süresi
Token Kullanımı Hakkında
- Input tokens: Gönderdiğiniz mesajlar, dosya içerikleri ve bağlam
- Output tokens: Claude'un ürettiği yanıtlar ve yazılan kod
- Bağlam penceresi: 200K token (Opus), yaklaşık 500 sayfa metin
- Otomatik sıkıştırma: Uzun oturumlarda otomatik bağlam yönetimi
Pro İpuçları
CLAUDE.md Oluşturun
Proje yapısı, standartlar ve kurallarınızı tanımlayın. Bu, gereksiz token harcamasını azaltır ve tutarlı çıktı sağlar.
Küçük Adımlar
Her seferde bir özellik isteyin. "Tüm uygulamayı yap" yerine "login formunu oluştur" deyin.
Spesifik Olun
"Düzelt" yerine "auth.js dosyasındaki JWT token süresini 1 saate ayarla" gibi net talimatlar verin.
Git ile Çalışın
Her önemli değişikliği commit edin. /commit komutu ile otomatik commit mesajı oluşturun.
Review Yaptırın
"Bu kodu güvenlik açısından incele" veya "performance iyileştirmeleri öner" gibi review promptları kullanın.
Test Yazdırın
Claude'a unit test ve integration test yazdırarak kod kalitesini artırın. TDD yaklaşımı kullanın.