Lesson 01 · 8 dk okuma

Claude Code nedir, neden chatbot değil

Claude Code'un tek-shot LLM çağrısından farkı, harness kavramı ve agentic workflow temelleri.

Öğreneceklerin

  • Tek-shot prompt ile harness arasındaki farkı kavra
  • Agent / command / skill / hook / workflow ayrımını gör
  • Claude Code'un ekosistem mantığını anla

Çoğu kişi Claude’u tek bir konuşma penceresi olarak biliyor: bir şey sor, cevap gelsin. Bu tek-shot LLM çağrısı. Soru sorarsın, model üretir, biter. Tarayıcıdaki claude.ai böyle çalışır.

Claude Code başka bir şey: harness. Yani Claude’u bir oyun motoru gibi sarmalayan, tool’lara erişim veren, dosya okuyup yazabilen, terminal komutu çalıştırabilen, repo’nun durumunu takip edebilen, kuralları (CLAUDE.md, rules) context’e enjekte eden, oturumu compact eden, hook’larla deterministik tetiklemeler yapan, sub-agent dispatch eden bir yapı. Bir konuşma penceresi değil; bir geliştirme ortamı.

Tek-shot: bir adım. Harness: deterministik orkestrasyon.

Harness’ın bileşenleri

Aşağıdakilerin hepsi “Claude Code”u oluşturur — sadece model değil, tüm orkestrasyon:

  • CLAUDE.md & rules: repo başına oturum başında yüklenen kurallar.
  • Slash commands: /help, /review, /compact, ya da kendi yazdığın /standup gibi yeniden kullanılabilir prompt’lar.
  • Sub-agents: özel rol + sınırlı tool seti olan, ihtiyaca göre dispatch edilen yardımcı ajanlar (örn. Explore codebase taraması yapar).
  • Skills: belirli bir konuda uzmanlaşmış, on-demand yüklenen prosedürel rehberler (bu repo gibi).
  • Hooks: 27 lifecycle olayında shell komutu çalıştırma (PreToolUse, PostToolUse, Stop, SessionStart…).
  • MCP servers: Chrome DevTools, Slack, Postgres gibi dış sistemlere standart protokolle bağlanma.
  • Settings: izinler, env vars, hooks, status line — settings.json üzerinden.
  • Memory & checkpoints: oturumlar arası süreklilik.

Tek başına bunların hiçbiri “sihirli” değil. Beraber çalıştıklarında, deterministik, tekrarlanabilir, denetlenebilir agentic workflow elde edersin — chatbot’tan farkın da burada.

Bir örnek: PR review

Düşün ki her PR’da:

  1. Code review yapılsın
  2. Test suite çalıştırılsın
  3. Linter’dan geçsin
  4. Sonuçlar Slack’e yazılsın

Tek-shot LLM ile bu zincir kırılır — her adımda kullanıcı tıklamak zorunda. Harness ile:

  • Slash command /review workflow’u tetikler
  • Sub-agent code-reviewer kodu okur, yorum üretir
  • PostToolUse hook test çıktısı geldiğinde Slack webhook’unu çağırır
  • Skill kullanılan style guide’ı context’e enjekte eder
  • Settings Slack token’ı env’de tutar

Hiç manuel adım yok; her parça yeniden kullanılabilir; davranış deterministik.

Sıradaki

Bir sonraki lesson’da Claude Code’u kuracağız ve ilk session’ımızı açacağız. CLAUDE.md ve rules’ın context’e nasıl enjekte edildiğini canlı göreceksin.