Claude Code-та үлкен тапсырманы кірістірілген субагенттер арқылы қалай делегаттауға болады

Claude Code v2.1.172 нұсқасында не өзгерді?#

Соңғы бірнеше айда Claude Code-тағы AI агенттері туралы бірдеңе оқысаңыз, бірдей тіркеске кезіккен боларсыз. Ол ресми құжаттамада, менің субагенттер туралы нұсқаулығымда және әр бәсекелеске жасалған талдауда кездеседі. Ол былай дейді: «субагент басқа субагентті іске қоса алмайды». 2026 жылғы 11 маусымдағы жағдай бойынша бұл жол әлі де code.claude.com/docs/en/sub-agents бетінің үш түрлі жерінде тұр. Anthropic оны әлі жаңартқан жоқ.

10 маусым күні сағат 20:44 UTC-де Claude Code v2.1.172 GitHub Releases бетінде пайда болды. Өзгерістер журналының негізгі тармағы бір жолдан тұрды:

Осы шығарылымда тек кірістіру кезінде болуы мүмкін қате де түзетілді: фондық субагент өзі іске қосқан кірістірілген субагент тоқтатылғаннан кейін де агенттер панелінде белсенді күйде ерекшеленіп тұратын.

Бұл — ресми құжаттама шыққан нұсқаға әлі де қайшы келетін сирек жағдайлардың бірі. Келесіде кірістірудің параллель субагенттерден айырмашылығын, «5 деңгей» нені білдіретінін және бүгінгі күні қай үш жағдайда шынымен пайдалы екенін түсіндіремін.

Кірістірілген субагенттер параллель және бірізді субагенттерден несімен ерекшеленеді?#

Мен осы үш тәсілді қолмен ұзақ сынап көрдім. Оларды былай түсінемін: делегаттаудың үш өлшемі бар — ені, ұзындығы және тереңдігі. Әрқайсысы бөлек мәселені шешеді.

Ені — параллель субагенттер. Негізгі чат бір деңгейде N тәуелсіз субагентті іске қосады. Әрқайсысы шағын міндет алып, жеке оқшауланған терезеде жұмыс істейді де, тек нәтижесін қайтарады. Ені жылдамдықты арттырады: параллель істейтін 5 субагент біреуі сол жұмысты бірізді істейтін уақыт ішінде аяқтайды. Бұл — мен worktree пайдаланып параллель субагенттермен жұмыс істеу туралы нұсқаулығымда қарастырған модель.

Ұзындығы — субагенттер тізбегі. A жұмыс істеп, нәтижесін B-ға береді; B жұмыс істеп, оны C-ға береді. Әрқайсысы алдыңғысының кіріс деректерін көреді. Ұзындығы ретті белгілейді: B A-дан дерек алмайынша бастай алмайды. Классикалық мысал: алдымен зерттеу субагенті дереккөздерді жинайды, содан кейін редакциялау субагенті сол деректерге сүйеніп мақала жазады, ал соңында фактчекинг субагенті мақаланы тексереді. Бұл — жазық реттілік; негізгі чат бүкіл оқиға желісін ұстап тұрады.

Тереңдігі — кірістірілген субагенттер. A B-ны, B C-ны, C D-ны іске қосады. Әрбір еншілес агент өзінің ата-анасының ішінде, жеке оқшауланған терезеде жұмыс істейді және ата-анасына тек нәтижесін қайтарады. Негізгі чат балалардың, немерелердің және шөберелердің терезелерінде не болып жатқанын көрмейді. v2.1.172 нұсқасындағы жаңалық — осы.

Негізгі түсінбеушілік — адамдар 5 деңгей дегенді «бір мезетте 5 субагент іске қосуға болады» деп ойлайды. Олай емес. Тереңдік ағаштағы тік деңгейді білдіреді, қатар іске қосылатын балалар санын емес. Әр деңгейде бір субагент те, жүз субагент те болуы мүмкін. 5 деңгей делегаттау тізбегі 5 қадам төмендей алатынын білдіреді: негізгі чат → немере-1 → немере-2 → немере-3 → немере-4 → немере-5. Әр деңгейде тармақталуға да болады.

