Claude Kodunda Alt Temsilciler Nelerdir? Bilmeniz Gerekenler

Alt acenteler (genellikle yazılır) alt acenteler or alt acenteler) aracı geliştirici araçlarındaki en açık pratik gelişmelerden biridir: bunlar, içinde uzmanlaşmış AI asistanlarından oluşan küçük bir ekip oluşturmanıza olanak tanır Claude KoduHer biri kendi rolü, araçları ve bağlam penceresine sahip. Fikir basit ama güçlü: Her şeyi tek bir genel modelden istemek yerine, ana düzenleyicinin işi devrettiği (otomatik olarak veya açıkça talep ettiğinizde) kompakt, tek amaçlı aracılar tanımlarsınız. Bu, karmaşık iş akışlarının bağlamını, araçlarını ve maliyet/gecikme dengelerini yönetme şeklinizi değiştirir.

Alt acenteler nelerdir?

Kısa tanım. Alt ajan, Claude Code'un bir görevi devredebileceği, önceden yapılandırılmış, göreve özel bir yapay zeka "kişiliğidir". Her alt ajanın kendi sistem istemi, kendi (izole) bağlam penceresi, açıkça yetkilendirilmiş araçları ve isteğe bağlı olarak bir model seçimi vardır. Alt ajanlar proje veya kullanıcı düzeyinde oluşturulabilir ve Claude tarafından otomatik olarak veya kullanıcı tarafından açıkça çağrılabilir.

Bir alt acentenin temel özellikleri

Özel amaçlı ve sistem istemi. Alt aracının rolünü, kısıtlamalarını ve yaklaşımını sistem isteminde açıklayın, böylece dar etki alanı için öngörülebilir şekilde davranır (örneğin, kod inceleyicisi, ayıklayıcı, veri bilimci).
Yalıtılmış bağlam penceresi. Her alt aracı kendi konuşma geçmişini ve bağlamını korur ve ana iş parçacığının bağlamının düşük seviyeli ayrıntılarla kirlenmesini önler. Bu, tek bir konuşmanın bağlamını tüketen iş akışlarının ölçeklendirilmesi için çok önemlidir.
Araç kapsamı ve izinler. Bir alt aracının hangi dahili veya harici Model Bağlam Protokolü (MCP) araçlarını kullanabileceğini belirleyebilir veya kısıtlayabilirsiniz. Bu, önemli bir güvenlik ve yönetişim özelliğidir.
Kod olarak yapılandırın. Alt aracılar, YAML ön içeriği (ad, açıklama, araçlar, model) içeren Markdown dosyaları olarak tanımlanır ve proje düzeyinde (.claude/agents/) veya kullanıcı düzeyi (~/.claude/agents/). Proje tanımları önceliklidir.

Otomatik yetki devri ve açık çağrı nedir?

Claude Kodu yapabilir otomatik olarak İsteminiz veya alt temsilciniz geldiğinde görevleri alt temsilcilere devredin description göreve uygun - veya yapabilirsiniz açıkça bir acente talep edin (örneğin, > Use the code-reviewer subagent to check my recent changes). Yapın description eylem odaklı ("Use PROACTIVELY", "MUST BE USED") Otomatik delegasyonu teşvik etmek için, Claude Kanunu'nda alt acenteleri kullanmanın iki tamamlayıcı yolu:

Otomatik delegasyon — Claude talebi inceler ve eşleşen işi proaktif olarak bir alt temsilciye devreder.
Açık çağrı — İsteminizde/komutunuzda bir alt aracıyı adıyla çağırırsınız (örneğin, Use the code-reviewer subagent to check my changes).

Her iki yaklaşımın da farklı kullanıcı deneyimi ve mühendislik avantajları var. Aşağıda her ikisini de ayrıntılı olarak ele alıyorum.

Otomatik delegasyon

Kullanıcılara nasıl görünüyor. Yüksek düzeyli bir komut verirsiniz (örneğin, "Bu yeni kütüphane için bir güvenlik denetimi hazırlayın") ve Claude, bir veya daha fazla alt ajanın aşağıdakilere dayanarak iyi bir uyum olduğunu tespit eder: description Yapılandırmalarındaki alan. Proaktif kullanım için yapılandırılırsa, alt aracı otomatik olarak gönderilir ve sonuçları yapılandırılmış çıktılar olarak döndürür.

