Alt Agent ne zaman kullanılmalı rehberi
Claude Code'da Agent tool var. Konusma sirasinda bagimsiz bir alt Agent baslatip is yaptirabiliyorsunuz. Alt Agent'in kendi context'i var, isini bitirince sonucu ana Agent'e donduruyor.
Kulaga guclu geliyor ama pratikte cogu durumda buna ihtiyaciniz yok. Bu yazi net bir sekilde anlatiyor: alt Agent ayirmak ne zaman gercekten ise yariyor, ne zaman sadece karisiklik yaratiyor.
CLAUDE.md veya slash command icerisinde Agent tool'u dogrudan cagiramazsiniz — bu, Claude Code'un kendisinin kullanip kullanmamaya karar verdigi dahili bir tool. Ama prompt'larla kararini yonlendirebilirsiniz.
Alt Agent'in calisma sekli:
Temel ozellikler:
- Bagimsiz context: Alt Agent ana konusma gecmisini goremez, sadece baslatilirken verilen prompt'u gorur
- Sonuc sikistirma: Alt Agent dahili olarak kac dosya okursa okusun, kac komut calistirirsa calistirsin, ana Agent'e donen sadece bir ozettir
- Paralel calisabilir: Birden fazla alt Agent ayni anda baslatilabilir
En tipik senaryo. Claude Code'dan bir sorunu arastirmasini istiyorsunuz ve ayni anda birden fazla yonu kontrol etmesi gerekiyor.
Ornegin soruyorsunuz: "Bu projedeki kimlik dogrulama mekanizmasi nasil uygulanmis?"
Alt Agent olmadan Claude Code sirayla calisir: auth controller oku → middleware oku → routes oku → model oku → config oku… adim adim, yavas.
Alt Agent'lere ayirinca:
Ayni anda 3 alt Agent baslat:
- Agent 1: Controller ve middleware katmanindaki kimlik dogrulama mantigi
- Agent 2: Model katmanindaki kullanici ve session tasarimi
- Agent 3: Konfigürasyon dosyalari ve ortam degiskenlerindeki kimlik dogrulama ayarlari
Uc yon ayni anda calisiyor, sonuclar birlestiriliyor. CLAUDE.md'de suna benzer bir yonlendirme yapabilirsiniz:
## Arastirma Gorevleri
Birden fazla modulu kapsayan bir sorunu arastirmak gerektiginde,
oncelikle birden fazla alt Agent'i paralel olarak baslatip ayri ayri arastirma yaptirin,
sonra sonuclari birlestirin.
Claude Code'un context penceresi sinirli. Eger bir alt gorev cok fazla dosya okumasi gerektiriyor ama sonunda tek bir sonuc yeterliyse, alt Agent "surec copunu" ana context'in disinda tutar.
Tipik ornekler:
Bu gorevlerin ortak ozelligi: girdi buyuk, cikti kucuk. Alt Agent dahili olarak buyuk miktarda bilgiyi isler, sadece ozunu dondurur.
Bazi gorevlerde isin bozulup bozulmayacagindan emin degilsiniz. Alt Agent'i isolation: "worktree" parametresiyle kullanirseniz, bagimsiz bir git worktree'de calisir. Bir sey bozulsa bile mevcut calisma dizininizi etkilemez.
## Yuksek Riskli Refactoring
Genis kapsamli refactoring gorevleri icin worktree izolasyonlu alt Agent kullanin.
Sonucun dogru oldugunu onayladiktan sonra merge edin.
Uygun senaryolar:
- Deneysel refactoring: bir yaklasimin ise yarayip yaramayacagindan emin degilsiniz, once alt Agent denesin
- Paralel yaklasim karsilastirmasi: iki farkli sekilde ayni anda uygulayin, sonuclari karsilastirin
- Kod uretimi: cok sayida boilerplate kod uretin, review ettikten sonra merge edin
"Bu fonksiyon adini camelCase'den snake_case'e cevir" — dogrudan yapin. Alt Agent baslatmanin yuku (context olusturma, sonuc bekleme, sonuc ayristirma) dogrudan yapmaktan daha yavas.
Karar kriteri: Bir Grep + bir Edit ile hallediliyorsa, Agent ayirmayin.
"Once config oku → config'e gore kodu degistir → degisikliklere gore testleri guncelle"
Bu tur zincir bagimlilikli gorevlerde her adim bir onceki adimin sonucuna baglidir. Alt Agent'lere ayirirsiniz, ara sonuclari prompt'larda ileri geri tasimak zorundasiniz — hem zahmetli hem bilgi kaybi riski yuksek. Sirali calistirin, olsun bitsin.
Alt Agent bir ozet metin dondurur, yapilandirilmis veri degil. Alt Agent'in hassas bir degisiklik yapmasini istiyorsaniz (ornegin 47. satira belirli bir kod eklemek), bunu dogrudan ana Agent'e yaptirmak daha guvenilir.
Alt Agent "arastirip sonuc vermek" icin uygun, "hassas degisiklik uygulamak" icin degil.
Konusma yeni basladiysa ve context penceresi hala bossa, "context'i korumak" icin Agent ayirmaniza gerek yok. Konusma uzayip ana Agent mesaj gecmisini sikistirmaya basladiginda, agir isler icin alt Agent kullanmayi dusunun.
Gercek bir senaryo ornegi: bir Rails projesinde before_action kullanan tum controller'lari arastirmak, kimlik dogrulama ve yetkilendirme uygulama kaliplarini analiz etmek.
Alt Agent olmadan:
Claude Code controller dosyalarini tek tek okur, her okunan dosya ana context'i isgal eder. 20 controller varsa, sadece dosya icerikleri bile cok fazla token tuketebilir. Sonunda analiz verirken, onceden okunan detaylar sikistirilmis ve kaybolmus olabilir.
Alt Agent ile:
Alt Agent baslat: "app/controllers/ altindaki tum controller'lari oku,
tum before_action callback'lerini bul, kimlik dogrulama ve yetkilendirme kaliplarini analiz et,
kategorilere gore bir ozet ver."
Alt Agent kendi context'inde tum dosyalari okur, temiz bir ozet dondurur. Ana Agent'in context'i neredeyse hic tuketilmez, sonucu alir ve hemen devam edebilir.
Claude Code'u alt Agent kullanmaya veya kullanmamaya zorlayamazsiniz, ama CLAUDE.md uzerinden tercih belirtebilirsiniz:
## Agent Kullanim Tercihleri
### Alt Agent'e Ayrilmasi Gereken Gorevler
- Moduller arasi arastirma (ayni anda 3+ dizin kontrolu)
- Genis kapsamli kod arama ve istatistik
- Kesfedici refactoring (worktree izolasyonuyla)
### Alt Agent'e Ayrilmamasi Gereken Gorevler
- Tek dosya degisikligi
- Sirali bagimliligi olan cok adimli islemler
- Nerede degisiklik yapilacagi belli olan bug fix'ler
Bu gorevin "sureci", "sonucundan" cok daha buyuk mu?
Eger evet — alt Agent kullanin, sureci hazmetsin ve sadece sonucu dondursun.
Eger hayir — dogrudan yapin, araya katman eklemeyin.
Alt Agent ne kadar cok o kadar iyi degildir. Bu bir context yonetim araci, bir concurrent programming framework'u degil. Dogru kullanildiginda Claude Code buyuk projelerde berrakligini korur. Yanlis kullanildiginda sadece baslangic suresi israf edilir.