2.1.172 нұсқасы субагенттің басқа субагентті іске қоса алмайтыны туралы ережені алып тастады.

Жылдамдық керек болса, ені қажет. Орындалу реті қатаң болса, ұзындығы керек. Тереңдік бір ғана жағдайда пайдалы: тапсырмаларыңыздың бірінде шулы қосалқы тапсырма болса (15 веб-сұрау, журналдарды шолу, ондаған файл оқу) және сол шудың негізгі терезені басып кетуін қаламасаңыз.

«5 деңгей тереңдік» іс жүзінде нені білдіреді?#

Мұнда шындықты ашық айту маңызды. Anthropic нақты анықтама бермегенін білу үшін құжаттама мен қауымдастық талдауларын жарты күн қарап шықтым. Мынаны білген жөн.

Бұл — шек, баптау емес.

Шектеу сервер жағында орнатылған. v2.1.172 клиентіне жасалған кері инженерия MAX_DEPTH тұрақтысын таппады. Демек, тексеру компьютеріңізде емес, Anthropic API ішінде бір жерде жүреді. Ағашты тереңдету үшін --max-depth 7 деп қоя алмайсыз. Қауіпсізірек төменгі шек орнату үшін --max-depth 2 деп те қоя алмайсыз. Сіз басқара алатын жалғыз нәрсе — frontmatter ішіндегі Agent(agent_type) рұқсат тізімі, бірақ ол еншілес агенттердің тереңдігін емес, түрлерін шектейді.

Anthropic «5» дегенді нақты анықтамаған. Бұл — екінші маңызды жайт:

Anthropic «5» дегеннің нақты мәнін көрсетпеген. Ресми дереккөздер depth=5 түбірден төмен бес деңгейді ме, әлде түбірді қоса есептегенде барлығы бес агентті ме білдіретінін нақтыламайды.

Әзірге үшінші тарап интеграциялары мұны әртүрлі түсіндіреді. ruvnet/ruflo жобасындағы ADR-147 «түбірден төмен 5 еншілес деңгей = тізбекте 6 агент» деп болжайды. Тәжірибелерімде мен де осы келісімді қолданамын: негізгі чат — 0-деңгей, оның тікелей балалары — 1-деңгей, әрі қарай 5-деңгейге дейін. Бірақ бұл ашық құжаттамада тіркелмеген.

Шектеу қазірдің өзінде қосулы, ешқандай жалауша қажет емес. Оны іске қосудың керегі жоқ. Claude Code-ты v2.1.172 нұсқасына жаңартқаннан кейін еншілес агенттің tools тізіміне Agent қоссаңыз, ол тағы бір субагентті іске қосады. Маңыздысы — ата-аналық агент бұған рұқсат беруі керек (tools: Agent(...)).

Бүгін делегаттауыңыз қай бағытта жүреді: ені, ұзындығы әлде тереңдігі ме?#

Соңғы 5 prompt-ыңызды қарап шығыңыз. Мынадай жағдай қаншалық жиі болады: тапсырманы бастайсыз, Claude файлдарды іздеуге кіріседі, вебке 10 сұрау жібереді, контекстке тұтас журналдар қабырғасын төгеді — 20 минуттан кейін терезенің толып кеткенін байқайсыз. Аралық шығарылымдар контекстің 70 пайызын тұтынғандықтан, соңғы жауапқа азғантай ғана токен бюджеті қалады.

Мұндайда сізге тереңдік керек. Параллельдік те, тізбек те емес — тереңдік. Негізгі чат «зерттеуді» бір субагентке тапсыруы керек; ол өз ішінен нақты веб-іздеулер, файл оқу және grep үшін балаларын іске қосады. Балалар тек қорытылған тұжырымдарды қайтарады. Немере ата-анасына «таптым, расталды» немесе «таппадым, себебі X» дейді. Ата-анасы осыны бір қысқаша түйінге жинап, сізге қайтарады. Негізгі чат таза қалады.

