Claude Code ile AI-Destekli Yazılım Geliştirme: Terminal Üzerinden Kod Yazma Rehberi

Claude Code, Anthropic’in terminal üzerinde çalışan AI aracı. IDE eklentisi değil, doğrudan terminalinizde çalışan bir AI coding agent. Dosyaları okur, düzenler, terminal komutları çalıştırır, hata ayıklar ve commit mesajı yazar — hepsi CLI üzerinden.

Bu yazıda Claude Code’u nasıl kurduğumu, günlük workflow’umda nasıl kullandığımı ve production ortamında nelere dikkat ettiğimi anlatıyorum.

Claude Code, Anthropic’in terminal-native AI coding asistanı

1. Claude Code Nedir, Neden Farklı?

Claude Code’u diğer AI coding araçlarından ayıran şey, terminal-native olması. GitHub Copilot VS Code içinde çalışır, Cursor özel bir IDE’dir, Claude Code ise doğrudan terminalinizde çalışır.

Ne Zaman Claude Code?

• Terminal ağırlıklı çalışıyorsanız — tmux, neovim, ssh üzerinden geliştirme
• CI/CD pipeline’larında — otomatik kod değişiklikleri ve PR review
• Multi-file refactoring — birden fazla dosyada eşzamanlı değişiklik
• MCP araçlarıyla entegrasyon — veritabanı, API, dosya sistemi erişimi
• Headless ortamlar — GPU sunucuları, container içi geliştirme

2. Kurulum

macOS (Homebrew)

brew install claude-code

npm ile (Tüm Platformlar)

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

Doğrulama

claude --version
# claude-code 0.2.30

API Key

İlk çalıştırmada sizden API key ister:

claude
# → Anthropic API key girin veya ANTHROPIC_API_KEY env variable

Alternatif olarak environment variable ile:

export ANTHROPIC_API_KEY="sk-ant-..."
export CLAUDE_CODE_ALLOW_SCRIPTS=true  # Script çalıştırma izni (opsiyonel)
claude

Kurulum tamamlandıktan sonra:

claude
# Claude Code CLI başlar, prompt bekler

3. Temel Kullanım

İnteraktif Mod

$ claude
> Bu projenin yapısını analiz et ve README.md'de özetle

Claude Code projeyi tarar, dosyaları okur, README.md’yi oluşturur ve terminalde sonucu gösterir. Onay ister — y derseniz dosyaya yazar.

Tek Seferlik Komut

claude -p "src/ klasöründeki test coverage'ı analiz et ve eksik testleri listele"

-p flag’i ile tek seferlik prompt gönderebilirsiniz. CI/CD pipeline’ları için ideal.

Pipe ile Kullanım

cat error.log | claude -p "Bu log'daki hataları analiz et ve nedenlerini açıkla"

Dosya Yönlendirme

claude -p "Bu dosyadaki performans sorunlarını bul" < src/main.ts

4. Agentic Coding: Claude Code’un En Güçlü Özelliği

Claude Code’u diğer araçlardan ayıran en önemli özellik agentic loop. Bir görev verdiğinizde, Claude Code:

1. Projeyi tarar ve bağlamı anlar
2. Gerekli dosyaları okur
3. Değişiklikleri planlar
4. Kodları düzenler
5. Testleri çalıştırır
6. Hataları düzeltir
7. Commit yapar

Bu döngü tamamen otonom çalışır.

Örnek: Feature Ekleme

$ claude
> Kullanıcıların profil fotoğrafı yükleyebilmesi için bir API endpoint ekle.
> Dosya boyutu 5MB ile sınırlı olsun, sadece jpg/png/webp formatlarına izin ver.
> Sharp ile thumbnail oluştur ve Cloudflare R2'ye kaydet.

Claude Code şu adımları izler:

1. Mevcut API yapısını anlamak için router dosyalarını okur
2. Model katmanını kontrol eder
3. Gerekli bağımlılıkları kontrol eder (sharp, @aws-sdk/client-s3)
4. Route handler’ı yazar
5. Validation ekler (file type, boyut kontrolü)
6. Sharp ile thumbnail pipeline’ı kurar
7. R2 upload fonksiyonunu yazar
8. Testleri çalıştırır
9. Hata varsa düzeltir
10. git commit -m "feat: add profile photo upload endpoint"

