Alt aracılar, Claude Code / Claude Agent ekosistemine yapılan en kullanışlı eklemelerden biridir: karmaşık iş akışlarını daha küçük, uzman yapay zeka "takım arkadaşlarına" bölmenize, ana iş parçacığı bağlamını korumanıza ve araç erişimini güvenli bir şekilde sınırlamanıza olanak tanırlar. Bu makale şunları açıklar: alt acenteler nelerdir, bunları nasıl oluşturup çağıracağınızı (CLI, dosya sistemi ve SDK), tasarım ilkeleri bunları inşa ederken takip etmeniz gerekenler ve beton örnek kodu kopyalayıp uyarlayabilirsiniz.
Alt Temsilciler Nelerdir?
A alt acente Claude Code'un (veya Claude Agent SDK'sının) işleri devredebileceği, önceden yapılandırılmış, dar kapsamlı bir yapay zeka asistanıdır. Her alt ajan:
- Benzersiz bir isme ve amacın açık bir tanımına sahiptir.
- İçinde çalışır kendi bağlam penceresi ana konuşmadan ayrı (uzun ayrıntı zincirleri düzenleyicinin bağlamını kirletmeyecek şekilde).
- Sınırlı bir setle yapılandırılabilir araçlar (dosya okuma/yazma, bash, grep, MCP araçları, vb.) ve belirli bir model seçimiyle.
- Davranışı ve kısıtlamaları yönlendiren bir sistem istemi (alt temsilcinin kişiliği ve talimatları) içerir.
Bu özellikler, alt ajanları, token ağırlıklı (araştırma, büyük günlükleri arama), güvenliğe duyarlı (tarama veya potansiyel olarak yıkıcı araçlar) veya tekrarlayan ve iyi belirlenmiş (stil kontrolü, test çalıştırma) görevler için ideal hale getirir.
Anthropic hızla yineleme yapıyor: Claude Code CLI ve Agent SDK yeniden düzenlendi ve genişletildi Claude Agent SDK, eklenti desteği, paketleme ajanları ve ilgili özelleştirmeler (eğik çizgi komutları, MCP sunucuları, kancalar) için tanıtıldı ve Becerileri Claude.ai, Claude Code ve Agent SDK genelinde yeniden kullanım için etki alanı iş akışlarını paketlemenin bir yolunu sağlar. Bu güncellemeler, paylaş, kur ve sürüm Ekipler ve projeler arasında alt temsilciler. Üretim iş akışları oluşturmayı planlıyorsanız, eklenti/beceri paketlemesini ve SDK tabanlı dağıtım modellerini değerlendirmelisiniz.
Alt Temsilciler Neden Önemlidir?
Hemen işe yaramalarının üç nedeni var:
- Bağlamın korunması — Uzun veya gürültülü aramalar, test çalıştırmaları veya taramalar, birincil bağlamı boğmak yerine bir alt aracı içinde yer alır. Bu, belirteç israfını azaltır ve sonuçlar hakkında akıl yürütmeyi kolaylaştırır.
- Uzmanlaşmış uzmanlık — Göreve göre uyarlanmış bir sistem isteminde alan bilgisini ve davranışını kodlayabilirsiniz (örneğin, bir
security-auditor(gizli bilgilere, bağımlılık sorunlarına ve güvenli olmayan kabuk kullanımına odaklanan) - Daha güvenli izinler — alt ajan başına araçları sınırlamak patlama yarıçapını azaltır (bir belge inceleyicisinin salt okunur araçları olabilir; bir test çalıştırıcısının
Bashama hayırEdit). - paralelleştirme: Birden fazla alt ajanı aynı anda çalışacak şekilde ayarlayabilirsiniz (örneğin:
style-checker,security-scanner,test-runner) ve ardından kısa sonuçlarını toplayın - pahalı, bağımsız kontroller için büyük bir kazanç.
Claude Kanunu'nda Alt Aracıların Kullanımına İlişkin Ön Koşullar
Alt Temsilciler oluşturmaya başlamadan önce aşağıdakilerin yerinde olduğundan emin olun:
1) Claude Kodu kuruldu ve doğrulandı
Claude Code CLI'yi kurun veya web/IDE entegrasyonlarını kullanın. CometAPI'nin Hızlı Başlangıç ve kurulum belgeleri desteklenen kurulum yöntemlerini (npm global paketi veya yerel yükleyiciler) listeleyin ve kurulumunuzu nasıl doğrulayacağınızı gösterin claude --version / claude doctor. Ayrıca bir Kuyrukluyıldız API'si (CometAPI'nin anahtarını kullanarak Claude koduna erişmek resmi modelden daha ucuz ve daha kullanışlıdır.) Hızlı Başlangıçta belirtildiği gibi.
2) Düğüm/ortam (bazı kurulum yolları için) ve temel kabuk araçları
Npm paketi aracılığıyla kurulum yaparsanız, Node.js'e sahip olmanız gerekir (örneklerde Node 18+ yaygındır). Agent SDK'sını (JavaScript/TypeScript veya Python) kullanmayı planlıyorsanız, SDK bağımlılığının yüklü olduğu bir projeye ihtiyacınız olacaktır. Birçok eğitim, standart geliştirici araçlarının (git, bash, isteğe bağlı) kullanıldığını varsayar. gh (GitHub iş akışları için CLI).
3) Proje düzeni ve CLAUDE.md
En iyi uygulama, depo düzeyinde yardımcı belgeleri (CLAUDE.md) ve proje kapsamındaki aracıları yerleştirmek için .claude/agents/ Böylece takım arkadaşları bunları devralır. CLAUDE.md dosyaları otomatik olarak Claude'un bağlamına çekilir ve oturumlar arasında davranışları tutarlı bir şekilde yönlendirmeye yardımcı olur; her alt aracı, YAML ön metni içeren bir Markdown dosyasıdır. Minimal örnek:
---
name: code-reviewer
description: Expert code review specialist. Use PROACTIVELY after code changes to check security, style, and maintainability.
tools: Read, Grep, Glob, Bash
model: inherit
---
You are a senior code reviewer. When invoked:
1. Run `git diff` to identify modified files.
2. Focus review on changed code paths.
3. List security issues, probable false positives, and suggested fixes.
4. Provide a short, prioritized action list.
Return results in JSON with fields: summary, issues.
nameküçük harfli bir tanımlayıcıdır.descriptionotomatik çağırma ve eşleştirmeyi yönlendirir.toolsaraç erişimini kısıtlar (her şeyi devralmayı ihmal eder).modelolabilirsonnet,opus,haikuya dainherit.
4) İzinler ve MCP sunucuları (isteğe bağlı ancak yaygın)
İş akışlarınız Model Bağlam Protokolü (MCP) sunucularını veya harici araçları (Puppeteer, Sentry, özel REST araçları) kullanıyorsa, MCP sunucularınızın yapılandırıldığından ve erişilebilir olduğundan emin olun. Hassas işlemler (yazma, bash, git commit) için izin listesi ve aracı başına izinler konusunda dikkatli olun. tools kapsam belirleme.
Claude Kodunda Alt Temsilciler Nasıl Oluşturulur
Alt acenteleri üç ana yolla oluşturabilirsiniz: etkileşimli CLI aracılığıyla (/agents), dosya sistemi Markdown dosyaları olarak veya Agent SDK aracılığıyla programatik olarak. Aşağıda adım adım seçenekler yer almaktadır:
Claude Code, alt acenteler oluşturmanın üç pratik yolunu destekler:
- Etkileşimli CLI
/agentsUI — bir oturum içinde yinelemeli oluşturma için en hızlısıdır. - Dosya sistemi tabanlı — YAML ön metniyle Markdown dosyaları oluşturun
.claude/agents/(proje düzeyinde) veya~/.claude/agents/(kullanıcı düzeyi). Proje aracılarının önceliği daha yüksektir. - Programatik (Ajan SDK'sı) — alt acenteleri kodda tanımlayın
agentsçağırdığınızda parametrequery(); SDK tabanlı uygulamalar için önerilir. Bu yaklaşım, alt ajanların dinamik olarak oluşturulması veya bir uygulamaya yerleştirilmesi gerektiğinde idealdir.
Hızlı etkileşimli akış (önerilen ilk adım)
- Terminalinizde Claude Code'u başlatın veya VS Code'da komut paletini açın.
- Alt ajan arayüzünü slash komutuyla çalıştırın:
/agents
- Klinik Yeni Temsilci Oluştur, proje düzeyinde veya kullanıcı düzeyinde kapsam seçin, ad/açıklama/araçlar/sistem istemini doldurun ve kaydedin. Claude ile bir taslak oluşturabilir ve ardından onu geliştirebilirsiniz. Kaydedildikten sonra, aracı şurada kullanılabilir:
/agentsve açıkça veya otomatik olarak çağrılabilir.
Dosya sistemi tabanlı alt ajanlar (Markdown + YAML ön metni)
Alt ajanlar, YAML ön metni içeren Markdown dosyaları olarak saklanır. Bunları şuraya yerleştirin:
- Proje kapsamı:
.claude/agents/*.md(en yüksek öncelik) - Kullanıcı kapsamı:
~/.claude/agents/*.md
Temel dosya yapısı:
---
name: code-reviewer
description: "Review recent code changes for security and style."
tools: Read, Grep, Glob, Bash # optional; omit to inherit
model: sonnet # optional; or 'inherit'
---
You are a senior code reviewer with expertise in security, performance, and best practices.
When reviewing:
- Identify security vulnerabilities
- Prioritize clarity and maintainability
- Always provide concise examples and suggested fixes
- If unsure, ask for the minimal reproducible snippet
Birkaç uygulama notu:
nameküçük harfle ve tire ile yazılmalıdır.- atlamak
toolsalt ajanın ana iş parçacığının tüm araçlarını devralmasına izin verecektir; araçları açıkça listelemek en az ayrıcalıklı bir modeli zorunlu kılar. - Kullanım
model: 'inherit'ana iş parçacığıyla tutarlı davranış için veya bir model takma adı belirtin (örneğin,sonnet,opus,haiku).
CLI JSON tanımı (ad hoc/oturum kullanımı)
Bir oturumu başlatırken geçici alt ajanları satır içi olarak tanımlayabilirsiniz:
claude --agents '{
"code-reviewer": {
"description": "Expert code reviewer.",
"prompt": "You are a senior code reviewer. Focus on security and best practices.",
"tools": ,
"model": "sonnet"
}
}'
CLI tarafından tanımlanan aracılar, betikli çalıştırmalar veya deneyler için kullanışlıdır; proje aracılarından daha düşük önceliğe sahiptirler ancak kullanıcı aracılarından daha yüksektirler.
Programatik tanım (Uygulamalar için Aracı SDK'sı önerilir)
Bir uygulama veya otomasyon oluşturuyorsanız, alt ajanları Agent SDK'ları aracılığıyla programatik olarak tanımlayın agents parametre (bu en entegre seçenektir). Örnek (TypeScript):
import { query } from '@anthropic-ai/claude-agent-sdk';
async function runReview() {
const result = await query({
prompt: "Assess the authentication module for security issues",
options: {
agents: {
"code-reviewer": {
description: "Expert code review specialist",
prompt: `You are a code review specialist...`,
tools: ,
model: "sonnet"
},
"test-runner": {
description: "Runs the test suite and analyzes failures",
prompt: `You run tests and summarize failures...`,
tools: ,
model: "sonnet"
}
}
}
});
console.log(result);
}
SDK ayrıca dosya sistemi tabanlı aracıları da kabul eder (yükleyecektir .claude/agents/ (dosyalar) bu deseni tercih ederseniz. Programatik aracılar, dinamik iş akışları ve CI entegrasyonu için güçlüdür.
Python için, claude-agent-sdk paket benzer kalıpları destekler: kullanabilirsiniz query() or ClaudeSDKClient Seçenekleri, araçları ve MCP sunucularını programatik olarak yapılandırın. Hızlı başlangıç örnekleri için Python SDK deposuna bakın.
Alt acenteler nasıl çağrılır
Otomatik delegasyon
Claude Kodu yapabilir otomatik olarak Kullanıcı istemi bir alt etkenin amacıyla eşleştiğinde bir alt etken seçin. Bu, ana etkenin görevleri otomatik olarak doğru uzmana yönlendirdiği arka plan düzenlemesi için kullanışlıdır. Otomatik seçim doğruluğunu artırmak için net alt etken açıklamalarına ve odaklanmış sistem istemlerine güvenin.
Açık çağrı (netlik açısından önerilir)
Konuşmada bir aracı açıkça çağırabilirsiniz:
> Use the code-reviewer subagent to check my recent changes
Açık çağrı kesindir ve beklenmedik yetki devrini önlemek istediğiniz üretim akışları için önerilir.
SDK orkestratör kalıpları
SDK uygulamalarındaki yaygın kalıplar:
- Çatal + topla:Birden fazla alt ajanı paralel olarak başlatın, her ajanın özlü yanıtını toplayın, ardından sonuçları ana ajanda özetleyin/birleştirin.
- Denetleyici döngüsü: Orkestratör, görevleri alt acentelere atar, sonuçları inceler ve bunları kabul eder veya yeniden hesaplama/açıklama ister.
- Sandbox yürütme: Sıkı bir şekilde kısıtlanmış bir aracıya potansiyel olarak tehlikeli yetenekler (dağıtım, betik çalıştırma) verin ve çalıştırmadan önce açık insan onayı kancaları gerektirin.
Bu kalıplar, Agent SDK'nın oturum yönetimi, kancalar ve MCP araçlarını kullanarak pratik uygulamalara eşlenir.
Kullanışlı, güvenli ve birleştirilebilir alt ajanlar nasıl oluşturulur?
1) Tek sorumluluk ve net istemler
Her alt etkenin tek bir net amacı ve sınırları, başarı kriterlerini ve çıktı biçimini belirten bir sistem istemi olmalıdır. İstenen çıktı yapılandırılmışsa (JSON, madde işaretli liste, kod yaması), alt etkene ayrıştırma hatalarını azaltması için kesin talimatlar verin.
2) Araçlar için en az ayrıcalık
Yalnızca bir alt aracının ihtiyaç duyduğu araçları sağlayın. Örneğin, bir belge inceleyicisinin Write or BashMümkün olduğunda salt okunur olarak ayarlayın ve gerektiğinde araç izinlerini açıkça yükseltin. Bu, riski azaltır ve denetimi basitleştirir.
3) Kompakt, yapılandırılmış çıktılar döndürün
Alt acenteler geri dönmelidir özlü, kesin cevaplar Uzun süreli düşünce izleri yerine. Yaygın bir kalıp şudur: Alt aracının bağlamında yoğun bir çalışma yapın, ardından eklerle (yamalar, dosya referansları, JSON) kısa bir özet döndürün. Bu, düzenleyici için bağlam verimliliğini en üst düzeye çıkarır.
4) Test edilebilirlik ve sürümleme
Alt aracı dosyalarını sürüm kontrolünde saklayın, küçük girdilere karşı gerçek çalıştırmalar uygulayan CI testleri oluşturun ve modelleri/araç setlerini sabitleyin. Becerilere ve eklentilere güveniyorsanız, yükseltmeleri ve geri almaları yönetmek için eklenti pazar yeri/sürümleme modellerini benimseyin.
5) Denetim kancaları ve döngüdeki insan kontrol noktaları
Araç çağrılarını (PreToolUse kancaları) engellemek ve yıkıcı eylemler için insan onayı gerektirmek için SDK kancalarını kullanın. Tekrarlanabilir denetimler için tüm araç çağrılarını kaydedin. SDK, bu modeli desteklemek için kanca ve izin mekanizması sağlar.
Uygulama örneği — küçük, üretime benzer bir işlem hattı
Aşağıda tipik parçaları gösteren kompakt bir örnek bulunmaktadır: bir dosya sistemi aracı, iki aracı kullanan bir SDK çağrısı (biri inceleme için, biri testler için) ve basit bir orkestrasyon.
1) Dosya sistemi aracısı: .claude/agents/code-reviewer.md
---
name: code-reviewer
description: Use PROACTIVELY after code changes. Perform security, style, and maintainability review on modified files.
tools: Read, Grep, Glob
model: inherit
---
You are a meticulous senior code reviewer. When invoked:
1. Run `git diff --name-only` to find modified files.
2. For each modified file, read and look for security issues, suspicious patterns, or maintainability problems.
3. Return JSON:
{
"summary": "one-line summary",
"issues": ,
"recommended_changes":
}
2) Programatik orkestrasyon (Node.js)
import { query } from '@anthropic-ai/claude-agent-sdk';
import fs from 'fs';
async function runPipeline() {
const result = query({
prompt: 'Run PR checks: security review then unit tests.',
options: {
agents: {
'code-reviewer': {
description: 'Use PROACTIVELY after code changes; output JSON with issues.',
prompt: fs.readFileSync('./.claude/agents/code-reviewer.md', 'utf8'),
tools: ,
model: 'sonnet'
},
'test-runner': {
description: 'Run test suite and summarize failing tests.',
prompt: `You are a test-runner. Execute tests and return JSON { summary, failing_tests[] }`,
tools:
}
}
}
});
for await (const message of result) {
// Implement streaming logic: messages may include subagent outputs
console.log(message);
}
}
runPipeline().catch(console.error);
Notlar: the code-reviewer ekip tarafından yeniden kullanılmak üzere depoda saklanır; SDK çağrısı, öncelik alan programatik aracıları ve tools kapsamlandırma, kazara yazmaları önler.
Gelişmiş konular ve kalıplar
Dinamik aracı yapılandırması
Ortama (geliştirme ve üretim) veya önem düzeylerine (örneğin) bağlı olarak model ve araç setlerini seçen parametreli aracı fabrikaları oluşturun strict vs balanced (güvenlik modları). SDK örnekleri, çalışma zamanında aracı tanımlarının nasıl oluşturulacağını gösterir.
parallelleştirme
Birden fazla salt okunur analiz aracını paralel olarak (stil, güvenlik, test kapsamı) ayırın ve JSON çıktılarını ana iş parçacığında toplayın. Bu, büyük depolar için zaman kaybını önemli ölçüde azaltır.
Eklenti tarafından sağlanan aracılar
Eklentiler, eklenti bildirimiyle paketlenmiş alt aracılar sağlayabilir; bunlar şurada görünür: /agents Özel aracılarla birlikte kullanılabilir ve açıkça çağrılabilir. Bunu, standart aracıları ekipler arasında dağıtmak için kullanın.
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?
Nihai düşünceler
Alt acenteleri şu şekilde ele alın: yeniden kullanılabilir, sürümlü mikro-kişilerKüçük başlayın: bir doc-reviewer ve test-runner bir depo için bunları kontrol edin .claude/agents/ve bunları başsız CI kullanarak otomatikleştirin claude -p. İstemlerinizi yineleyin, yapılandırılmış çıktılar ekleyin ve araç izinlerini sıkılaştırın.
En çok işe yarayan zihinsel model: Claude'u bir proje yöneticisi, alt temsilcileri ise ekipteki uzmanlar olarak hayal edin. Yönetici, açıkça ifade edilmiş görevleri devreder, uzmanların çıktılarını bir araya getirir ve nihai raporu yazar. Zamanla, güvenilirlik, test edilebilirlik ve geliştirici iş akışlarının büyük bir kısmını otomatikleştirme becerisinde gelişmeler göreceksiniz.