Клод кодындағы субагенттерді қалай жасауға және пайдалануға болады — практикалық нұсқаулық

CometAPI
AnnaOct 22, 2025
Клод кодындағы субагенттерді қалай жасауға және пайдалануға болады — практикалық нұсқаулық

Субагенттер Клод кодексі / Клод агент экожүйесінің ең пайдалы толықтыруларының бірі болып табылады: олар күрделі жұмыс процестерін кішірек, маман AI «командаластарына» бөлуге, негізгі ағын контекстін сақтауға және құралға кіруді қауіпсіз шектеуге мүмкіндік береді. Бұл мақала түсіндіреді субагенттер қандай, оларды қалай құруға және шақыруға болады (CLI, файлдық жүйе және SDK), жобалау принциптері оларды құру кезінде сіз ұстануыңыз керек және нақты үлгі коды көшіріп, бейімдей аласыз.

Субагенттер дегеніміз не?

A субагент Клод коды (немесе Клод агент SDK) жұмысты тапсыра алатын алдын ала конфигурацияланған, ауқымы тар AI көмекшісі. Әрбір субагент:

  • Бірегей атауы және мақсатының нақты сипаттамасы бар.
  • Оның ішінде жүгіреді жеке контекстік терезе негізгі әңгімеден бөлек (ұзын бөлшектер тізбегі оркестрдің контекстін ластамайды).
  • Шектеулі жиынтығымен конфигурациялауға болады құралдары (файлды оқу/жазу, bash, grep, MCP құралдары және т.б.) және нақты үлгі таңдауымен.
  • Онда мінез-құлық пен шектеулерді бағыттайтын жүйелік нұсқау (субагенттің жеке басы және нұсқаулары) бар.

Бұл сипаттар субагенттерді таңбалауыш ауыр (зерттеу, үлкен журналдарды іздеу), қауіпсіздікке сезімтал (сканерлеу немесе ықтимал бұзушы құралдар) немесе қайталанатын және жақсы сипатталған (стильді тексеру, сынақты іске қосу) тапсырмалар үшін тамаша етеді.

Anthropic тез итерацияланды: Claude Code CLI және Agent SDK қайта өңделіп, кеңейтілді. Claude Agent SDK, біріктіру агенттері мен қатысты теңшелімдер (қиғаш сызық пәрмендері, MCP серверлері, ілгектер) үшін плагин қолдауы енгізілді және Skills Claude.ai, Claude Code және SDK Агенті арқылы қайта пайдалану үшін домен жұмыс үрдістерін бумалау жолын қамтамасыз етіңіз. Бұл жаңартулар оны жеңілдетеді бөлісу, орнату және нұсқа командалар мен жобалар бойынша субагенттер. Өндірістік жұмыс үрдістерін құруды жоспарласаңыз, плагин/дағдылар бумасын және SDK негізіндегі орналастыру үлгілерін бағалауыңыз керек.

Неліктен субагенттер маңызды

Олардың бірден пайдалы болуының үш себебі:

  1. Мәтінмәнді сақтау — ұзақ немесе шулы іздеулер, сынақтар немесе сканерлеулер негізгі мәтінмәнді толтырудың орнына субагент ішінде өмір сүреді. Бұл таңбалауыш қалдықтарын азайтады және нәтижелер туралы ойлауды жеңілдетеді.
  2. Мамандандырылған сараптама — тапсырмаға бейімделген жүйе шақыруында домен білімі мен әрекетін кодтауға болады (мысалы, а security-auditor құпияларға, тәуелділік мәселелеріне және қауіпті қабықшаны пайдалануға бағытталған).
  3. Қауіпсіз рұқсаттар — әрбір субагентке шектеу құралдары жарылыс радиусын азайтады (құжаттарды шолушыда тек оқуға арналған құралдар болуы мүмкін; сынақшыда бар Bash бірақ жоқ Edit).
  4. Параллелдеу: Бір уақытта іске қосу үшін бірнеше субагенттерді айналдыруға болады (мысалы: style-checker, security-scanner, test-runner) және содан кейін олардың қысқаша нәтижелерін жинаңыз - қымбат, тәуелсіз тексерулер үшін үлкен жеңіс.