Takımlar neden bunu kullanıyor?

Bilişsel yükü azaltır; her alt temsilcinin adını hatırlamanıza veya yazmanıza gerek kalmaz.
Belirli görevlerin her zaman aynı uzman tarafından ele alınması gereken paylaşımlı iş akışları için daha sorunsuz bir oryantasyon yaratır.

Uyarılar.

Mühendislik yapmalısınız description ve sistem Claude'un güvenilir bir şekilde doğru alt acenteyi seçmesini sağlayacak şekilde kasıtlı olarak hızlı bir şekilde çalışır.
Aşırı istekli delege etme, benzer görevler için birçok alt temsilcinin etkinleşmesi durumunda token kullanımını ve gürültüyü artırabilir; açıklamalarınızı muhafazakar bir şekilde tasarlayın.

Açık çağrı

Kullanıcılara nasıl görünüyor. Alt acenteyi açıkça çağırırsınız: > Use the test-runner subagent to run the project testsOrkestrasyon kesindir: Claude, önceden yapılandırılmış izinleri ve istemiyle adlandırılmış alt aracı çağırır.

Takımlar neden bunu kullanıyor?

Tam kontrol: Hangi uzmanın çalışacağına tam olarak siz karar verirsiniz, bu da hata ayıklamayı ve yeniden üretilebilirliği basitleştirir.
CI veya otomatikleştirilmiş betiklerde maliyetler ve araç erişimi hakkında akıl yürütmek daha kolaydır.

Uyarılar.

Daha fazla yazma ve disiplin: Geliştiriciler veya otomasyon, doğru alt ajan adlarını bilmelidir.
Daha az fırsatçı: Ana temsilcinin otomatik olarak iyi bir alt temsilciyi tespit edebileceği bir yerde bazı kolaylıkları kaybedersiniz.

Alt acenteler nasıl çalışır? Teknik genel bakış

Aşağıda, bir alt aracı oluşturup kullandığınızda neler olacağına dair pratik ve uygulamaya yönelik bir bakış açısı yer almaktadır.

Bir alt aracı tanımlama (kod olarak yapılandırma)

Alt aracı, YAML ön metni içeren bir Markdown dosyasıdır. Önemli alanlar şunlardır:

name — benzersiz küçük harfli kimlik (tireli)
description — otomatik delegasyon eşleştirmesi için kullanılan doğal dil açıklaması
tools — izin verilen araçların isteğe bağlı virgül listesi (veya tüm araçları devralmak için atlanmıştır)
model — isteğe bağlı takma ad (sonnet, opus, haiku) Veya inherit ana konuşmanın modelini kullanmak için

Küçük bir örnek (kavramsal, dokümanlardan birebir alıntı değil):

---
name: code-reviewer
description: Expert code reviewer. Proactively reviews code for quality, security, and maintainability.
tools: Read, Grep, Bash
model: inherit
---
You are a senior code reviewer. Focus on security, correctness, and maintainability.

Bu dosyalar şurada bulunur: .claude/agents/ (proje kapsamı) veya ~/.claude/agents/ (kullanıcı kapsamı). Proje dosyaları önceliklidir, bu da alt ajanların paylaşımını ve sürüm kontrolünü kolaylaştırır.

Model seçimi ve araçları

Model alanı: Alt aracı için belirli bir model takma adı seçebilir veya ana konuşmanın modelini devralmasına izin verebilirsiniz. Bu, maliyet/kalite dengelerini birleştirmenize olanak tanır (örneğin, büyük veri tarama alt aracıları için daha ucuz bir model ve nihai sentez için daha kaliteli bir model kullanabilirsiniz).
Araç kapsamı: Her alt ajana asgari düzeyde bir araç seti sağlamak, patlama yarıçapını azaltır ve güvenlik konusunda akıl yürütmeyi basitleştirir. Araçlar arasında standart Claude Kod ilkelleri (Okuma, Grep, Bash, Düzenleme vb.) ve MCP tarafından sağlanan entegrasyonlar bulunur.

Çalışma zamanı davranışı ve bağlam işleme

