Claude Code Ajanları ve Subagent Mantığı: Nasıl Çalışır?

Claude Code ajanı; sistem prompt’u, araç seti ve sınırlardan oluşan, genel bir yapay zekayı isimli bir uzmana dönüştüren rol tanımıdır. Subagent ise ana oturumun bu rolü çalıştırmak için görevlendirdiği izole işçidir; kendi temiz bağlam penceresinde çalışır, işi bitince rapor verir. Çoğu anlatım tanımda durur. Bu rehber daha ileri gidiyor: ikisi birbirine nasıl bağlanır, gerçek ajanlar işi birbirine nasıl devreder ve tek ajan ne zaman ekipten daha doğru tercihtir. Burada üretimden konuşabiliyoruz, çünkü her gün müşteri işi koşan 18 uzman ajanı hem çalıştırıyor hem satıyoruz.

Claude Code ajanı nedir?

Ajan, yapay zekaya giydirilmiş paketlenmiş bir kimliktir: modelin bu rolde kim olduğunu, neye dokunabileceğini ve işinin nerede bittiğini tanımlayan bir markdown dosyası. Tipik bir ajan tanımı dört şey taşır. Modeli genelcilikten uzmanlığa daraltan bir rol tanımı. Yalnızca rolün ihtiyacını veren bir araç izin listesi; içerik ajanı web araması ve dosya düzenleme alır, reklam hesabını almaz. O disiplinin yöntemlerini, kalite kapılarını ve yasak hamlelerini içeren çalışma kuralları. Ve sınırlar: bu ajanın yapmadığı işlerin ve o işin sahibinin açıkça yazıldığı liste.

Jenerik makalelerin atladığı parça bu sonuncusu ve ajanı pratikte çalışır kılan da o. Claude ajanlarımıza göz atın, 18 tanımın hepsinde aynı deseni görürsünüz: code-architect kodu yazar ve yeniden yapılandırır ama görsel marka yönü icat etmez; seo-alchemist organik arama analizinin sahibidir ama reklam harcaması sorularını growth-engineer’a devreder; sim-matrix kaliteyi doğrular ama tek satır kod yazmaz, yalnızca geçti veya kaldı kararı döndürür. Sınırı olmayan ajan, adı değiştirilmiş bir sohbet botudur. Sınırı olan ajan, takvimine iş yazabileceğiniz bir mesai arkadaşıdır.

Format, sanıldığından daha az önemli. Ajan tanımları küçük bir frontmatter bloğu taşıyan düz markdown dosyalarıdır. Claude Code için tasarlandılar; ama kapalı bir konfigürasyon değil okunabilir talimat oldukları için, rol mantığı küçük uyarlamalarla MCP uyumlu her yapay zeka asistanına taşınır.

Subagent nedir?

Ajan iş tanımıysa, subagent o tanımla tek vardiyaya gelen işçidir. Bir Claude Code oturumu uzman işine ihtiyaç duyduğunda görevi bir subagent’a gönderir: seçilen ajan tanımıyla yüklenmiş, belirli bir brief almış ve tamamen temiz bir bağlam penceresiyle başlatılmış taze bir model kopyası.

Subagent davranışını üç özellik belirler. Birincisi izolasyon: subagent ana konuşmanın geçmişini devralmaz. Yalnızca brief’ini ve kendi keşfettiklerini görür; yirmi eski konunun bağlam kirliliği yoktur, alakasız geçmişe token bütçesi de harcanmaz. İkincisi tek görev kapsamı: subagent bir işi sonuna kadar koşar ve onu başlatan oturuma nihai bir rapor döndürür. Üst oturum subagent’ın tüm çalışma dökümünü değil, raporu okur. Üçüncüsü iç içe geçme yasağı: subagent kendi subagent’ını başlatamaz. Hiyerarşi tam iki katman kalır; bir orkestratör ve işçileri. Sistem böylece fraktal değil, ayıklanabilir kalır.

Pratik kazanç paralelliktir. Ana oturum aynı anda birden fazla subagent görevlendirebilir; biri analitiği denetler, biri içerik taslağı yazar, biri kodu inceler. Her biri kendi temiz odasında çalışırken orkestratör sonuçları birleştirir. Asistan ile kadrolu operasyon arasındaki fark tam olarak budur.

Ajan ile subagent arasındaki fark nedir?

Ayrımı tutmanın en temiz yolu: ajan bir tanımdır, subagent bir yürütmedir. Ajan, iş başlamadan önce var olan ve iş bittikten sonra da duran bir dosyadır. Subagent ise bir çalışma anıdır; görev gönderilince doğar, rapor teslim edilince biter.

