Subagents — Claude Code 101

Claude görevleri subagent’lara delege edebilir. Subagent’lar bu görevleri parçalara ayırıp paralel çalıştırır, böylece context yönetimini iyileştirir. Her subagent kendi izole context window’unda çalışır.

Ders videosu

Nasıl çalışır?

Claude Code’da context yönetimi önemlidir. Context window’un büyük kısmı şunlarla tüketilir:

Codebase’i keşfeden tool call’lar
Araştırma için yapılan web search’ler

Claude’un bu keşif sırasında bulduğu şeyler ana feature’ınla her zaman alakalı değildir.

İşte burada subagent’lar devreye girer. Claude bir subagent spawn eder (oluşturur) — örneğin “bu codebase’i benim için keşfet” görevi için. Subagent:

Kendi context window’unda paralel çalışır
Tüm keşif işini yapar
Bittiğinde bulgularını özetler
Sadece özeti ana ajana döner

Sonuç: Aradığın cevabı alırsın — ama oraya ulaşmak için yaptığı tüm yolculuk ana context’ini doldurmaz.

Kendi subagent’ını oluşturmak

Subagent’lar YAML frontmatter’lı Markdown dosyalarında tanımlanır. Başlamanın en kolay yolu — Claude’a oluşturtmak. Şunu çalıştır:

/agents

Sonra “Create new agent” seç. Şu adımlardan geçeceksin:

Ajanın scope’unu (kapsamını) seçmek
Amacını tanımlamak
Erişebileceği tool’ları seçmek
Hatta ona bir renk belirlemek

Claude subagent için bir isim, açıklama ve prompt üretir. Bu, aynı zamanda Claude’a — verdiğin prompt’lara göre — subagent’ı ne zaman çağırması gerektiğini söyler.

Daha ileri özelleştirme

Subagent’lar daha da özelleştirilebilir:

Persistent memory (kalıcı bellek)

Subagent’ının konuşmalar arasında bellek tutmasını sağlar. Aynı projelerde sürekli kullanıyorsan harikadır.

Preloaded skills (önceden yüklenmiş skill’ler)

Subagent’a skill key’i ekleyip skill’leri isim ile listeleyerek preload edebilirsin.

Özet

Context window’unu temiz tutmak, Claude Code’la verimli olmanın en iyi yollarından biridir. Subagent’larla ağır işi arka planda yapan bir ajan çalıştırabilir, sadece cevabı ana context window’una döndürebilirsin.

Daha derine inmek istiyorsan: Introduction to subagents — buna ayrılmış özel kurs.

Sırada ne var?

Bir sonraki derste Skills’i işleyeceğiz — Claude’a tekrarlanabilir uzmanlığı kazandırmanın bir başka güçlü yolu.