Claude Code Nedir? Terminal’den Yöneten Geliştirici Olmak
Şu soruyu kendine sor: Bugün iş başında geçirdiğin sürenin ne kadarı gerçek karar alma — ne kadarı şablon kopyalamak, küçük hataları izlemek, test çıktılarını taramak gibi mekanik döngüler?
Bu oran seni rahatsız ediyorsa, Claude Code tam olarak o dengeyi değiştirmek için var. Kod yazan geliştirici olmaktan kod yöneten geliştirici olmaya geçişi sağlayan araç.
Bu yazının sonunda Claude Code’un ne olduğunu, nasıl çalıştığını, rakiplerine göre neden öne çıktığını ve bu hafta nasıl kurabileceğini somut olarak bileceksin.
1. Claude Code Nedir? “Asistan”ın Ötesinde Bir Şey
Claude Code, Anthropic’in Mayıs 2025’te piyasaya sürdüğü, terminal, IDE ve masaüstü üzerinden çalışan ajansal yazılım geliştirme asistanı. Motoru Claude Sonnet 4.5 — ama asıl fark modelin adında değil, nasıl çalıştığında.
“Ajansal AI” ne demek, biraz açayım. GitHub Copilot sana bir satır önerir, sen kabul ya da reddedersin — karar hep sende. Claude Code farklı düşünüyor: ona bir hedef verirsin, adımlara böler, sırayla uygular, hata alırsa geri dönerek alternatif yolu dener, testleri çalıştırır ve sana sonucu getirir. Her adım için onayını beklemez. Küçük bir fark gibi görünüyor — ama gün içinde saatler kurtarıyor.
2. Claude Code Ne Yapabilir? 8 Temel Yetenek
| Yetenek | Ne İşe Yarar? |
|---|---|
| Codebase Okuma | Tüm projeyi tek seferde tarar (1M token bağlam) |
| Dosya Düzenleme | Çok dosyalı değişiklikleri otonom yönetir |
| Test Çalıştırma | Testleri yazar, çalıştırır, hataları düzeltir |
| Git Entegrasyonu | Commit atar, branch açar, PR oluşturur |
| Terminal Komutları | Bash/shell komutlarını doğrudan yürütür |
| Web Arama | Güncel bilgiye erişerek bağlamı zenginleştirir |
| MCP Entegrasyonu | Harici araç ve servislerle bağlantı kurar |
| Paralel Ajan | Birden fazla alt görevi eş zamanlı yürütür |
En kritik madde: 1 milyon token bağlam penceresi. Rakip araçların büyük çoğunluğu projenin yalnızca küçük bir dilimini “görür.” Claude Code ise tüm proje yapısını — dosyaları, bağımlılıkları, geçmiş mimari kararları — tek bağlamda tutarak çok daha isabetli adımlar atar. 50.000 satırlık bir backend projesinde, ajan bir değişikliğin 7 farklı dosyayı nasıl etkileyeceğini gerçek anlamda kavrayarak hareket eder. Üretime yaklaştıkça bu fark katlanarak büyüyor.
Mart 2026 Güncellemeleri
Bu güncellemelerle yetenekler bir üst seviyeye çıktı:
- Computer Use: Ajan artık gerçek ekran kontrolü yapabiliyor. Tarayıcıyı açıyor, formu dolduruyor, sonucu alıyor. Bir SaaS paneline giriş yapıp raporu indirmesini söyleyebiliyorsun — “gözle gören el” metaforu burada gerçekten birebir oturuyor.
- Scheduled Tasks (
/loop): Zamanlanmış görevler tanımlayabiliyorsun. Claude Code gece boyunca hata loglarını tarayıp sabah sana özet sunuyor; sen ofise geldiğinde aksiyon listesi seni bekliyor. - Remote Control: Yerel makineden bağımsız görev yürütme kapasitesi — ajan çalışmak için senin bilgisayarının açık olmasına ihtiyaç duymuyor.
3. Claude Code Nasıl Çalışır? Gather → Action → Verify
Claude Code’u ilk çalıştırdığında dikkatini çeken şey şu: hemen cevap vermek yerine önce anlıyor.
Gather: Projeyi tarar, bağlamı kurar, belirsiz noktalarda soru sorar. Körü körüne ilerlemek yerine önce zemin oluşturuyor.
Action: Plan hayata geçiyor — dosyalar düzenleniyor, komutlar çalıştırılıyor. Hata gelirse ajan geri adım atıp alternatifi deniyor. Tek bir terminal çıktısına takılıp kalmaz; sorunu farklı açıdan ele alır.
Verify: Testler çalıştırılıyor, çıktı doğrulanıyor, değişiklik sana onaya sunuluyor. Sen neyi kabul edip neyi reddedeceğine odaklanıyorsun; mekanik döngüyü ajan yönetiyor.
Somut senaryo: "Auth servisindeki token yenileme hatasını bul ve düzelt" dedin diyelim. Claude Code şunu yapar: ilgili dosyaları okur, token’ın nerede yanlış expire edildiğini tespit eder, düzeltmeyi uygular, mevcut test suite’ini çalıştırır, hata bulursa kendi değişikliğini gözden geçirir, tüm testler yeşile döndüğünde sana özet sunar. Sen bu sürede başka bir göreve odaklanıyorsun.
Plan Mode — Büyük Değişiklikler İçin Zorunlu
Kapsamlı refactoring işlemlerine başlamadan önce Plan Mode’u alışkanlık haline getir. Bu modda ajan hiçbir şeye dokunmaz — sadece ne yapacağını adım adım listeler. 40 dosyaya el sürülmeden önce planı görmek hem sürpriz maliyetleri sıfıra indiriyor hem de sana gerçek bir kontrol hissi veriyor.
CLAUDE.md — Projenin Anayasası
Proje köküne koyduğun bu dosyayı Claude Code her oturumda okur ve davranışlarını buna göre ayarlar:
`markdown
CLAUDE.md
Proje: E-ticaret Backend API
- Dil: TypeScript (Node.js 20)
- Test framework: Vitest
- Her değişiklikten sonra testleri çalıştır
- PR açmadan önce lint kontrolü yap
- Yorum satırları Türkçe olacak
- Güvenlik açığı içeren bağımlılıkları YÜKLEME
`
Sıfırdan yazmak zorunda değilsin. Ajana "Bu projeyi analiz et ve bir CLAUDE.md oluştur" diyebilirsin — taslağı kendisi üretiyor. İlk 5 dakikanda yapabileceğin en değerli şey bu.
4. Claude Code Nasıl Kurulur? İlk 10 Dakika
`bash
npm install -g @anthropic-ai/claude-code
`
Komutu çalıştır, API key’ini bağla, claude komutuyla başlat. VS Code ve JetBrains için doğrudan editör entegrasyonu var. Claude Desktop üzerinden kodlama dışı görevleri kapsayan daha geniş iş akışları da kurabilirsin.
İlk 10 dakikanda sırayla şunları yap:
1. Mevcut bir projeyi aç
2. "Bu projenin genel yapısını anlat" — bağlam testini yap
3. "Auth modülündeki token yenileme hatasını bul ve düzelt" gibi gerçek bir görevi ver
4. Plan Mode’u aktifleştir, planı gör, onayla
5. CLAUDE.md oluştur ya da ajana oluşturttur
Kaçınılacak 3 hata:
- CLAUDE.md olmadan başlamak — ajan her oturumda “sıfırlanıyor,” bağlam birikmez
- Ajana
"Projeyi iyileştir"gibi belirsiz görevler vermek — hedef net, kapsam sınırlı olmalı - Büyük refactoring’lerde Plan Mode’u atlamak — bir kere sürpriz yaşarsan bir daha atlamazsın
5. Claude Code vs Cursor vs GitHub Copilot — Hangisini Seçmelisin?
| Kriter | GitHub Copilot | Cursor | Claude Code |
|---|---|---|---|
| Kullanım Modeli | Satır tamamlama | Sohbet + tamamlama | Otonom ajan |
| Bağlam Penceresi | Düşük | Orta | 1M token |
| Otonom Görev | ❌ | Kısmi | ✅ |
| Terminal Kontrolü | ❌ | ❌ | ✅ |
| SWE-bench Skoru | — | — | %80,8 |
| Fiyat | $10/ay | $20/ay | Kullanım bazlı* |
*Claude Code, Claude API üzerinden çalışır. Orta yoğunlukta kullanımda aylık $20–60 bandında seyredebilir; sabit bütçe tercih ediyorsan Max planı ($100/ay) daha öngörülebilir bir seçenek. Güncel fiyat detayları için Anthropic’in fiyatlandırma sayfasını kontrol et.
Karar çerçevesi: Satır tamamlama yeterliyse GitHub Copilot, sohbet destekli editör deneyimi istiyorsan Cursor, çok adımlı görevleri devredip sonucu görmek istiyorsan Claude Code. Bunlar birbirini dışlamıyor — Cursor + Claude Code kombinasyonu pek çok iş akışında birbirini tamamlıyor.
SWE-bench Verified hakkında: 500 gerçek GitHub issue’sundan oluşan bu benchmark, araçların demo ortamında değil üretim koşullarında nasıl performans gösterdiğini ölçüyor. Claude Code’un %80,8 skoru her 10 gerçek yazılım probleminden 8’ini doğru çözmek demek. Kategori ortalamasının 2024 başında %30’un altında olduğunu düşününce bu rakamın neden ciddi bir referans noktasına dönüştüğünü anlarsın.
6. Şimdi Başla
Kurulum 5 dakika alıyor. Asıl gecikme araçta değil, karar verme anında oluyor.
Bu hafta dene: Mevcut projende gerçek bir bug’ı al ve Claude Code’a ver. Aksiyona bile geçmene gerek yok — sadece Plan Mode çıktısını izle. Planın ne kadar isabetli olduğunu gördüğünde kalan adımlar kendiliğinden gelecek.
CLAUDE.md başlangıç şablonu ve 10 pratik başlangıç komutu içeren starter kit için bültene katıl — doğrudan e-postana göndereyim. Çevrende bu soruyu soran bir geliştirici varsa bu yazıyı ilet; en iyi tanıtım, canlı bir demo.
Sonuç
Claude Code “daha iyi kod yazan” bir araç değil — seni farklı sorular sormaya zorlayan bir araç. “Ne yazdım?” sorusunun yerini “Ne devrettim, ne doğruladım?” sorusu alıyor. Bu geçiş özgürlüğü kısıtlamıyor; tam tersine zihinsel kapasiteni gerçekten düşünmen gereken yerlere yönlendiriyor.
Öğrenme eğrisi düşük, kurulum basit, getirisi somut. Tek engel başlamamak — bu yazıyı okuyan biri için o engel de kalktı.
Son bir soru: 6 ay sonra hangi görevlerin hâlâ tamamen sende olmasını istiyorsun? Cevabın ne olursa olsun, Claude Code o listeyi kısaltmak için doğru başlangıç noktası.
Sıkça Sorulan Sorular
Claude Code, GitHub Copilot’tan ne farkı var?
GitHub Copilot bir **otomatik tamamlama** aracıdır; sana satır veya fonksiyon önerir, kararı sen verirsin. Claude Code ise **ajansal** çalışır: bir hedef tanımlarsın, araç bunu adımlara böler, dosyaları düzenler, testleri çalıştırır, hataları kendi giderir ve sonucu sana getirir. Copilot bir yardımcı, Claude Code bir ortak gibi davranır. SWE-bench karşılaştırmalarında Claude Code, Copilot’un üzerinde ölçülmüş otonom görev tamamlama oranı sergiliyor.
CLAUDE.md dosyası ne işe yarar?
`CLAUDE.md`, projenin kök dizinine koyduğun ve Claude Code’a **kalıcı talimatlar** verdiğin özel bir dosyadır. Kodlama standartlarını, kullanılan framework’ü, test kurallarını veya “hiçbir zaman production veritabanına dokunma” gibi güvenlik direktiflerini buraya yazarsın. Claude Code her oturumda bu dosyayı okur — bu sayede her seferinde aynı context’i tekrar anlatmak zorunda kalmazsın. Özellikle ekip ortamlarında proje kurumsal belleği görevi görür.
Claude Code SWE-bench’te ne kadar başarılı?
SWE-bench Verified, gerçek dünya GitHub issue’larını otonom olarak çözme üzerine kurulu bir yapay zeka kıyaslama testidir. Claude Code (Claude Sonnet modeli ile), 2025 ölçümlerinde bu testte **%49’a yakın** başarı oranına ulaşarak o dönemdeki kodlama ajanları arasında en yüksek skorlardan birini kaydetti. Bu oran; aracın yalnızca kod önermekle kalmayıp, issue’yu anlayıp bağımsız çözüme ulaşabildiğinin nesnel göstergesidir.
Claude Code ücretsiz mi, yoksa ücretli mi?
Claude Code, Anthropic’in API’si üzerinden token bazlı çalışır; bu nedenle **kullandıkça öde** modeline tabidir. Terminal’den çalıştırmak için bir Anthropic API anahtarı gerekir. Yoğun kullanımda aylık maliyet hızlı yükselebilir — bu nedenle Max plan veya Claude.ai Pro aboneliğiyle entegre kullanım alternatifleri değerlendirilmeli. Küçük projeler veya keşif amaçlı kullanım için başlangıç maliyeti düşük kalmaktadır.
Claude Code hangi IDE’lerle çalışır?
Claude Code öncelikli olarak **terminal tabanlı** çalışır; herhangi bir IDE gerektirmez. Ancak VS Code ve JetBrains eklentileri mevcuttur. Ayrıca Claude.ai’nin web arayüzü üzerinden “Artifacts” özelliğiyle sınırlı kodlama desteği de alınabilir. Terminal bağımsızlığı, özellikle uzak sunucu veya Docker ortamlarında çalışan geliştiriciler için büyük avantaj sağlar.
**Bonus (isteğe bağlı eklenebilir):** **S6: Vibe coding nedir, Claude Code ile bağlantısı var mı?** → İç link + tanım yazısına yönlendirme için kullanılabilir.
—
Tolga Vuranel
Dijital Dönüşüm Danışmanı & Üretken Yapay Zeka Eğitmeni · Hit & Hand Media