Claude bir alt temsilciye yetki devrettiğinde, o alt temsilci şunları alır:

Sistem istemi (YAML/Markdown içerikleri).
Sadece ihtiyaç duyduğu bağlam (kendi bağlam penceresi).
Yapılandırmasında izin verilen araç erişimi.

Her alt ajan izole bir bağlam tuttuğu için, uzun araştırmalar veya büyük dosya analizleri her şeyi tek bir bağlamın tutması yerine birçok küçük bağlama ayrılabilir; bu da hem güvenilirlik hem de yorumlanabilirlik açısından büyük bir kazançtır.

Alt acente için mimari desenler

En yaygın mimari bir orkestraci (Ana etken) üst düzey bir görevi parçalara ayıran, birden fazla alt etken üreten ve ardından çıktılarını sentezleyen veya doğrulayan etkendir. Doğada iki kanonik model görülür:

1) Orkestratör + Uzmanlar

Bir ajan ( orkestraci) birden fazla alt ajanı paralel veya seri olarak koordine eder. Orkestratör hangi uzmanın çağrılacağına karar verir, çıktıları toplar, tutarlılığı doğrular ve nihai entegrasyonu gerçekleştirir. Bu, yaygın "yönetici ekip üyelerine yetki devreder" yaklaşımıdır ve Claude Kod materyallerindeki birçok örnek ve önerilen tasarımla uyumludur. Avantajları arasında paralellik, endişelerin daha net ayrılması ve daha kolay hata kontrolü bulunur (hatalı bir alt ajan yalnızca kapsamını etkiler).

Ne zaman kullanılmalı: Bağımsız alt problemleri olan karmaşık görevler (örneğin, “testler oluştur”, “statik analiz çalıştır”, “bir modülü yeniden yaz” ve ardından “uçtan uca testleri entegre et ve çalıştır”).

takaslar: Orkestrasyon mantığı karmaşık hale gelebilir; ekstra gidiş-dönüşler gecikmeyi biraz artırabilir.

2) Boru Hattı / Zincirli Uzmanlar

Burada alt ajanlar, birinin çıktısının bir sonrakinin girdisi haline geldiği bir sırayla düzenlenir (örneğin, spec → scaffold → implement → test → optimize). Bu, esasen ajanlar olarak ifade edilen bir fonksiyon kompozisyonudur; adım adım dönüşümlere ve verilerin aşamalar arasında nasıl aktığına dair kesin garantilere ihtiyaç duyduğunuzda kullanışlıdır. Doğrusal iş akışları için kavramsal olarak daha basittir ve bazen hata ayıklaması daha kolaydır.

Ne zaman kullanılmalı: Deterministik çok adımlı dönüşümler (örneğin, bir tasarım belgesini önce iskeleli koda çevirmek, sonra testler yapmak, sonra da optimizasyonlar yapmak).

takaslar: Geniş kapsamlı araştırma (araştırma, beyin fırtınası) gerektiren görevler için daha az doğaldır ve tek bir kopuk bağlantı tüm boru hattını durdurabilir.

Alt temsilciyi rol bazlı bir komuttan farklı kılan nedir?

1) Ayrı bağlam pencereleri

Her alt aracı, rolüyle ilgili alışverişleri, dosyaları ve meta verileri depolayan kendi bağlam tamponuna sahip olur. Bu, ana oturumun bağlamının gürültülü ara mesajlarla kirlenmesini önler ve ayrıca her yetenek için geçmişi koruyabileceğiniz veya sınırlayabileceğiniz anlamına gelir. Claude Code, her şeyi tek bir komut istemine doldurmanın getirdiği token maliyeti veya bilişsel yüke katlanmadan, özel görevler için uzun ömürlü, yüksek sinyalli bağlamları korumanıza olanak tanır.

2) Sistem istemleri ve kişileri

Alt aracılar, rollerini, tonlarını ve kısıtlamalarını tanımlayan sistem düzeyindeki talimatlarla oluşturulur (örneğin, "Yalnızca yeniden düzenleme uzmanı olarak hareket et; kabuk komutlarını çalıştırma" veya "Pytest stilinde birim testleri oluştur; yalnızca genel arayüzleri kullan"). Bu komut istemleri, alt aracı için iş tanımları gibi davranır ve Claude Code'un çalışma zamanı tarafından çalışma zamanında uygulanır.

