Bir araştırma sorusu için yüzlerce dosya tarattın, sonuçlar ana konuşmayı doldurdu, birkaç tur sonra Claude’un aslında ne yapmaya çalıştığını unuttuğunu hissettin mi? Subagent, tam olarak bu sorunu çözmek için var: yan görevi kendi context penceresi olan ayrı bir Claude örneğine devrediyorsun, o işi bitirip sana yalnızca özeti döndürüyor.
Bu yazıda subagent’ın ne olduğunu, hazır gelen üç tipini, kendi subagent’ını nasıl tanımlayacağını ve ne zaman işe yaradığını resmi Claude Code dokümantasyonuyla anlatıyoruz.
Subagent Nedir, Neden Context’i Koruyor?
Resmi dokümantasyona göre her subagent kendi context penceresinde, kendi sistem prompt’uyla, sınırlı araç erişimiyle ve bağımsız izinlerle çalışır. Claude bir görevin bir subagent’ın tanımına uyduğunu görünce işi ona devrediyor; subagent bağımsız çalışıp sonucu döndürüyor.
Ham verinin nerede kaldığı fark yaratıyor: subagent olmadan arama sonuçları, log dosyaları ve onlarca dosya içeriği ana konuşmaya yığılır; subagent ile bu ham veri kendi penceresinde kalır, sana sadece işine yarayan özet ulaşır.
Hazır Gelen Üç Subagent
Hiçbir şey tanımlamadan kullanılabilen üç hazır subagent var. Explore, kod tabanında değişiklik yapmadan arama/anlama işlerine bakıyor; CLAUDE.md dosyalarını ve git durumunu yüklemediği için hızlı ve ucuz. general-purpose, hem arama hem değişiklik gerektiren ya da karmaşık akıl yürütme isteyen görevler için. Plan ise uygulama stratejisi tasarlıyor, kritik dosyaları belirliyor, mimari kararları tartıyor.
Kendi Subagent’ını Oluşturmak
Subagent’lar, YAML frontmatter’lı Markdown dosyaları. .claude/agents/ (proje düzeyinde) ya da ~/.claude/agents/ (kullanıcı düzeyinde, her projede geçerli) klasörüne bir dosya bırakman yeterli — ya da Claude’dan senin için yazmasını isteyebilirsin. Frontmatter’da yalnızca name ve description zorunlu; geri kalan alanlar (araç kısıtlaması, model seçimi, izin modu) opsiyonel.
---
name: code-improver
description: Kod kalitesini inceler, iyileştirme önerir
tools: Read, Grep, Glob
model: sonnet
---
Sen bir kod kalitesi uzmanısın. Verilen dosyaları oku,
tekrar eden desenleri, gereksiz karmaşıklığı ve test
boşluklarını belirle. Değişiklik yapma, sadece raporla.Dosyanın gövdesi subagent’ın sistem prompt’u oluyor — subagent, Claude Code’un tam sistem prompt’unu değil, sadece bu metni ve çalışma dizini gibi temel ortam bilgilerini alıyor.
Ne Zaman Kullanmalı, Ne Zaman Kullanmamalı
Sınırlı bir yan görev, başka bir yerde tekrar referans vermeyeceğin sonuçlar üretiyorsa (arama, log tarama, dosya içeriği analizi) subagent’a devret.
Aynı tür iş için tekrar tekrar aynı talimatları yazıyorsan, bunu özel bir subagent olarak tanımla — projeler arası yeniden kullanılabilir.
Sonucun ana konuşmanın akışına sıkı sıkıya bağlı olduğu, adım adım senin onayını gerektiren işlerde subagent’a devretmek fazladan bir dolaylı katman ekler — doğrudan ana konuşmada kal.
Sınırlamalar: İç İçe Derinlik
Bir subagent kendi subagent’ını doğurabiliyor — ama sınırsız değil. Ana konuşmadan itibaren en fazla 3 katman derinliğe kadar. Sınıra ulaşıldığında o katmandaki subagent’ın elinden Agent aracı alınıyor — artık yeni bir alt görev başlatamıyor, kendi işini kendisi bitirip tek bir özetle dönmek zorunda kalıyor.
Sık Sorulan Sorular
Subagent oluşturmak için kod yazmam gerekir mi?
Hayır, YAML frontmatter’lı bir Markdown dosyası yeterli. Claude’dan senin için yazmasını da isteyebilirsin.
Hazır gelen subagent’ları devre dışı bırakabilir miyim?
Evet, belirli bir tipi permissions.deny listesine ekleyerek engelleyebilir ya da CLAUDE_CODE_DISABLE_EXPLORE_PLAN_AGENTS=1 ortam değişkeniyle Explore ve Plan’ı tamamen kaldırabilirsin.
Subagent hangi modeli kullanıyor?
Belirtmezsen ana konuşmanın modelini miras alır. Özel bir subagent tanımında frontmatter’a model alanı ekleyerek farklı (örneğin daha ucuz) bir model seçebilirsin.
Kaç subagent aynı anda çalışabilir?
Birden fazla subagent paralel çalışabilir; en iyi sonucu bağımsız araştırma yollarının birbirine ihtiyaç duymadığı durumlarda veriyor. İç içe derinlik ise ana konuşmadan itibaren 3 katmanla sınırlı.
Subagent’ları belirli olaylarda otomatik tetiklemek istersen Claude ile Zamanlayıcı Kullanımı yazımıza bakabilirsin — /loop ve Routines, subagent’larla birlikte kullanılabilen tamamlayıcı mekanizmalar.
Bir Yorum Yazın