Canpolat Kaya

Agentic Coding

Claude Code CLI ile Terminal Odaklı Agentic Coding: Kurulum ve Best Practices

Anthropic'in yeni nesil terminal ajanı Claude Code'un nasıl çalıştığını, kod tabanını bağımsız analiz etme yeteneklerini ve geliştirici verimliliğini artıran pratikleri öğrenin.

3 dk

Özet & Doğrudan Çözüm (TL;DR)

Claude Code, Anthropic tarafından geliştirilen ve doğrudan yerel terminalde çalışan otonom bir kodlama ajanıdır. Web tabanlı chatbot'lardan farklı olarak tüm proje dosya ağacını, git geçmişini ve bağımlılıkları okur; test komutlarını çalıştırıp hata veren kodları bağımsız olarak onarır.

Önemli Çıkarımlar:

  • Terminal merkezli mimari: Web UI gerektirmeden dosya düzenleme, test yürütme ve git commit süreçlerini otonom yönetir.
  • Gelişmiş bağlam daraltma: Geniş kod depolarında token maliyetlerini %60'a varan oranda düşüren akıllı filtreleme uygular.
  • AGENTS.md ve CLAUDE.md standartları: Proje mimari sınırlarını ve güvenlik kurallarını depodan okuyarak insan denetimini korur.

Claude Code Nedir ve Klasik Chatbot'lardan Neden Farklıdır?

Ajanik Davranış

Claude Code, tek adımlı bir tamamlayıcı değil; problem çözülene kadar dosyaları okuyan, düzenleyen ve test eden döngüsel bir ajandır.

Claude Code, tarayıcı tabanlı sohbet arayüzlerinin aksine doğrudan geliştiricinin terminalinde (CLI) çalışan, tüm yerel git deposunu, dosya ağacını ve bağımlılıkları bağlam (context) olarak okuyabilen otonom bir kodlama ajanıdır.

Sadece kod önermekle kalmaz; terminal komutlarını çalıştırır, testleri yürütür, derleme hatalarını (build errors) analiz eder ve git diff oluşturup commit atabilir.

Kurulum ve İlk Başlatma

Claude Code'u sisteminize kurmak için global npm paketini yükleyebilir ve doğrudan proje dizininizde başlatabilirsiniz:

terminal
# Claude Code CLI'ı global olarak yükleyin
npm install -g @anthropic-ai/claude-code

# Proje dizininize gidin ve ajanı başlatın
cd /path/to/my-project
claude
  • ANTHROPIC_API_KEY ortam değişkenini otomatik okur.
  • Projedeki .gitignore ve mimari kuralları analiz eder.
  • Geniş kod tabanlarında maliyet optimizasyonu için akıllı bağlam daraltma uygular.

Gelişmiş Görev Senaryoları ve Pratik Kullanımlar

Büyük bir Next.js veya FastAPI projesinde hata ayıklarken Claude Code'a hedef odaklı talimatlar verebilirsiniz. Örneğin, testleri çalıştırıp başarısız olanları otomatik düzeltmesini isteyebilirsiniz:

claude-prompt-example
# Testleri çalıştır ve hata veren uç noktaları düzelt
claude "npm run test:e2e komutunu çalıştır, kırılan sepet akışını analiz et ve src/lib/cart.ts dosyasını onar"

Üretkenlik İçin Best Practices

Agentic araçların başarısı, projenizdeki bağlam belgelerine doğrudan bağlıdır. Depo kök dizininde bir CLAUDE.md veya AGENTS.md dosyası bulundurarak mimari sınırları netleştirin.

  • Projeye özel mimari kuralları AGENTS.md içinde tanımlayın.
  • Kritik veritabanı veya üretim komutları için onay mekanizmalarını aktif tutun.
  • Git branch'leri üzerinde çalışarak ajan değişikliklerini izole edin.

Sıkça Sorulan Sorular

Claude Code internet erişimine sahip mi?

Evet, araştırma ve güncel kütüphane dokümantasyonlarını okumak için kontrollü arama araçlarını kullanabilir.

Cursor veya Copilot'tan farkı nedir?

IDE eklentisi olmak yerine doğrudan terminal ortamınızda otonom görevler (test çalıştırma, git yönetimi, dosya refactor) yürüten bir agentic CLI olmasıdır.

Doğrulanmış Kaynaklar ve Dokümantasyon