3) Araç bağlamaları ve izin kapsamı

Kritik bir pratik fark: Alt aracılara belirli araçlara (dosya sistemi, işlem yürütme, harici API'ler veya ayrıcalıklı veri kümeleri) erişim izni verilebilir veya erişimleri engellenebilir. Bu, alt aracıları şu konularda güçlü kılar: en az ayrıcalık Tasarımlar: Bir dokümantasyon oluşturucunun keyfi komutları çalıştırması engellenebilirken, bir CI alt aracısına izole edilmiş bir sanal alan verilebilir. Birçok topluluk gönderisi, gizli bilgilere ve G/Ç'ye güvenli erişimi yönetmek için alt aracıların Model Bağlam Protokolü (MCP) veya kanca tabanlı bir MCP sunucusuyla eşleştirilmesini savunmaktadır.

4) Model seçimi ve maliyet-performans dengeleri

Alt aracılar modüler olduğundan, görev karmaşıklığına bağlı olarak farklı temel modeller atayabilirsiniz. Derinlemesine muhakeme için yüksek kapasiteli bir Sonnet modeli veya hızlı ve tekrarlayan görevler için hafif bir Haiku modeli kullanın. Bu heterojen dağıtım, gecikme, belirteç maliyeti ve kapasite arasında denge kurulmasına yardımcı olur. Anthropic'in ürün güncellemeleri ve topluluk makaleleri, uygun maliyetli ölçeklendirme için daha küçük modellerin paralel dağıtımının önemini vurgular.

5) İletişim kalıpları

Alt temsilciler, orkestratörle (veya birbirleriyle) yapılandırılmış mesajlar veya dosyalar aracılığıyla iletişim kurar. Tipik modeller şunlardır:

yapılandırılmış bir JSON yükü döndürüyor (programatik orkestrasyon için tercih edilir),
paylaşılan bir çalışma alanındaki kapsamlı bir dosyaya yazma,
veya düzenleyiciye güven puanı ve gerekçeyi içeren son biçimlendirilmiş bir mesaj göndermek.
Topluluk deneyleri, ekiplerin belirsizliği önlemek için açık, makine tarafından okunabilir devretmeleri tercih ettiğini gösteriyor.

Performans Faydaları

Alt ajanlar yalnızca tasarımsal bir güzelliğe sahip değildir; doğru kullanıldığında pratik performans ve kalite avantajları sağlarlar.

1) Paralellik yoluyla duvar saati süresinin azaltılması

Birden fazla çalışanı eş zamanlı olarak (örneğin, depo klasörü başına, mikro hizmet başına veya veri parçası başına bir çalışan) görevlendirerek, düzenleyici büyük bileşik görevleri tamamlamak için gereken süreyi azaltır. Hata raporlarını sınıflandırmak, birçok modül için dokümantasyon oluşturmak veya birden fazla hizmeti denetlemek gibi kullanım senaryoları doğal olarak uygundur. İş yükleri gerçekten paralel hale getirilebilir olduğunda, geliştirici iş akışlarında önemli hızlanmalar olur.

Her role kendi bağlamını vererek, anında şişkinliği önler ve alakasız geçmiş gürültünün neden olduğu halüsinasyon riskini azaltırsınız. Bu, bağlamla ilgili daha az hata ve özel görevler için daha tutarlı çıktılar anlamına gelir. Topluluk raporları ve Anthropic'in kendi araştırmaları, çoklu aracı kurulumlarının genellikle genişlik öncelikli görevlerde monolitik aracılardan daha iyi performans gösterdiğini göstermektedir. Bir Anthropic iç değerlendirmesi, öncü aracı + alt aracı mimarisi kullanan araştırma tarzı görevlerde önemli gelişmeler olduğunu bildirmiştir.

Uyarı: Paralellik, alt görevler bağımsız olduğunda en iyi kazanımları sağlar. Çalışanlar sürekli olarak birbirlerini beklemek veya yoğun işleri paylaşmak zorunda kalırsa, getirilerin azaldığını görürsünüz.