9 маусымға дейін мен мұны қолмен қайталайтынмын. Claude Code-тың екінші данасын ашып, «мынаны зертте» prompt-ын көшіріп, іске қосатынмын, содан кейін нәтижені негізгі терезеге өзім таситынмын. Бұл баптауды көптеген AI агентіне код жазуды делегаттау туралы нұсқаулығымда егжей-тегжейлі сипаттадым. v2.1.172 нұсқасында мұны оркестратордың жүйелік prompt-ында тікелей сипаттай аласыз — Claude ағашты өзі құрады.

Кірістірілген субагенттер қай 3 жағдайда шынымен пайдалы?#

1-сценарий. Фактчекингі бар терең зерттеу

Мақалаға не коммерциялық ұсынысқа материал жинап жатырсыз делік. Алдымен ашық дереккөздерден 5–10 тұжырым жинап, содан кейін әрқайсысын тексеру қажет: түпнұсқа дереккөзін табу, дәйексөздің дәл екеніне көз жеткізу және нақты сандарды есептеу.

v2.1.172 нұсқасына дейін екі жол болды. Бүкіл жұмысты бір субагентке беру: ол 30 веб-сұрауды орындап, бәрін контекстіне толтырып әлек болады. Немесе жұмысты қолмен бөлу: тұжырымдарды жинауға бір prompt, содан кейін әр тұжырымға жеке субагент іске қосатын цикл. Негізгі чат аралық тізімдердің ұзын-қысқа қабырғаларына толып кететін.

Төмендегі рецептте негізгі чат research-orchestrator агентіне тапсырады (1-деңгей). Оркестратор тұжырымдарды өзі шығарып, әрқайсын fact-verifier агентіне береді (2-деңгей), ал тексеруші нақты іздеуді web-deep-search агентіне тапсырады (3-деңгей). Негізгі чат дереккөздері бар тексерілген тұжырымдар массивін ғана алады. Қалғанының бәрі еншілес терезелерде қалады және контекстіңізге түспейді.

2-сценарий. Үлкен репозиторийді талдау

Сізге 200 файлдан тұратын жоба берілді. Архитектурасын түсініп, негізгі модульдерін тауып, техникалық қарызын бағалауыңыз керек. Glob пен он шақты Read шақыруын қолмен орындасаңыз, терезені 10 минутта толтырасыз.

Тереңдік мұны былай шешеді: негізгі чат «сәулетші» субагентін іске қосады. Сәулетші ішінде үш бала іске қосады — біріншісі каталог құрылымын қарайды (Glob іске қосып, қысқаша қорытынды жасайды), екіншісі 5 маңызды конфигурация файлын оқиды, үшіншісі негізгі үлгілерді grep арқылы іздейді. Әрқайсысы сәулетшіге қысқа түйін қайтарады. Сәулетші жалпы көріністі құрастырып, негізгі чатқа жарты экрандық қорытынды есеп береді. Барлық файлдан алынған cat шығысының тұтас қабырғасы контексті баспай-ақ жоба картасын аласыз.

3-сценарий. Тәуелділіктерді басынан аяғына дейін талдау

Дерекқор схемасын, API контрактын немесе ортақ конфигурация файлын өзгертіп жатырсыз. Өзгерістің салдары қай жерлерде байқалатынын түсіну қажет. Мұндай тапсырма контексті ең жылдам тауысады, өйткені тәуелділік көп және әрқайсысын бастапқы кодтан тексеру керек.

Тереңдікті қолданғанда негізгі чат «impact-analyzer» агентін (1-деңгей) іске қосады. Ол әсер ететін әр файл үшін бір dependency-tracer іске қосады (2-деңгей). Әрбір tracer осы тәуелділікті пайдаланатын жерлерді код базасынан grep арқылы табатын consumer-finder агентін (3-деңгей) ішінен іске қосады. Әрқайсысы тек мәнін қайтарады: «мына үш жер бұзылады». Негізгі чат grep нәтижелерін көрмей-ақ «әсер ететін файлдар → әсері» кестесін құрастырады.

Кірістірілген субагенттерді 10 минутта қалай баптауға болады#

1-қадам. v2.1.172 немесе одан жоғары нұсқаны пайдаланып жатқаныңызды тексеріңіз.

claude --version

Нұсқаңыз ескі болса, жаңартыңыз. Шығарылымның негізгі мүмкіндігі өзгерістер журналында бір жолмен берілген: «Енді субагенттер өз субагенттерін 5 деңгейге дейін терең іске қоса алады» (толық мәтіні).

