Claude Code'un Çoklu Ajan Orkestrasyon Sistemi

Claude Code, AgentTool adlı tek bir soyutlama üzerinden çalışan, üretime hazır bir çoklu ajan orkestrasyon sistemi sunuyor. AgentTool; senkron alt ajanlar, asenkron ajanlar, fork alt ajanlar, takım arkadaşı (teammate) ajanlar ve ayrı Claude Code Runner ortamlarında çalışan uzak ajanlar olmak üzere beş farklı ajan türünü yönetip aralarındaki iletişimi yönlendiriyor.

Hangi desenin seçildiği, ajanların birbirine yardımcı mı yoksa engel mi olacağını belirliyor. Senkron alt ajanlar, sonuç dönene kadar ana ajanı bloke ediyor; bu da testleri çalıştırıp sonuca göre düzeltme yapmak gibi birbirine bağımlı adımlar için uygun. Asenkron ajanlar ise arka planda başlatılıyor ve bir API uç noktası yazmak, testlerini oluşturmak, dokümantasyonu güncellemek gibi birbirinden bağımsız görevlerin eşzamanlı yürütülüp iş bitince birleştirilmesini sağlıyor.

Paralel çalışmanın temelinde git worktree izolasyonu var: her ajan, aynı .git geçmişini paylaşan ama bağımsız bir dosya kümesine sahip kendi dizininde çalışıyor; böylece birden fazla ajan aynı kodu değiştirse bile durum bozulmuyor. Ana ajan, alt ajanlar işini bitirdikten sonra birleştirme çakışmalarını açıkça çözüyor; hiçbir değişiklik yapılmayan worktree'ler ise otomatik temizleniyor.

Fork alt ajanlar, üst ajanın sistem promptunu devralarak API isteklerinin önekini önbellekle aynı tutan bir performans optimizasyonu ekliyor; bu gecikmeyi ve maliyeti düşürürken alakasız bağlamın da taşınmasına yol açabiliyor. Yerleşik bir özyineleme koruması, iç içe geçmeyi sınırlayarak kontrolsüz ajan üretimini engelliyor. Claude Code üzerine geliştirme yapan mühendis ekipler için bu ilkeler, ajan orkestrasyonunu geçici bir yöntemden belgelenmiş, üretim seviyesinde bir yeteneğe dönüştürüyor.