2) Daha iyi bağlam kullanımı ve daha düşük token israfı

Her ara arama sonucunu tek bir genel bağlama doldurmak yerine, çalışanlar yalnızca ilgili olanları kendi pencerelerinde tutar ve damıtılmış çıktılar döndürür. Bu, düzenleyici için belirteç tüketimini azaltır ve bağlam sınırlarına ulaşma riskini azaltır; bu da büyük kod tabanları, uzun günlükler veya büyük belge depolarıyla çalışırken pratik bir kazançtır. SDK'nın sıkıştırma/özetleme özelliği, uzun süre çalışan aracıların etkin belleğini daha da genişletir.

3) Uzman istemlerinden gelen doğrulukta artış

Dar kapsamlı bir uzman olarak yapılandırılmış bir alt aracı, güvenlik kontrolleri, kod stili veya uyumluluk çıkarımı gibi kendi alanında hassasiyet için optimize edilecek şekilde (sistem istemi ve araç seti aracılığıyla) ayarlanabilir. Dar kapsamlı istemler, aracının izin verilen eylem alanı ve beklenen çıktıları kısıtlı olduğundan, halüsinasyonları azaltma eğilimindedir. Kuruluşlar, her şeyi bir genel uzmandan istemek yerine, alana özgü alt aracılar kullandıklarında, otomatik kod incelemesi gibi görevler için daha kaliteli çıktılar bildirmektedir.

Ekipler alt acenteleri nasıl kullanır? Örnek iş akışları

Bunu daha az soyut hale getirmek için aşağıda somut örnekler verilmiştir.

Örnek A — Yeniden düzenleme hattı (Orkestratör + Uzmanlar)

Orkestratör "X bileşenini yeniden düzenle" isteği alır.
Orkestratör çağrıları analysis-subagent (yazma izni yok) karmaşıklık noktalarını ve riskli bağımlılıkları belirlemek için.
Orkestratör çağrıları refactor-subagent (bir dal benzeri sanal alana izinleri yazın) yeniden düzenlenmiş dosyalar üretmek için.
Orkestratör çağrıları test-gen-subagent (kod üzerinde salt okunur) birim testleri üretmek için.
Orkestratör CI'ı şu şekilde çalıştırır: ci-runner-subagent (kum havuzunda yürütme) ve sonuçları insan incelemesi için toplar.
Bu model her aşamayı izole eder, riski sınırlandırır ve denetim izlerini düzenli tutar.

Örnek B — Araştırma + prototip (Boru hattı)

literature-subagent referansları sıyırır ve özetler (dosya yazma yok, düzenlenmiş web erişimi).
prototype-subagent Özetten minimal bir PoC'yi iskeleler.
benchmark-subagent Bir sanal alanda mikro kıyaslamalar çalıştırır ve sonuçları raporlar.
Bu zincir, sorumlulukları net bir şekilde belirlerken araştırma görevlerinin sıralı yapısını güçlendirir.

En iyi uygulamalar ve kalıplar

Tasarım ve konfigürasyon

Küçük, dar rollerle başlayın. Her alt temsilciyi tek bir net işten sorumlu tutun. Dar sorumluluklar hata ayıklamayı çok daha kolay hale getirir.
Sürümünüzü kontrol edin .claude/agents/ klasör. Alt aracı tanımlarını kod gibi ele alın; inceleme, test etme ve sabitleme sürümleri. Bu, sapmaları azaltır ve denetimleri kolaylaştırır.
Araçları ve modelleri bilerek sabitleyin. Kullanım model: inherit Ana konuşmayla tutarlı bir davranış istiyorsanız; arka plan taramaları için daha düşük maliyetli bir model takma adı belirleyin. Saldırı yüzeyini en aza indirmek için araçları kilitleyin.

Operasyonel kalıplar