2-қадам. Балаларды іске қоса алатын ата-аналық агент жасаңыз.

.claude/agents/research-orchestrator.md файлы:

---
name: research-orchestrator
description: Терең fact-check арқылы зерттеуді делегаттайды
tools: Agent(fact-verifier), Read, WebFetch
model: opus
---

Сен зерттеу оркестраторусың. Тақырып алған соң:
1. Берілген материалды оқы немесе берілген ашық дереккөз URL мекенжайларын ал.
   Беске дейін нақты тұжырымды өзің шығар. Әрқайсысына тұжырым мәтінін,
   дереккөз URL не файлды және дәл қолдайтын үзіндіні тірке.
   Бастапқы материал берілмесе, делегациядан бұрын оны сұра.
2. Әр тұжырым үшін fact-verifier агентін шақыр — ол вебтен іздеу
   және салыстырып тексеру үшін өз еншілес субагенттерін іске қосады.
3. Fact-verifier саған тек соңғы қорытындыларды қайтарады —
   аралық шығарылымдарды контекстіңе жүктеме.

Соңғы есеп тек { claim, sources[], confidence } массиві болсын.

tools жолы тек fact-verifier бала түрін береді. Тұжырым шығару — оркестратордың өз алғашқы қадамы, сондықтан анықталмаған claim-extractor файлы керек емес. Түр allowlist-і қай бала шақырылатынын шектейді; сол түрдің неше рет басталатынын шектемейді. Рецептті ең көбі бес шығарылған тұжырыммен шектеңіз.

3-қадам. Өз немерелерін іске қоса алатын еншілес агент жасаңыз.

.claude/agents/fact-verifier.md файлы:

---
name: fact-verifier
description: Тұжырымды еншілес веб-іздеулер арқылы тексереді
tools: Agent(web-deep-search), Read
model: sonnet
---

Сен факт тексерушісің. Тұжырым алсаң:
1. 2-3 іздеу сұрауын тұжырымда.
2. Әрқайсысы үшін web-deep-search іске қос — ол өзі
   WebSearch пен WebFetch орындап, тексерілген үзінділерді қайтарады.
3. Бір verdict ішіне жинақта: { claim, sources[], confidence }.

Маңызды тұсын байқадыңыз ба? tools жолында тағы да Agent(web-deep-search) деп жазылған. Демек, fact-verifier (ағашымыздағы 2-деңгей) өзі тағы бір субагентті (3-деңгей) іске қоса алады. Бұрын бұл жол ештеңе істемейтін — құжаттамада әлі мына тіркес бар:

v2.1.172 нұсқасында бұл жол ескірген. Синтаксис сол күйінде, бірақ енді ағаштың кез келген тереңдігінде жұмыс істейді.

4-қадам. Немере агент жасаңыз.

.claude/agents/web-deep-search.md файлы:

---
name: web-deep-search
description: Вебтен іздеп, үзінділерді қайтарады
tools: WebSearch, WebFetch
model: haiku
---

Саған іздеу сұрауы келді. WebSearch орындап, ең өзекті 3 URL таңда, WebFetch арқылы тұжырымды сөзбе-сөз растайтын дәлелдерді ал. { url, snippet, supports_claim: yes|no } массивін қайтар.

Немере агенттің tools тізімінде Agent жоқ, сондықтан ол ағашта әрі қарай субагент іске қоспайды.

5-қадам. Оркестраторды іске қосыңыз.

claude --agent research-orchestrator

Кейін чатқа бастапқы мәтінді не ашық дереккөз URL мекенжайларын беріңіз: «Осы дереккөздерден беске дейін нақты тұжырым шығарып, тексер; тұжырымдарды, дереккөздер мен сенімділікті қайтар». --agent research-orchestrator кезінде сеанстың өзі оркестратор болады; тексеруші мен іздеу балалары оның астына екі делегация деңгейін қосады. Кәдімгі негізгі сеанс осы оркестраторға тапсырса, сол негізгі сеанстан төмен үш делегация деңгейі болады.

Қандай 5 антиүлгі токендерді шығындап, бақылау мүмкіндігін жояды?#