Bu yüzden “ajan mı subagent mı, hangisi lazım?” sorusu hafif yanlış kurulmuştur. İkisi arasında seçim yapmazsınız; iki yarıya birden ihtiyacınız vardır. Ajan dosyası işi ne tür bir uzmanın ele alacağına karar verir: yöntemi, araç seti, sınırları. Subagent mekanizması o uzmanın nasıl çalışacağına karar verir: izole, paralel ve yukarıya raporlayarak. Tek bir ajan tanımı yüzlerce subagent koşusunu besleyebilir; tek bir iş tanımının yıllarca vardiyayı karşılaması gibi. Aynı oturum, aynı saat içinde farklı ajan tanımlarından subagent’lar da koşturabilir; bir şeritte SEO uzmanı, diğerinde geliştirici.

Adı konması gereken bir asimetri daha var. Kalite büyük ölçüde ajan tanımında yaşar; güvenilirlik büyük ölçüde subagent mekaniğinde. Bulanık bir ajan dosyası, koşu ne kadar temiz izole edilirse edilsin bulanık iş üretir. Keskin bir ajan dosyası da her görev tek kirli bağlamı paylaşıyorsa yine tökezler. Üretim kurulumları ikisine birden yatırım yapar.

Ajanlar işi birbirine nasıl devreder?

Çoğu çok-ajanlı içeriğin bulanıklaştığı yer burası; o yüzden müşteri işinde fiilen koştuğumuz görevlendirme modelini somut anlatalım.

İş, orkestratör üzerinden girer; yani ana Claude Code oturumu. Orkestratör görevlendirmeden önce bir görev brief’i yazar: tek cümlelik hedef, kapsamda olanlar, kapsam dışı bırakılanlar, bitti kriterleri ve sonucun nasıl doğrulanacağı. Bulanık görevlendirme bulanık iş üretir; bu yüzden bitti kriteri olmayan brief yola çıkmaz.

Sonra zincir koşar. Ajanlar birbirini doğrudan görevlendirmez; subagent subagent başlatamadığı için her devir orkestratörden geçer. Her ajanın yaptığı şey, raporunu bir devir önerisiyle bitirmektir: işi sıradaki kim almalı ve neden. Bizim kurulumda bir web sayfası değişikliği önce uygulama için code-architect, sonra sayfa içi inceleme için seo-alchemist, en sonda kırılım ve erişilebilirlik denetimi için sim-matrix koşar. Bir içerik parçası yazar ajandan SEO incelemesine, oradan yayına ve görsel doğrulamaya akar. Zincir alışkanlık değil kuraldır: son halka geçti raporu vermeden iş bitmiş sayılmaz.

Bu devirleri temiz kılan şey sınırlardır. Her ajanın tanımı neyi yapmadığını yazdığı için, bir işin nerede bitip diğerinin nerede başladığı tartışmaya açık değildir. İçerik ajanı metni yazar ve SEO denetimini açıkça yapmaz; SEO ajanı inceler ve marka sesini açıkça yeniden yazmaz. Çok-ajanlı sistemler örtüşmede çürür; ilacı, görev koşmadan önce yazıya bağlanmış sahipliktir.

Tek ajan mı, ekip mi? Ne zaman hangisi?

Dürüst pratik kural: görevin dokunduğu uzmanlık alanlarını sayın. Tek alan, tek ajan. İki ve üzeri, ekip.

Kendi içinde kapanan işler için tek subagent doğru tercihtir: toplu dosya yeniden adlandırma, odaklı tek bir hata düzeltmesi, bir araştırma taraması, bir rapor taslağı. Görev tek uzmanlığın içinde başlayıp biter; iyi bir brief ile temiz bir görevlendirme yeter, fazladan ajan yalnızca koordinasyon maliyeti ekler.

İş disiplinleri kestiği anda ekip, maliyetini fazlasıyla çıkarır ve ekibi atlamanın bozulma şekli tahmin edilebilirdir. Bir açılış sayfasını tek başına geliştirici ajana gönderin; yapı doğru gelir ama başlıklar arama niyeti taşımaz. SEO incelemecisi işaretler, iş geri döner ve revizyon döngüsü iki üç tur koşar. Uzmanları zincir işleterek birlikte görevlendirmek, o çarpışmaları üçüncü turda değil ilk geçişte yakalar. Pratikte müşteriye dokunan hemen her şey; sayfalar, kampanyalar, yayına giden içerik, onboarding, çok alanlıdır. Gerçek işte varsayılanımızın yalnız uzman değil zincir olması bundandır.

Ekibi kendiniz kurmadan hazır almak isterseniz, Agency in a Box combo çekirdek ajanları, dayandıkları skill’ler ve bağlayıcılarla birlikte, yukarıda anlatılan sınırlar ve devir kuralları kurulu halde paketler. Önce kavram haritasını tamamlamak için Claude skill nedir rehberine bakın; skill ajana yöntemini verir. MCP nedir rehberi de erişim katmanını anlatır; MCP ajana canlı sistemleri açar. Ajanlar üçüncü katmandır: kimin neyi yapacağına ve işi sıradakine kimin devredeceğine karar veren roller.