Клод кодындағы субагенттерді пайдаланудың алғы шарттары

Субагенттерді құруды бастамас бұрын, сізде мыналар бар екеніне көз жеткізіңіз:

1) Клод коды орнатылған және аутентификацияланған

Claude Code CLI орнатыңыз немесе веб/IDE интеграциясын пайдаланыңыз. CometAPI жылдам іске қосу және орнату құжаттары қолдау көрсетілетін орнату әдістерін (npm жаһандық бумасы немесе жергілікті орнатушылар) тізіп, орнатуды қалай тексеру керектігін көрсетіңіз claude --version / claude doctor. Сізге де қажет болады CometAPI тіркелгі (Claude кодына кіру үшін CometAPI кілтін пайдалану ресми үлгіге қарағанда арзанырақ және ыңғайлы.) Quickstart бөлімінде көрсетілген.

2) Түйін/орта (кейбір орнату жолдары үшін) және негізгі қабық құралдары

npm бумасы арқылы орнатсаңыз, сізде Node.js болуы керек (18+ түйіні мысалдарда жиі кездеседі). SDK Агентін (JavaScript/TypeScript немесе Python) пайдаланғыңыз келсе, SDK тәуелділігі орнатылған жоба қажет болады. Көптеген оқулықтар әзірлеушінің стандартты құралдарын (git, bash, қосымша gh GitHub жұмыс процестеріне арналған CLI).

3) Жобаның орналасуы және CLAUDE.md

Ең жақсы тәжірибе - репо деңгейіндегі көмекші құжаттарды сақтау (CLAUDE.md) және жоба ауқымындағы агенттерді енгізу .claude/agents/ сондықтан командаластар оларды мұра етеді. CLAUDE.md файлдары Клод мәтінмәніне автоматты түрде тартылады және сеанстардағы мінез-құлықты дәйекті түрде бағыттауға көмектеседі, әрбір субагент YAML алдыңғы мәселесі бар Markdown файлы болып табылады. Минималды мысал:

---
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.
  • name кіші әріпті идентификатор болып табылады.
  • description автоматты шақыруды және сәйкестендіруді бағыттайды.
  • tools құралға қол жеткізуді шектейді (барлығын мұраға қалдырмаңыз).
  • model болуы мүмкін sonnet, opus, haikuнемесе inherit.

4) Рұқсаттар және MCP серверлері (міндетті емес, бірақ жалпы)

Егер жұмыс үрдістеріңіз үлгі контекстік протоколы (MCP) серверлерін немесе сыртқы құралдарды (Puppeteer, Sentry, реттелетін REST құралдары) пайдаланса, MCP серверлерінің конфигурацияланғанын және қол жетімді екенін тексеріңіз. Сезімтал әрекеттер үшін (жазу, bash, git commit) рұқсат етілген тізім мен әр агент туралы ойланыңыз. tools ауқымды анықтау.

Клод кодында субагенттерді қалай жасауға болады

Субагенттерді үш негізгі жолмен жасауға болады: интерактивті CLI арқылы (/agents), файлдық жүйені белгілеу файлдары ретінде немесе Agent SDK арқылы бағдарламалық түрде. Төменде қадамдық опциялар берілген:

Клод коды субагенттер жасаудың үш практикалық әдісін қолдайды:

  1. Интерактивті CLI /agents UI — сеанс ішінде итеративті жасау үшін ең жылдам.
  2. Файлдық жүйеге негізделген — YAML фронтматері бар Markdown файлдарын жасаңыз .claude/agents/ (жоба деңгейінде) немесе ~/.claude/agents/ (пайдаланушы деңгейі). Жоба агенттерінің басымдығы жоғары.
  3. Бағдарламалық (SDK агенті) — арқылы кодтағы субагенттерді анықтаңыз agents Сіз қоңырау шалған кезде параметр query(); SDK басқаратын қолданбалар үшін ұсынылады. Бұл тәсіл субагенттер динамикалық түрде жасалуы немесе қолданбаға ендірілген болуы қажет болғанда өте қолайлы.