1-антиүлгі. Тапсырма бір терезеге сыяды.

Егер бір субагент тапсырманы шу шығармай орындай алса, қосымша деңгей қоспаңыз: кірістіру шығын мен кідірісті себепсіз арттырады.

2-антиүлгі. Сізге оқшаулау емес, жылдамдық керек.

Жылдамдық керек болса, тереңдік емес, параллельдік қажет. Тізбек құрудың орнына бір деңгейде қатар тұрған 5 субагентті іске қосыңыз. Тереңдік шулы дайындық жұмысын еншілес терезеге көшіруге арналған, жұмысты жылдамдату үшін емес.

3-антиүлгі. Жұмыс бастапқыдан-ақ қарапайым.

«Мына файлды тауып, маған көрсет» — екі қадамдық сұрау; оған үш деңгейлі иерархия қажет емес. Тапсырмада шулы қосалқы жұмыс болса, кірістіру орынды. Шу болмаса, субагент қоспаңыз.

4-антиүлгі. Бірінші деңгейдегі түсініксіз prompt-тар.

Бұл — ең қауіпті сценарий. 1-деңгейдегі оркестраторға түсініксіз prompt берсеңіз, түсініксіздік көбейеді. Бір түсініксіз 1-деңгей prompt-ы 2-деңгейде 4 түсініксіз prompt-қа, ал 3-деңгейде 16 prompt-қа айналады. Немерелер жұмысқа кіріскенде, не іздеп жүргенін де білмейді.

5-антиүлгі. Шығынның геометриялық өсуі.

Негізгі экономикалық уәж: кірістіру токен шығынын көбейтеді, ал бұл көбейту тереңдеген сайын жинақталады.

Шамамен есеп: әр деңгейде 3 тармағы бар 3 деңгейлі тізбек — 27 субагент. Бұл қарапайым сұраудан кемінде 27 есе көп токен. Claude Pro жоспары бұл есеп бойынша күндік лимитті бірнеше сағатта тауысады. Max жоспары болса, апталық лимит бір күнде таусылады.

Қосымша антиүлгі (менің тәжірибем): «50 агент мәнсіз жұмыс істеп жатыр».

Басқа адамдардың жобаларын қарағанда мынаған жиі кезігемін: «Менде 50 агент жұмыс істеп жатыр». Не істеп жатқанын сұраймын. Сөйтсем, әлгі 50 агент мәнсіз жұмыс істеп жатыр. Олар қажетсіз шығыс үйінділерін, өңделмеген түйіндерді, қайталанатын мазмұн мен журналдар қабырғасын шығарады. Әрқайсысы «жалпы пайдалы» бірдеңе істейді, ал нәтиже — контекстің бітелуі және шағын компанияныкіндей токен төлемі. 5-деңгей тереңдік бұл мәселені шешпейді — одан әрі ушықтырады. 1-деңгейдің өзінде кім не істейтіні түсініксіз болса, 5-деңгей бес қабат шатасу деген сөз.

Кез келген субагентті іске қоспас бұрын, жарты минутта 4 сұраққа жауап беріп тексеріңіз:

• Ол нақты не істейді (бір сөйлеммен)?
• Қандай файлдарға тиеді?
• Ата-анасына не қайтарады?
• Оны кім тексереді?

30 секундта жауап бере алмасаңыз, бұл субагент болмауы керек. Бұл ережені параллель субагенттер туралы нұсқаулығымда бөлек түсіндірдім.

Контекст инженериясынсыз кірістіру неге 5 деңгей галлюцинацияға әкеледі?#

Осы жерде адамдар жиі сұрайды: «Claude Code-ты жаңарттым, tools-қа Agent қостым, ағаш құрылып жатыр — бірақ соңғы жауап әлі де дұрыс емес. Неге?»

Жауап қарапайым. Claude Code-та әр субагент басынан бастайды. Ресми құжаттамада былай делінген:

