Субагенты Claude Code: што гэта і калі іх ужываць
Чым субагенты Claude Code адрозніваюцца ад навыкаў і каманд агентаў: ізаляцыя кантэксту, першы ўласны субагент, лепшыя практыкі апісання і інструментаў і калі без іх лепш.
Агенты — гэта не проста мастнасць пад іншым назвам
Звычная першая рэакція на агентаў Claude Code — гэта мастнасць з дадатковымі крокамі, „болей розумная мастнасць“, якая дзеяе самастоятэльней, таму што яе інструкцыі сформульаваны інача. Гэта неправільна кароткая апісанне. Агент — гэта таксама запрошчанне, як і мастнасць. Разлік, які мае значэнне, — гэта тое, дзе ён выконваецца. Агент не выканаўляецца ў межах главнага размовы. У яго ёсць савой вікна кантэксту, савой сістэмны запрошчанне, савой доступ да інструментаў і савойя правыя, ён працуе па боку і вяртае рэзультат.
Тое, што будзе пасля, выходзіць з аснов: што такое гэтыя агенты, як стварыць аднаго з іх і калі вартуюць зусілля. У цым матэрыяле прыпускаецца, што вы ужо вжываеце Claude Code і хочаце правільна разумець гэтыя можлівасці пры перадзеўранні якой-лібо настройкі. Парадок: спачатку пытанне вокабуляру, потым прычыны існавання падагентаў, далей — першы спецыяльны падагент, потым разлік іх з навыкамі, практыкі працы, кароткае розглядзенне команд агентаў і, нарэшце, случаі, калі агент ёсць неправым выборам.
Чатырнацца прычыны, чаму людзі маюць на увазе „агента“
У Claude Code слова „агент“ абходзіцца прынеймна чатырма разнымі рэчамі, і плутанне іх ускладняе розумеенне всіяў гэтай функцыі. Невеліка педантычнасць тут дапамагае, адтолькі што ёй ведомы вокабуляр, які можна практычна выкарыстоўваць.
- Claude Code сам ёсць агентнім серэдовішчэм. Anthropic прэзентуе яго як агентного помічніка для кодування: ён мае інструменты і цыкл выканання, можа плануваты і дыяты у кількох кроках без необхідносты постыйніх вказівок. Ён ёсць агентнім шчэ до того, як ві шчось налаштуеце.
- Підагенты — гэта спеціалізовані прымітывні агенты всерэдыні продукту. Колі фахівець кажэ, што створуе агента в Claude Code, майжэ завжды мае на увазі підагента. Згідно з офіційною документаціею, гэта спеціалізовані помічнікі для певніх тыпів завдань, кожэн з якіх мае окрэме вікно кантэксту, індывідуальній сістэмній запіт і власні права доступу до інструментаў.
Рэшта прытамліваеся да другага пункту – падагентоў. Команды заслуговаюць на аднародны падход пазней; дакладна апісаны адзін падагент – гэта правільны спосаб начала.
Чаму існуюць падагенты
Основная прычына заключаецца у тым, што мовныя мадэлі маюць скончаны кантэкст, і раней чы пазней довгая сесія доходзіць да сваёй межы. Без якіх-небудзь прыемаў гэта трапляецца знову і знову.
Эсэй компаніі Anthropic пра кераванні кантэкстам опісвае гэтую дзялячоść як кераванне тым, што падае ў скончаны прастор. Кожны вызов інструмента, чытанне файла і незакончаная аналіза дадаюцца да кантэксту і застаюцца там. Чым дольшая трывае сесія, тым больш прастору захопляюць элементы, якія дапамаглі знайсці адказ, але пасля ўжо не маюць значэння. Гэты бялкань зніжае якасць, а такі стан часта называюць занэчысцэнням у прасторэ. У мадэлі застаёцца менш простору для працы, а больш нерэлевантных матэрыялаў конкуруець за ёё увагу.
Сабагенты — адзін з спосабаў рашэння. У апісанні функцыяй Claude Code праўда сказана: сабагент можа чытаць дзесяткі файлоў або выканаць масштабныя пошукі, але галоўная розмова отрымае толькі статыстыку, таму проміжная работа ніколі не выкарыстоўвае галоўны кантэкст. Гэта практычна, калі проміжныя крокі не патрабуецца паказваць.
Конкрэтны прыклад: вы прасіце Claude з’ясаваць, чаму не праходзі тэсты. У галоўнай сесіі для расследавання патрэбна чытанне двадцяты файлоў, пошук патэранаў адказак, перагляд настройкаў тэстоў і сканаванне няўздрóжных змян. Усё гэта потрапляе ў ваш кантэкст. До канца вы выкарыстаўце кількі тысяч токенаў на проміжную работу, а практычна нішто з гэтага не вплывае на тое, што вы будзеце робіць далей.
Падзеяк перакшталевае проблему. Раследаванне адбываецца ў сваёй сабэйной вікнавай супакоўцы і за сваім бюджэтам токенаў, а рэзультатам яе ёст мяккі вердыкт, на кшталт "парадкі паврэмнай дзейнасці адносяцца да зменнай сераўыска, якой няма ў настройках CI; паўнаждаліся тры тэсты, і хутчэй — рэмонт". Галоўны поток ніколі не прыемле ўсё гэта шума з пошуку.
Галоўныя прычыны — ізоляція кантэкста, а таксама ўжо тры меншыя:
- Спеціялізацыя. Падзеяк мае свой сабэйны запрос да сістэмы. Адпаведальны рэвізор, які мае інструкцыі па стандартах вашай каманды, будзе аддаўальнейшы, чым загальны асістэнт, які намагаецца дапэўніваць гэтыя стандарты праз усё іншае, што ведае.
Стварэнне першага спецыяльнага падагента
Тэхнічна падагент — гэта проста дакумент у фармаце Markdown з загалоўнікам у фармаце YAML. Дапускаюцца два месца размешчэння:
.claude/agents/унутрь праекта, для агентоў, якія прыязначаны да таго кодавага базы. Зберажыце іх, каб команда могла іх аднароджваць і паспрабаваць ўдосконаліць.
~/.claude/agents/ у дырэктарыі домашньага каталога — для персональных агентаў, якія ўдоступны ў кожным праекце.Фронтматар заслуговае на увагу
Людзі часта прыглядаюцца толькі да YAML-фронтматара, але Claude Code зберагае яго ў памяці главнай сесіі, каб з’ясавіць, для чаго праглядаецца кожны агент. По суты, гэта ўзагальненне агента. Два поля ўскладненыя, а калькі іншых — неабавязковыя. Просты прыклад паказвае, як яны взаімаюцца між сабою:
---
name: code-reviewer
description: Reviews code changes for quality, security, and best practices.
Use proactively after any significant code change.
tools: Read, Glob, Grep
model: sonnet
---
You are a code reviewer. When invoked, read the changed files and provide
specific, actionable feedback on code quality, security, and best practices.
Focus on what matters. Don't restate what the code does — say what's wrong
or good about it. Flag security issues first, then logic problems, then style.
Працюем поле за полем:
name— гэта унікальны ідэнтыфікатор, напісаны маленькімі літэрамі з выключнай можлівасцю вжывання гіпенаводакоў. Ён прадстаўляецца ў логах, а Claude выкарыстоўвае яго для внутршняга называння агента.descriptionмае найбольшое значэнне. Claude адзіраецца на яго, каб выявіць, чы праца належыць данаму агенту; таму ў яму трэба опісаць яго функціі, задачы, якія ён віконвае, і моменты, калі трэба да яго звернуцца. Уключэнне фразы „выкарыстоўваць праактыўна“ ёсць заданым сігналам для Claude, каб ён актываў агента без чакання явнае просьбы. Калі агент павінен адпавядаць толькі пасля прымальнай просьбы, эту фразу трэба выключыць.
tools абмежвае тое, да чаго можа дасячыць агент. Вышэўзгаданы пераглядач можа чытаць файлы і вядомаць, але не можа рэдагаваць, запускаць каманды шэлу чытаць сеціяны звязкі. Гэта робіцца намеравана: пераглядач з правамі толькі на чытанне не можа віпадкова змяніць тое, што пераглядае. Сама дакументацыя радзіць надаць толькі тые засобы, якія патрэбны агенту, для безпекі і каб яго поведзенне было прыглядна.model направляе агента да конкрэтнага модэлю: sonnet, opus, haiku чытаець полны ідэнтыфікатор, такі як claude-opus-4-6. Без яго агент выкарыстоўвае параметр inherit, што значыць, ён вжывае той самы модэль, што і галоўная сесія.Пэўныя дапаможнія поля паказваюць, сколькі ўсё можна налаштаваць: permissionMode, maxTurns, skills, mcpServers, effort, memory, hooks, disallowedTools, color і іншыя.
Паказваўшы адны агента, можна падумаць, што ён злічываецца як навык. Частка вашага мнення правая, але вы часткова не разумееце сутнасці, якая будзе раскрыта ў наступных раздзелах.
Дзе зберагчы файл
Зберажыце прыклад як .claude/agents/code-reviewer.md у праекце. Рэзультатавае распалоўванне будзе выглядаць так:
your-project/
├── .claude/
│ ├── agents/
│ │ └── code-reviewer.md ← your new agent file
│ ├── skills/
│ └── rules/
├── src/
├── tests/
├── README.md
└── package.json
Пасля зберэжэння Claude выклікае агента. Запытайце яго пераглянуць змяны ў кодзе, і ён самастаільна перадае задачу code-reviewer, залежна ад таго, насколькі добра запыт падходзіць да опісу. Для персональнага агента, які працуе ў всіх праектах, перыяжыце файл у ~/.claude/agents/code-reviewer.md. Фармат і змест застаюцца тыя ж; меняецца толькі месца розташоўвання.
Агенты проты навыкаў
Чаму іх часта плутаюць
Тры аналогіі пояснююць большую частку плутання:
- Оба стваруюцца за дапамою простай структуры падпакетаў, унутры
.claude/skillsабо.claude/agents. - Оба выкарыстоўваюць frontmatter, і ў обох опіс ёсць найважлівейшым параметрам.
- Оба ўскладненыя з інструкцый, інымі словамі — прапаноў. Навык і агент можу міць абсолютна тыя ж словы.
Якшча на гэты спосаб адглядзецца, яны выглядаюць структурна аднаковымі.
Дзе ведзецца работа
Аднак існуе адна відчутная, практычная разліка, якая іх адзінае: дзе ведзецца работа, тыяму, дзе вітрачаюцца токены. Гэта самая простая разліка для разумення.
- Навык уключаецца ў актуальную розмову. Яго інструкцыі, шаблоны і дапаможныя файлы прыўязуюцца да актываўага кантэксту, Claude працуе з імі ў той жа поток, і кожны крок дадаецца да галоўнага вікна.
- Падагент працуе окрэма ў сваёй сабецвяце кантэксту. Ён ведае работу, а галоўная розмова отрымае рэзультат.
Параметры налаштавання
Раней існав дзялёгі спіс паўз, якіе агент можа настаўіць у сваім фронтматэры. На адміністрацыю, навыкі прыманяюць значна корачы спіс, які часткова таксама разны. Гэта натыякае на тое, які большы контроль дае агент. Гэта не прычына ператвараць усё на агента. Сэрцэвы момент у тым, што ментальную мадэль, якая выкарыстоўваецца для стварэння надзеянага распараджэння, можа знадобіцца перэпрацаваць.
Адна задача, два адпаведзення
Возьмім прыклад жадання, каб стандарты перагляду коду вашай команды прыменяліся адносова стабільна.
Калі Воблакэ ўсю сесію павінен быць у кансэкцыі гэтых стандартоў, выкарыстоўваць іх пад час напісання коду, цітаваць іх у аднасоўленнях і адзначаць ўсупершце ў разы, калі яны наступаюць, тады падходзіць навык. Напісайце стандарты адной раз і Воблакэ будзе выкарыстоўваць іх у кантэксце, калі яны стануць актуальнымі, тады ўсё, што будзе адбывацца пад час сесіі, зможа спакою на іх паслужыцца.
Калі ж вы хочаце, каб чырвантсці 40 файлоў за адну практыку, без таго, каб галоўны кантэкст заполняўся данымі з чытання файлоў, промежуточнымі каментарамі і рэзультатамі пошуку, тады патрэбны сабагенты. Налажыце агента для перагляду коду, дазвольце яму працаваць у сабеінсталяванай вікнарэйцы, а потым отрымайце структураваны падсумак. Вы нават можэце запусціць 40 сабагентоў паралельна, по аднаму на кожны файл. Галоўная розмова отрымае рэзультат, не маючы доступу да самай працы, якая яго стварыла.
Адна фраза можа паспрацаваць для адграджэння: навык зменяе тое, што ведае Claude або як ён падходзіць да выкарыстання рабочага працэсу, тады як сабагент зменяе тое, хто выкаанае работу, у якім кантэксты і з якімі інструментамі.
Практыкі працы, якія застойваюцься
Спрыяйце аднароджэнню опісу як інтарфейса для направлення
Гэта частка тэксту не адказвае належнаму значэнню. Claude чытае апісанні падагентаў, каб вырашыць, калі трэба дэлегавацыя, і ён не чытае сам тэкст запіту пры гэтым рашэнні. Усё конкрэтнае, што вы пакладзіце ў тэкст запіту, застаецца невідомым, пакуль падагент не будзе створаны. Таму апісанне павінна мяць достатню інфармацыю, каб Claude знаў, калі патрэбен агент.
- Іспользуйце конкрэтныя, опісовыя фразы.
- Указайце, што робіць агент і в якіх сітуацыях яго трэба выбраць.
- Праменавайце, якія задачы ён выконвае добра, а таксама, калі гэта патрэбна, якія ёму не трэба рашыць.
- „Іспользаваць актыўна пасля змян у кодзе“ — гэта перапрацаваны патэрн, указаны ў дасяглінах як спосаб стымулявання дэлегавацыі без прымусовага запіту. Ігноравайце яго для агентаў, якія павінны працаваць толькі тады, калі іх прызываюць безпосерэдна.
Ёсць калі вы хочаце паказаць разлік, паставьце нечыярый опіс ("Дапамагае з якасцю коду і задачамі рэвізіі") падле опісу, напісанага для направлення: "Аналізуе внесеныя змены на наявнасць проблем з безпекай, логічных бягоў і прынцыпаў стылю. Яго трэба запускаць практычна пасля кожной значныя змены. Ён ніколі не пішчыць код і не будзе рэдагаваць файлы."
Жадана обмежэнасць інструментаў
Агент, які успадковвае всі інструменты з галоўнай сесіі, ёсць складным для разумеўкі, калі ўтвараюцца проблемы. Дазвольце толькі тое, што неабходна для выпання задачы.
- Рэвізор павінен магчыма быць толькі чытаць, і нічога больш: без пісання, без шэлу, без сеткі.
- Дзеянне па адкрыцці ўсёлякіх дадзеных вымагае пошуку і запрашэння інфармацыі, без можлівасці праверкі файлаў.
- Адрабатка тэстаў значыць наявнасць доступу да Bash, але нема прычын касавацца веб-сэрвісаў.
Обмежэнне інструментаў спрыяе безпеке і яснасці. Меркавы набор інструментаў робіць паведзенне прыемлема працэсавальным, а калі агент не выканае задачу або вернее ўсёлякія незвычныя даныя, короткі спіс можлівых інструментаў прышвартавае дыягнастыку. Цэя мера таксама робіць формы неудач заканчальнымі і вядомымі. Поле disallowedTools дазволяе агенту успадкаваць інструменты главнай сесіі, а пасля выключыць конкрэтныя з іх, што падходзіць для сітуацый на кшталт „усё, кроме Bash“ або „усё, кроме Write“.
Даўкож кожнаму агенту адна задача
У дасягліх інструкцыях па падагентах сказана, што кожны падагент павінен выдатна справляцца толькі з адной задачай. Такой опіс, як «пераглядае код, пішчыць тэсты, апдэйтуе дасяглі і керуе пераказкамі», адначасова паводзіць чатырнацца характэрыстыкі ў аднам поле. Claude можа неравнамерна прыкладзіцца да яго, а прампт сістэмы вынужана справляцца з чатырма рэжымамі работы адночасова.
Зменшыце сферу дзеяння і створыце тры адзінаковыя файлы, кожны з якіх мае аднаковы і чысты опіс. У науцы дадзеных гэтымі могу быць агент для параболкі модэля, пераканалізатор якасці дадзеных і пераглядач нотбуков. У програмнай інфармацыі — пераглядач коду, генератор тэстаў і апдэйнавальнік дасяглі. Гэты прынцып праўільны ў будзь-якай галіне. Кожны агент отрымае адну задачу, свой файл і опіс, які дазволяе без двусмысленнасці кераваць яго дзеяннямі.
Ўжывайце поле «модэль» для керавання выкладкамі
Людзі, які ўсё ўсё не былі здываваны своім рахункам за вікорыстання, зазвычай максімальна ігнаруюць гэтая поле. Выкорыстанне model: haiku у легкіх агентах значна зменшае вітраты, калі колькасць агентоў працуе ў одной сесіі. Выкорыстанне model: opus у агенце, які павінен даглыбна аналізаваць вялікі кантэкст, прабачае яго высокую цену. Залічэнне значэння inherit, як стандартнае, означае, што кожны агент працуе на тым жа модэлі, які вікорыстоўваеся ў галоўнай сесіі, часта на найболей моцным модэлі, які застаўляецца для задач, якім ён не патрэбен.
Што выбрала спяльнота
Каталог сабагентаў VoltAgent аб’яднвае больш чым сто спецыялістаў-сабагентаў – ад экспертаў па мовам, пераканальнікаў безпекі, адлагоджувачаў, дапаможнікаў у інфраструктурэ да організатораў задач. Іншыя цікавыя сабраліся ў рэпазітарыі Everything Claude Code. Людзей, якім патрэбна хоць пята частка іх, мало, таму колькасць не ёсць галоўным моментам – важліва структура. Кожны элемент у гэтых каталогах спецыялізуецца на аднай галіне: будзь то эксперт па TypeScript, SQL, Kubernetes або аўдытор безпекі. Ніхто з іх не намагаецца пакрыць адразу калькі галоў. Гэта ўзгодна пасля больш чым года рэальнага выкарыстання: многі фокусаваныя агенты працуюць лепшая, чым аднаму універсальнаму агенту.
Короткая інформацыя пра команды агентаў
Команды агентаў таксама вартая увагі, але яны ёсць іншай функцыяй, чым сабагенты.
Падзеякі застаюцца ў межах адной сесіі. Галоўны экземпляр Claude Code стварае іх, яны працуюць адособлена і вяртаюць рэзультаты, а вы застаецеся аранжавальнікам.
Команды агентаў — гэта незалежныя сесіі Claude Code, якія спілкуюцца адзін з аднім праз спяльны спіс задач і прымытую перасылку паведамленняў. Кожны член команды мае свае вікна кантэксту і стан сесіі, і можа прадаць задачы іншым, а таксама іх прымаць.
У даследжэнні команды пераказваецца, дзе дапамагае дадатковая інфраструктура: для даследжэння чы адзначэння разам з калькама членамі команды, якія разам аналізуюць разныя аспекты; для адлучэння бягаў за дапамогою супернікаючых гіпатэз, калі члэны команды пераглядаюць тэорыі адзін другога; і для стварэння новых модуляў, дзе кожны член команды адпавядае за свой компанент і ухіляецца ад суперакцый з іншымі.
Іх настройка не ўсё така простая, таму яны не падпадаюць пад дэскрыпцію тут, і немае прычын спешыць заўсёды з страху працягнуць усе за собой. Команды дадаюць дапамогу ў коордынаціі, але спалююць значна больш токенав, адколі кожны учаснік команды мае свой окно кантэксту, за якое плаціцца незалежна. Яны ў тэставанні і за замовчанням выключэны, а ўвядзены праз змэнную сераўіса.
Практычная правіла: як толькі вашы падагенты дапавядаюць вам і не патрэбуе між сабою спілкування, команды не патрэбны. Калі аднаму з падагентаў трэба перадаць даны іншаму або запытацца пра яго выводы, тады павышэння становіцца карысным. Да таго часу падагентов достатнек.
Калі агент — не тое засоба
Саветы самай компаніі Anthropic па стварэнні эфектыўных агентаў вартыя серйознага спрытку. У яных рэкамендуецца шукаць самая простую прыемную рашэння і дадаваць складнасць толькі тады, калі гэта неабходна, што можа значыць або вовсе не ствараць сістэмы-агенты.
Гэта прыменяецца без адліканняў. Ёсць калькі сітуацыяў, калі падагент стварае труднасці і не дае нічога:
- Ексклюзыўныя задачы. Падагент выконвае додатковыя задачы: называнне, напісанне апісу, выбір інструментаў, тэставанне, адтрымка. Задача, яку трэба выконаць толькі раз, не прабачае такога, таму крашчэ напісаць хорашы запрос. Інвестыцыя вертаецца толькі тады, калі рабочы працэс павтараецца достатнь часта, каб было сэнс адтрымваць вялічыну падагента.
Загальны прынцып — вжываць найпростэйшы інструмент, які рашае справжняю проблему. Дадавайце агенты, калі проблема — ізоляцыя кантэксту, спецыялізаваныя обмежэння або спецыяльная екзекуцыя, а не таму, што агенты здаюцца моцнейшымі.
Короткая версія
Простаючы, сабагенты керуюць кантэкстам і пазначаюць межы выканання задач, хоча большасць людзей спрыяе ўважваць іх дадатком для паўнэйшага раскрыцця можлівасцей.
Адзін рэтэльна настроены агент — гэта прыемны обсяг работы на адзін дзень. Для цябе не патрэбна сістэма кіравання: дастатньа сфокусаваная апіс, обмежаны набор засобаў і адна чыстая задача. Складнасць можа вырастаць даўжэй, але не павінна почынацца з яе.
Есць калькі пытанняў, якія варта сабе задаць. Калькуюючаяся задача у вашай ныянейшай рабочай схеме, яку вы больш за ўсё хацелі бы перадаць ізольаванам працоўніку, і што вас стрымвае? Калі вы ужо вжываеце сабагенты, якая была першая задача, дзе ізоляцыя справды мела значэнне, дзе ўжыванне яе ў галоўнай сесіі могла бы спрычыніць рэальную проблему? І як вы керуеце доступам да засобаў: обмежваючы яго па агенту, чы ў спадчыну ад галоўнай сесіі з паслядуючым скорачэнням?