“Claude Code nedir, Claude CLI nedir, farkı ne?” sorusu aslında yanlış kurulmuş bir soru — ikisi aynı şey, sadece isimlendirme farkı. Asıl soru şu olmalı: bu bir sohbet botu mu, yoksa bir şey mi? Cevap: bir şey. Terminalde çalışan, projenizin dosyalarına ve sisteminize doğrudan erişebilen bir AI ajanı.
Sohbet Penceresi ile Terminal Ajanı Arasındaki Fark
Bir AI’ya web arayüzünden “bu Dockerfile’ı optimize et” dediğinizde, o size bir metin bloğu döndürür. Siz onu kopyalar, dosyaya yapıştırır, denersiniz, hata alırsanız hatayı tekrar yapıştırıp sorarsınız. Her adımda siz köprüsünüz.
Claude Code’da aynı istek şöyle işler: ajan projenizdeki Dockerfile’ı kendisi okur, değişikliği kendisi yapar, docker build komutunu kendisi çalıştırır, hata çıkarsa hatayı kendisi görür ve düzeltir — siz sadece sonucu onaylarsınız. Bu, “bana söyle” ile “benim için yap” arasındaki fark.
Somut Yetenek Listesi
Bir terminal ajanının “kod yazmaktan” fazlası olduğunu göstermek için, gerçekten yapabildiği şeylerden bir kesit:
- Dosya sistemi: Projenin herhangi bir dosyasını okur, arar (regex/glob), düzenler veya yeni dosya oluşturur.
- Shell/komut çalıştırma:
npm run build,go test,git commit,docker compose up— terminalde yazabileceğiniz her şey. - Git/GitHub: Commit atar, branch açar, PR oluşturur (uygun erişim varsa).
- Uzak sunucular: SSH üzerinden bir VPS’e bağlanıp komut çalıştırabilir (bu sitenin Docker/Traefik migrasyon hikayesi tam olarak bu yetenekle yapıldı).
- MCP sunucuları üzerinden harici servisler: MCP standardını destekleyen herhangi bir servise (Cloudflare, bir VPS sağlayıcısının API’si, bir veritabanı) bağlanabilir.
- Alt-ajanlar (subagent) başlatma: Büyük bir görevi, her biri kendi bağlamında çalışan paralel alt-görevlere bölebilir.
Ne Zaman Kullanılır, Ne Zaman Kullanılmaz
Uygun olduğu durumlar:
- Tekrarlayan, mekanik ama çok dosyayı kapsayan işler (örn. 40 sayfaya aynı component’i eklemek).
- Bir sistemi uçtan uca anlayıp (kod + altyapı + harici servisler) bütünsel bir değişiklik yapmak gerektiğinde.
- Hızlı deneme-doğrulama döngüsü gereken DevOps/debug görevlerinde (bir şeyi dene, test et, sonucu gör, düzelt).
Dikkatli olunması gereken durumlar:
- Geri alınamaz işlemler (veri silme, production’a doğrudan push, ödeme tetikleyen aksiyonlar) — burada “ajan ne kadar yetenekli” değil, “süreç ne kadar doğrulanabilir” önemli. Her riskli adımdan önce onay istemek, sonrasında test etmek gerekir.
- Ajanın hiç görmediği, dokümantasyonsuz, çok özel bir iç sistem — burada insan bağlamı hâlâ ajandan daha değerli olabilir.
Pratikte Neye Benziyor?
Bu sitenin kendi altyapısı, bu yeteneklerin gerçek bir örneği: Go API’yi Docker’a taşımak, Cloudflare firewall kurallarını yönetmek, GSC/GA4 API’lerine bağlanmak, güvenlik açığı taramak — hepsi terminaldeki bir ajan tarafından, ama her adımda doğrulanarak yapıldı. O hikayenin detaylarını ayrı bir yazıda anlattım; orada iki kez yanlış yaklaşım denedim ve ikisinde de production hiç bozulmadı — çünkü “dene, test et, gerekirse geri al” döngüsü hep açıktı. Bu döngüyü kurabilmek, aracın kendisinden daha önemli.