1-деңгейде мұны басқаруға болады: оркестратор баласына қысқа тапсырма сипаттамасын береді. Ал 3-деңгейде немере ата-анасынан делегаттау хабарын алады, бірақ ата-анасында да тек сондай хабар болған. Әрқайсысы азғантай ақпаратты ғана әрі қарай жеткізді. 5-деңгейде терезесінде «X тұжырымын тексер» деген сөз ғана бар субагент шығады. Ол қай жобада жұмыс істеп жатқанын, қандай тапсырманы орындап жатқанын немесе неге назар аударуы керегін білмейді.

CLAUDE.md болмаса, бесінші деңгейдегі немере өмірінде алғаш рет жұмысқа келіп, ешқандай таныстырудан өтпеген қызметкерге ұқсайды. Тапсырма алғандықтан бірдеңе істейді. Бірақ ол жобаның қажетіне сай болмайды.

Сондықтан бұл баптау аса қажет. Дұрыс конфигурацияланған CLAUDE.md, business/ және дағдылар тізбегі болмаса, 5-деңгей тереңдік — казино. Бұлармен ол құралға айналады.

v2.1.172 нұсқасында кірістіруден басқа не өзгерді?#

v2.1.172 нұсқасының толық өзгерістер журналын ашсаңыз, бүкіл шығарылымның субагенттерге қатысты екенін көресіз.

1-түзету. Фондық субагент өзі іске қосқан кірістірілген субагент тоқтағаннан кейін агенттер панелінде «тұрып қалған» белсенді күйде қалмайды. Бұл қате тек кірістіру кезінде пайда болуы мүмкін.

2-түзету. availableModels шектеулері енді субагенттерге де қолданылады. Бұрын команда қолдана алатын модельдерді шектесеңіз (мысалы, ақша үнемдеу үшін opus моделіне тыйым салсаңыз), субагенттер өз конфигурациясындағы override арқылы бұл ережені айналып өте алатын. v2.1.172 нұсқасында ереже барлық жерде қолданылады.

3-түзету. Енді prompt тарихындағы жоғары көрсеткі негізгі агенттің емес, субагенттің ағымдағы қойындысындағы prompt-тарды көрсетеді. Бұл — бақылау мүмкіндігін жақсарту.

4-түзету. Бос тұрған кездегі процессор жүктемесі азайды: /goal индикаторы енді бос кезде терминалды 5 Hz жиілікпен қайта сызбайды, ал параллель субагенттер жұмыс істеп жатқанда интерфейс сирек жаңарады.

Төрт түзетудің бәрі субагенттерге қатысты екенін атап өтейін. Демек, Anthropic өзгерістер журналына бір жол ғана қоспай, кірістіруге арналған тұтас инфрақұрылым стекін шығарған. Жарияланбай тұрып-ақ кірістіру Anthropic ішінде біраз уақыт қолданылған.

Тексеру тізімі: кірістіру қашан көмектеседі, қашан зиян келтіреді#

Мына жағдайда кірістіруді қолданыңыз:

• Тапсырмада веб-сұраулары, grep іздеулері немесе оқылатын файлдары көп қосалқы жұмыс бар.
• Ол қосалқы жұмыстың нәтижесінен айырылуға болады (немере «ештеңе таппадым» десе, оркестратор жұмысты жалғастыра алады).
• Негізгі терезеде аралық нәтижелердің қажеті жоқ.
• Субагент сүйене алатын CLAUDE.md және жинақталған жоба контексі бар.
• Әр деңгейдің не қайтаратынын (кіріс, шығыс, пішім) анық сипаттай аласыз.
• Max жоспарыңыз бар немесе ×27 токенге жететін қорыңыз бар.

Мына жағдайда кірістіруді қолданбаңыз:

• Бір субагент тапсырманы шу шығармай орындай алады.
• Негізгі терезеде аралық нәтижелер керек (демек, сізге параллельдік қажет).
• Жобада CLAUDE.md жоқ немесе онда бизнес контексі тым аз.
• 1-деңгейдегі prompt-тар анық емес (анықсыздық ағаш бойымен экспоненциалды көбейеді).
• Сізге жылдамдық керек — бірдей нәтижеге параллельдік тереңдіктен жылдамырақ жетеді.
• Pro жоспарын қолданып, күні бойы жұмыс істейсіз — бірнеше сағатта лимитті тауысып қоясыз.

Қосымша материалдар Ailoot сайтында.