Alt ajan (subagent) nedir?

Kısaca

Alt ajan (subagent), ana kodlama ajanının belirli bir işi devretmek için başlattığı, kendi bağlam penceresi, talimatları ve araç izinleri olan yardımcı ajandır. İşi bitince ana ajana yalnızca bir özet döner; böylece ana konuşma ayrıntıyla dolmaz.

Nasıl çalışır?

Ana ajan bir işi alt ajana verir: kod tabanında bir şey aramak, testleri çalıştırıp hataları özetlemek ya da bir değişikliği incelemek gibi. Alt ajan temiz bir bağlamla başlar; okuduğu dosyalar ve komut çıktıları kendi penceresinde kalır, ana ajan yalnızca sonucu görür. Birden çok alt ajan aynı anda da çalışabilir.

Claude Code’da alt ajan tanımlamak

Claude Code’da alt ajanlar YAML başlıklı Markdown dosyalarıdır. Projeye ait olanlar .claude/agents/ altında, kişisel olanlar ~/.claude/agents/ altında durur; /agents komutuyla da yönetilir.

name ve description: alt ajanın adı ve ne zaman kullanılacağı; ana ajan bu açıklamaya bakarak karar verir.
tools: kullanabileceği araçlar; örneğin bir inceleyiciye yalnızca okuma araçları.
model: istersen alt ajan için ayrı bir model.
Dosyanın gövdesi, alt ajanın sistem talimatıdır.

Ne zaman işe yarar?

Alt ajanlar en çok ana konuşmayı temiz tutmak istediğinde işe yarar.

Çok dosya okuyan araştırmalar: ayrıntı alt ajanda kalır, ana bağlam küçük kalır.
Uzmanlık isteyen roller: güvenlik incelemesi, test yazımı, belge hazırlama.
Paralel keşif: birkaç alt ajan farklı modülleri aynı anda tarar.

Sınırları

Alt ajan ana konuşmanın geçmişini görmez; ona verilen görev tarifi tek başına yeterli olmalı. Her alt ajan kendi bağlamını baştan kurduğu için toplam token harcaması artabilir. Alt ajanlar genelde ana ajanla aynı klasörde çalışır; dosya değiştiren paralel alt ajanlar birbirinin işine karışabilir.

AgentVera’da alt ajanlar

AgentVera, Claude Code’un başlattığı alt ajanları görünür kılar. Proje turu ve kod haritası penceresindeki Alt ajanlar görünümü, bir Claude Code ajanının başlattığı alt ajanları listeler.

Her alt ajanın türü, arka planda çalışıp çalışmadığı, durumu, araç sayısı ve süresi; adımları zaman çizelgesinde.
Yerel konuşma kayıtlarından okunur ve şimdilik yerel Claude Code ajanlarında çalışır.
Görev hattı ve Araştır, planla, geliştir ise alt ajan yerine ayrı, görünür ajanlar kullanır: her aşamanın kendi paneli vardır, teslim dosyalarla yapılır (Pro ve Team).

Sık sorulanlar

Alt ajan ile ayrı bir ajan oturumu arasındaki fark nedir?

Alt ajanı ana ajan başlatır ve sonucu ona döner; sen genelde yalnızca özeti görürsün. Ayrı bir oturum kendi başına çalışır ve onunla doğrudan konuşursun.

Alt ajanlar token tasarrufu sağlar mı?

Ana konuşmanın bağlamını küçük tutar, bu da uzun oturumlarda işe yarar. Ama alt ajanın kendi okumaları da token harcar; toplam tüketim artabilir.

Alt ajan dosya düzenleyebilir mi?

Tanımında izin verilen araçlara bağlı. Yalnızca Read, Grep ve Glob verilen bir alt ajan kodu okuyabilir ama değiştiremez.

Alt ajan dosyalarını nereye koymalıyım?

Ekiple paylaşacakların projede .claude/agents/ altına, yalnızca senin kullanacakların ~/.claude/agents/ altına. Proje klasöründekiler git ile ekibe de gider.