Жылдам интерактивті ағын (ұсынылатын бірінші қадам)

  1. Терминалда Клод кодын іске қосыңыз немесе VS кодында пәрмендер палитрасын ашыңыз.
  2. Субагенттер интерфейсін қиғаш сызық пәрменімен іске қосыңыз:
/agents
  1. таңдау Жаңа агент жасау, жоба деңгейінде немесе пайдаланушы деңгейінде аумақты таңдаңыз, атау/сипаттама/құралдар/жүйе шақыруын толтырыңыз және сақтаңыз. Клод көмегімен нобай жасап, содан кейін оны нақтылауға болады. Сақталғаннан кейін агент қолжетімді болады /agents және анық немесе автоматты түрде шақырылуы мүмкін.

Файлдық жүйеге негізделген субагенттер (Markdown + YAML алдыңғы материалы)

Субагенттер YAML алдыңғы материалы бар Markdown файлдары ретінде сақталады. Оларды орналастырыңыз:

  • Жобаның көлемі: .claude/agents/*.md (ең жоғары басымдық)
  • Пайдаланушы ауқымы: ~/.claude/agents/*.md

Негізгі файл құрылымы:

---
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

Бірнеше іске асыру ескертулері:

  • name дефиспен кіші әріппен жазылуы керек.
  • Өткізілу tools субагентке негізгі ағынның барлық құралдарын иеленуге мүмкіндік береді; құралдарды нақты тізімдеу ең аз артықшылықтар үлгісін қолданады.
  • пайдалану model: 'inherit' негізгі ағынмен дәйекті әрекет үшін немесе үлгі бүркеншік атын көрсетіңіз (мысалы, sonnet, opus, haiku).

CLI JSON анықтамасы (ad hoc/сеансты пайдалану)

Сеансты іске қосқан кезде кірістірілген уақытша субагенттерді анықтауға болады:

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-анықталған агенттер сценарийді іске қосу немесе эксперименттер үшін пайдалы; олардың басымдығы жоба агенттеріне қарағанда төмен, бірақ пайдаланушы агенттеріне қарағанда жоғары.

Бағдарламалық анықтама (SDK агенті — қолданбаларға ұсынылады)

Қолданбаны немесе автоматтандыруды құрастырып жатсаңыз, SDK агенті арқылы қосалқы агенттерді бағдарламалы түрде анықтаңыз. agents параметр (бұл ең біріктірілген опция). Мысал (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 файлдық жүйеге негізделген агенттерді де қабылдайды (ол жүктеледі .claude/agents/ файлдар) осы үлгіні қаласаңыз. Бағдарламалық агенттер динамикалық жұмыс процестері мен CI интеграциясы үшін күшті.

Python үшін, claude-agent-sdk пакет ұқсас үлгілерді қолдайды: пайдалануға болады query() or ClaudeSDKClient және опцияларды, құралдарды және MCP серверлерін бағдарламалы түрде конфигурациялаңыз. Жылдам бастау үлгілері үшін Python SDK репосын қараңыз.

Субагенттерді қалай шақыруға болады

Автоматты өкілдік

Клод коды мүмкін автоматты түрде пайдаланушы сұрауы субагенттің мақсатына сәйкес келгенде, қосалқы агентті таңдаңыз. Бұл негізгі агент тапсырмаларды дұрыс маманға автоматты түрде бағыттайтын фондық оркестр үшін пайдалы. Автоматты таңдау дәлдігін жақсарту үшін нақты субагент сипаттамаларына және бағытталған жүйе сұрауларына сеніңіз.

Айқын шақыру (түсінікті болу үшін ұсынылады)

Сөйлесуде агентті нақты шақыруға болады:

> Use the code-reviewer subagent to check my recent changes

Ашық шақыру детерминирленген және күтпеген өкілден аулақ болғыңыз келетін өндіріс ағындары үшін ұсынылады.

SDK оркестрінің үлгілері

SDK қолданбаларындағы жалпы үлгілер:

  • Шанышқы + жинау: Бірнеше қосалқы агенттерді қатар іске қосыңыз, әрбір агенттің қысқаша жауабын жинаңыз, содан кейін негізгі агентте нәтижелерді қорытындылаңыз/біріктіріңіз.
  • Супервайзер циклі: Оркестр қосалқы агенттерге тапсырмалар береді, нәтижелерді тексереді және оларды қабылдайды немесе қайта есептеуді/нақтылауды сұрайды.
  • Құм жәшігіндегі орындау: Қауіпті болуы мүмкін мүмкіндіктерді (орналастыру, сценарийлерді іске қосу) қатаң шектелген агентке беріңіз және орындамас бұрын адамның нақты мақұлдау ілмектерін талап етіңіз.

Бұл үлгілер Agent SDK сеансын басқаруды, ілмектерді және MCP құралдарын пайдалана отырып, практикалық енгізулерге сәйкестендіріледі.

Пайдалы, қауіпсіз және құрастырылатын субагенттерді қалай жасауға болады

1) Бірыңғай жауапкершілік және нақты нұсқаулар

Әрбір субагентте бір нақты мақсат және шекараларды, сәттілік критерийлерін және шығыс пішімін көрсететін жүйе шақыруы болуы керек. Қажетті нәтиже құрылымдалған болса (JSON, таңбалар тізімі, кодтық патч), субагентке талдау қателерін азайтуға нақты нұсқау беріңіз.

2) Құралдар үшін ең аз артықшылық

Субагентке қажет құралдарды ғана беріңіз. Мысалы, құжатты шолушыға қажет емес Write or Bash. Мүмкін болса, тек оқуға арналған әдепкі және қажет болғанда құрал рұқсаттарын нақты түрде арттырыңыз. Бұл тәуекелді азайтады және аудитті жеңілдетеді.

3) Шағын, құрылымдық шығыстарды қайтарыңыз

Субагенттер қайтарылуы керек қысқа, қорытынды жауаптар ұзаққа созылған ой ізінен гөрі. Жалпы үлгі: субагент контекстінде ауыр жұмысты орындаңыз, содан кейін тіркемелермен (патчтар, файл сілтемелері, JSON) қысқа қорытындыны қайтарыңыз. Бұл оркестр үшін мәтінмән тиімділігін арттырады.

4) Тестілеу және нұсқалау

Субагент файлдарын нұсқаны басқаруда сақтаңыз, шағын кірістерге қарсы нақты орындалатын CI сынақтарын жасаңыз және модельдерді/құралдар жиынын бекітіңіз. Дағдылар мен плагиндерге сенсеңіз, жаңартулар мен кері қайтаруларды басқару үшін плагин нарығын/нұсқалау үлгілерін қабылдаңыз.

5) Аудиторлық ілмектер және адамның бақылау пункттері

Құрал шақыруларын (PreToolUse ілмектері) ұстап тұру үшін SDK ілмектерін пайдаланыңыз және деструктивті әрекеттер үшін адамның рұқсатын талап етіңіз. Қайта ойнатылатын аудиттер үшін құралдың барлық шақыруларын тіркеу. SDK осы үлгіні қолдау үшін ілмек пен рұқсат машиналарын қамтамасыз етеді.

Қолдану үлгісі — шағын, өндіріске ұқсас құбыр

Төменде типтік бөліктерді көрсететін шағын мысал келтірілген: файлдық жүйе агенті, екі агентті пайдаланатын SDK шақыруы (біреуі шолу үшін, біреуі сынақтар үшін) және қарапайым оркестрация.

1) Файлдық жүйе агенті: .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) Бағдарламалық оркестрлеу (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);

Ескертулер: The code-reviewer команданы қайта пайдалану үшін репода сақталады; SDK шақыруы бағдарламалық агенттердің басымдылығын көрсетеді және tools ауқымды анықтау кездейсоқ жазуларды болдырмайды.

Жетілдірілген тақырыптар мен үлгілер

Динамикалық агент конфигурациясы

Ортаға (дев. және өнім) немесе ауырлық деңгейлеріне (мысалы, strict vs balanced қауіпсіздік режимдері). SDK мысалдары орындау уақытында агент анықтамаларын жасау жолын көрсетеді.

Параллельдеу

Бірнеше тек оқуға арналған талдау агенттерін параллельді түрде (стиль, қауіпсіздік, сынақ қамту) ажыратыңыз және олардың JSON шығыстарын негізгі ағында біріктіріңіз. Бұл үлкен реполар үшін қабырға сағатының уақытын айтарлықтай қысқартады.

Плагинмен қамтамасыз етілген агенттер

Плагиндер плагин манифестімен оралған субагенттерді қамтамасыз ете алады; оларда пайда болады /agents реттелетін агенттермен қатар және анық шақырылуы мүмкін. Мұны стандартталған агенттерді топтар арасында тарату үшін пайдаланыңыз.

Claude кодын қайда пайдалану ұсынылады cli

CometAPI енді қуатты Claude Code cli-ге толық қолдау көрсететінін қуана хабарлады. Клод кодында Comet API үлгісін пайдалану үшін сізге тек Клод кодын орнату және алынған Comet API кілті және негізгі мекенжайы арқылы аутентификация қажет.

Неліктен CometAPI арқылы Клауд кодын пайдалану керек?

Жасанды интеллекттің негізгі мүмкіндіктері: әзірлеушілер үшін арнайы жасалған үлгілерді пайдаланып кодты оңай жасаңыз, түзетіңіз және оңтайландырыңыз.

  • Модельдерді икемді таңдау: Модельдердің кең ауқымы сізге біркелкі дамуға мүмкіндік береді.
  • Үздіксіз интеграция: API интерфейстері әрқашан қол жетімді. Клод кодын бірнеше минут ішінде бар жұмыс үрдісіңізге тікелей біріктіріңіз.
  • CometAPI арқылы Клод кодын пайдалану көбірек шығындарды үнемдейді. CometAPI ұсынған Claude API ресми бағасынан 20% арзандатылған және ресми тұлға соңғы үлгісімен жаңартылған.

Claude Code cli пайдалануға дайынсыз ба? кеңесіңіз API нұсқаулығы нұсқаулық үшін.

Егер сіз AI туралы көбірек кеңестер, нұсқаулықтар және жаңалықтар білгіңіз келсе, бізге жазылыңыз VK, X және Арасындағы айырмашылық!

Сондай-ақ, қараңыз CometAPI арқылы Клод кодын қалай орнатуға және іске қосуға болады?

қорытынды ой

Субагенттер ретінде қарастырыңыз қайта пайдалануға болатын, нұсқаланған микротұлғалар. Кішкентайдан бастаңыз: а жасаңыз doc-reviewer және test-runner репо үшін оларды тексеріңіз .claude/agents/, және оларды бассыз пайдалану арқылы CI жүйесінде автоматтандырыңыз claude -p. Сұрауларды қайталаңыз, құрылымдық шығыстарды қосыңыз және құрал рұқсаттарын қатайтыңыз.

Ең көп көмектесетін психикалық модель: Клодты жоба менеджері және қосалқы агенттер командадағы мамандар ретінде елестетіңіз. Менеджер нақты жазылған тапсырмаларды береді, мамандардың нәтижелерін жинақтайды және қорытынды есепті жазады. Уақыт өте келе сіз сенімділіктің, сынақтан өтудің және әзірлеушілердің жұмыс процестерінің үлкен бөліктерін автоматтандыру мүмкіндігінің жақсарғанын көресіз.

Толығырақ оқу

500+ модель бір API-да

20%-ға дейін жеңілдік