Deterministik otomasyon için açık çağrıyı kullanın. CI işleri veya kancaları çalıştırıyorsanız, öngörülebilir sonuçlar sağlamak için belirli alt ajanları çağırın.
Etkileşimli oturumlar sırasında otomatik yetki devrini kullanın. Keşif çalışması için, Claude'un sürtünmeyi azaltmak için alt acenteleri seçmesine izin verin - ancak description alanlar otomasyonun beklenmedik şekilde tetiklenmemesi için bilinçli olarak ayarlanmıştır.
Sentez için yapılandırılmış çıktılar tasarlayın. Alt ajanların, düzenleyicinin okuyabileceği dosyalara yazmasını veya JSON üretmesini zorlayın; bu, azaltma adımını ve denetimi basitleştirir.

Test etme, izleme ve yönetişim

Temsili değerlendirmeler oluşturun. Alt ajanların nerede başarısız olduğunu takip edin ve bu başarısızlık modlarını uygulayan testler oluşturun. Anthropic, temsili test kümeleri ve yinelemeli iyileştirme önermektedir.
Token ve araç kullanımını izleyin. Her alt acentenin kullanımını enstrümante edin ve kaçak maliyet veya oran sınırı koşullarını tespit etmek için uyarılar ekleyin.

Alt acenteleri ne zaman KULLANMAMALISINIZ?

Alt acenteler güçlüdür ancak her zaman doğru araç değildir.

Basit görevler: Kısa, tek seferlik istemler veya önemsiz dönüşümler için alt aracılar gereksiz karmaşıklık ekler.
Sıkı gecikme kısıtlamaları: Orkestrasyon gidiş dönüşleri ek yük getirir; tek turlu, son derece düşük gecikmeli yanıtlar gerekiyorsa, monolitik bir yaklaşım daha basit olabilir.
Altyapısı kısıtlı küçük takımlar: Sırlar, gözlemlenebilirlik ve deneme ortamları için araçlar olmadan, alt aracılar operasyonel riski artırabilir. Topluluk makaleleri, küçükten başlamayı ve modülerliğe ihtiyaç duyduğunuzda alt aracılar eklemeyi vurgular.

Claude kod cli'sinin en çok nerede kullanılması önerilir?

CometAPI'nin artık güçlü Claude Code komut satırını tam olarak desteklediğini duyurmak heyecan verici. Claude Code üzerinde Comet API modelini kullanmak için yapmanız gereken tek şey Claude Code'u kurmak ve elde edilen Comet API anahtarı ve temel adres ile kimlik doğrulaması yapmaktır.

CometAPI üzerinden claude kodu neden kullanılmalıdır?

Yapay Zeka'nın en önemli özellikleri: Geliştiriciler için özel olarak oluşturulmuş modelleri kullanarak kodu kolayca oluşturun, hata ayıklayın ve optimize edin.

Esnek Model Seçimi: Kapsamlı model yelpazemiz daha sorunsuz bir şekilde geliştirme yapmanıza olanak tanır.
Kusursuz Entegrasyon: API'ler her zaman kullanılabilir. Claude Code'u dakikalar içinde mevcut iş akışınıza entegre edin.
CometAPI aracılığıyla Claude Code'u kullanmak daha fazla maliyet tasarrufu sağlayacaktırCometAPI tarafından sağlanan Claude API resmi fiyattan %20 indirimli olup resmi tarafından son modelle güncellenmektedir.

Claude Code cli'yi kullanmaya hazır mısınız? API kılavuzu detaylı talimatlar için.

Yapay zeka hakkında daha fazla ipucu, kılavuz ve haber öğrenmek istiyorsanız bizi takip edin VK, X ve Katılın!

Ayrıca bakınız Claude Code CometAPI ile Nasıl Kurulur ve Çalıştırılır?

Sonuç — alt acentelerin önemi neden şimdi ortaya çıkıyor?

Alt aracılar, ekipler için aracı iş akışlarının vaadini pratik hale getirir: roller, izinler, bağlam, maliyet ve paralellik hakkında açıkça ve birinci sınıf nesneler olarak düşünmenizi sağlarlar. Akıllıca kullanıldığında, alt aracılar daha yüksek geliştirici hızı, çok adımlı görevlerde daha iyi kalite ve daha öngörülebilir bir yönetişim sağlar. Diğer taraftan, bu alt aracıları tıpkı üretim yazılımları gibi tasarlamanız, test etmeniz ve izlemeniz gerekir; ancak bu yatırım, hızlı mühendisliği güvenilir bir mühendislik uygulamasına dönüştürür.