Çıktı:

✓ Proje yapısı analiz edildi (18 dosya okundu)
✓ Route handler oluşturuldu: src/routes/profile/upload.ts
✓ Validation eklendi: file type + size check
✓ Sharp thumbnail pipeline oluşturuldu
✓ R2 upload servisi eklendi
✓ Testler geçti (3 test, 0 fail)
✓ Commit yapıldı: feat: add profile photo upload endpoint
Toplam: 47 saniye

Agentic Loop Konfigürasyonu

# Maksimum tool call limiti (default: 50, varsayılan genelde yeterli)
export CLAUDE_CODE_MAX_TOOL_CALLS=100

# Script çalıştırma izni
export CLAUDE_CODE_ALLOW_SCRIPTS=true

# Verbose log
export CLAUDE_CODE_VERBOSE=true

5. MCP (Model Context Protocol) Entegrasyonu

Claude Code’un en güçlü özelliklerinden biri MCP desteği. MCP sayesinde Claude Code harici araçlarla (veritabanı, API, dosya sistemi) doğrudan etkileşime girebilir.

MCP Nedir?

MCP (Model Context Protocol), AI modellerinin harici araçlarla standart bir protokol üzerinden iletişim kurmasını sağlar. Anthropic tarafından geliştirilen açık bir standart.

MCP Server Yapılandırması

// ~/.claude/claude.json
{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/allowed/dir"]
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_TOKEN": "ghp_..."
      }
    },
    "postgres": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres", "postgresql://localhost/mydb"]
    },
    "brave-search": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-brave-search"],
      "env": {
        "BRAVE_API_KEY": "..."
      }
    }
  }
}

Pratik Kullanım Örnekleri

PostgreSQL ile:

$ claude
> Veritabanındaki kullanıcı tablosunun şemasını kontrol et
> ve email adresi doğrulaması yapılmamış kullanıcıları listele

GitHub ile:

$ claude
> GitHub'daki open issue'ları kontrol et
> ve en kritik 3 tanesi için PR oluştur

Brave Search ile:

$ claude
> En son Next.js 15 release notlarını ara
> ve projemizdeki mevcut Next.js versiyonunu karşılaştır

6. CI/CD Pipeline’ında Claude Code

Claude Code’u CI/CD pipeline’larında kullanarak otomatik kod değişiklikleri ve PR review yapabilirsiniz.

GitHub Actions ile Otomatik Code Review

# .github/workflows/claude-code-review.yml
name: Claude Code Review
on:
  pull_request:
    types: [opened, synchronize]

jobs:
  review:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
      - run: npm install -g @anthropic-ai/claude-code
      - run: |
          claude -p "Bu PR'i review et. Şu kriterlere göre değerlendir:
          1. Güvenlik açıkları var mı?
          2. Performans sorunları var mı?
          3. Best practice'lere uyuyor mu?
          4. Test coverage yeterli mi?
          Sonuçları PR comment olarak yaz."
        env:
          ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

Otomatik Changelog ve Release Notes

# .github/workflows/release-notes.yml
on:
  push:
    branches: [main]

jobs:
  changelog:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
        with:
          fetch-depth: 0
      - run: npm install -g @anthropic-ai/claude-code
      - run: |
          claude -p "Son tag'dan bu yana yapılan değişiklikleri analiz et
          ve CHANGELOG.md dosyasını güncelle. Conventional commits
          formatına göre kategorilendir: feat, fix, docs, refactor, chore."
        env:
          ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}

7. Günlük Workflow: Ben Nasıl Kullanıyorum

Sabah Rutini

Her sabah projelerin durumunu kontrol etmek için:

$ claude
> Tüm branşları kontrol et. Son 24 saatte yapılan değişiklikleri özetle.
> Bekleyen task'leri listele ve hangilerinin öncelikli olduğunu belirt.

Development Loop

Geliştirme sırasında kullandığım döngü:

1. Planlama: claude -p "Bu feature için implementation planı çıkar"
2. Kod yazma: Claude Code’a doğrudan komut
3. Review: claude -p "Son commit'i review et"
4. Refactor: claude -p "Bu modülü temizle, duplicate kodları kaldır"
5. Test: claude -p "Bu feature için test yaz"

Debug Workflow

Hata ayıklama için:

$ claude
> production.log dosyasındaki son 100 satırı analiz et.
> En sık görülen 3 hatayı bul ve düzeltme önerisi sun.
> Düzeltmeleri uygula ve testleri çalıştır.

Code Review

Kendi PR’larımı review etmek için:

$ claude -p "Son commit'teki değişiklikleri review et.
Potansiyel sorunları bul. Değişiklikleri kategorize et:
- Güvenlik
- Performans
- Tür güvenliği
- Test coverage"

8. İpuçları ve Best Practice’ler

1. Context Yönetimi

Claude Code’un 200K token context window’u var ama her açılışta sıfır başlıyor. Proje bağlamını korumak için:

# CLAUDE.md dosyası oluşturun — proje root'unda

# CLAUDE.md — Project Context

## Proje Yapısı

- src/api/ — Express router'ları
- src/services/ — Business logic
- src/db/ — Prisma şemaları ve migration
- tests/ — Jest testleri

## Coding Standards

- TypeScript strict mod
- Functional components preferred
- PascalCase for types, camelCase for functions
- Test coverage minimum %80

## Sık Kullanılan Komutlar

- `pnpm dev` — Development server
- `pnpm test` — Test suite
- `pnpm lint` — ESLint
- `pnpm typecheck` — TypeScript check

Bu dosya her claude çalıştırdığınızda otomatik okunur.

2. Prompt Mühendisliği

# ❌ Kötü prompt
claude -p "Bir login sayfası yap"

# ✅ İyi prompt
claude -p "
src/routes/auth/login.ts dosyasına email+password login endpoint'i ekle.
- Zod ile input validation
- bcrypt ile password hash karşılaştırma
- JWT token döndür
- Rate limiting: 5 deneme/dakika
- Hata mesajları: 'Invalid credentials' (spesifik hata verme)
- Mevcut proje yapısına uygun pattern kullan
"

3. Güvenlik

Claude Code terminal komutları çalıştırabildiği için dikkatli olunmalı:

# Sadece güvendiğiniz script'lere izin verin
export CLAUDE_CODE_ALLOW_SCRIPTS=false  # default

# Veya belirli script'lere izin ver
export CLAUDE_CODE_ALLOW_SCRIPTS="pnpm,npm,node,git,tsc,jest,eslint"

4. Maliyet Optimizasyonu

Claude Code’un maliyeti kullanılan token sayısına bağlı:

İpuçları:

• CLAUDE.md ile context’te tutarlılık sağlayın, tekrar tekrar açıklama yapmayın
• Headless mod (claude -p "...") ile gereksiz diyalogdan kaçının
• Dosya filtreleme ile sadece ilgili dosyaları context’e alın

9. Claude Code vs. Alternatifler

Kendi tecrübelerime dayanarak bir karşılaştırma:

Ne zaman hangisi?

• Claude Code: Terminal ağırlıklı, headless, CI/CD entegrasyonu
• Cline: VS Code içinde görsel arayüz ile çalışmak
• Aider: Git-native, pair programming workflow’u

10. Sonuç

Claude Code, terminal üzerinden AI destekli yazılım geliştirme konusunda en yetenekli araçlardan biri. Özellikle:

• Agentic loop ile otonom feature implementasyonu
• MCP entegrasyonu ile harici araçlarla etkileşim
• CI/CD pipeline’larında otomatik code review
• Çoklu dosya düzenleme ve refactoring

Bu yazıda öğrendiklerimiz:

• ✅ Claude Code kurulumu ve temel kullanım
• ✅ Agentic coding ile otonom geliştirme
• ✅ MCP entegrasyonu ile harici araç bağlantısı
• ✅ CI/CD pipeline entegrasyonu
• ✅ Günlük workflow ve best practice’ler
• ✅ Güvenlik ve maliyet optimizasyonu

Claude Code’u denemek isterseniz, küçük bir refactoring göreviyle başlamanızı öneririm. Mevcut bir projede tek bir dosyada değişiklik yapmasını isteyin — sonra giderek daha kompleks görevlere geçin.

Hero görseli: fal.ai + FLUX.1 Dev ile üretilmiştir

Kaynaklar

• Claude Code Resmi Dokümantasyonu
• Anthropic API Referansı
• MCP (Model Context Protocol)
• CLAUDE.md Best Practice’leri
• Claude Code GitHub