агенты claude code: субагенты, параллельная работа и свой агент-ревьюер

агенты claude code — это субагенты: отдельные помощники со своим окном контекста, своим системным промптом и своим набором инструментов. главный claude отдаёт им побочную задачу и получает назад только короткий итог, а весь шум (логи, найденные файлы, вывод тестов) остаётся у агента. они окупаются на поиске по большому коду, ревью и независимых задачах, а на мелких и связанных правках только тратят лимиты. ниже — как они устроены, как написать своего ревьюера и как запускать несколько сразу; всё сверено с документацией claude code на 14 октября 2026.

что такое агенты claude code простыми словами

представь, что ты сидишь с claude над проектом, и тебе нужно понять, где в коде собирается форма заявки. можно искать прямо в разговоре — тогда в контекст упадут десятки прочитанных файлов, которые потом никому не нужны. а можно отправить субагента: он сам пороется в коде в отдельном окне и вернёт три строчки «вот файл, вот функция, вот куда уходит запрос».

по документации у каждого субагента есть четыре вещи: своё окно контекста, свой системный промпт, свой доступ к инструментам и свои разрешения. claude смотрит на описание агента и, если задача подходит, делегирует её. в поиске это ещё пишут как «агент клод код» — речь о том же самом.

важная деталь: обычный субагент не видит твою переписку. claude сам пишет ему задание, коротко пересказывая, что нужно. при старте агент получает свой промпт, это задание, файлы CLAUDE.md (кроме встроенных explore и plan), снимок git status и заранее подключённые skills. твою автопамять и стиль ответов он не получает.

встроенные агенты: explore, plan, general-purpose

настраивать ничего не нужно — несколько агентов идут из коробки. ты наверняка уже видел в логе строчку с explore: это claude отправил агента искать по коду.

есть ещё служебный statusline-setup для настройки строки статуса и универсальный claude для задач, которые не подходят ни одному специалисту. explore и plan специально не читают CLAUDE.md и git status, чтобы быть быстрее и дешевле. если положить своего агента с именем Explore, он заменит встроенного.

свои агенты: где лежат файлы и какой у них формат

свой субагент — это markdown-файл с шапкой yaml. шапка задаёт настройки, а текст под ней становится системным промптом агента. полный системный промпт claude code агент не получает — только твой текст и базовые сведения об окружении.

если имена совпали, побеждает файл с более высоким приоритетом. проектных агентов удобно коммитить в репозиторий — тогда они есть у всех, кто работает с кодом.

обязательных полей два: name и description. остальные по желанию, самые полезные:

• tools — белый список инструментов; если его нет, агент наследует всё, что доступно субагентам. disallowedTools — наоборот, что убрать.
• model — sonnet, opus, haiku, fable, полный id модели или inherit (как в основном разговоре).
• permissionMode, maxTurns, effort — режим разрешений, лимит ходов и глубина размышлений.
• skills и mcpServers — какие skills загрузить сразу и какие mcp-серверы дать агенту.
• isolation: worktree — запускать агента в отдельной копии репозитория (о ней ниже), background: true — всегда в фоне.
• memory — постоянная память агента между запусками, color — цвет в списке задач.

неизвестные поля молча игнорируются, так что опечатка в названии поля ошибку не покажет — агент просто будет работать без этой настройки. claude code следит за папками агентов, и правки подхватываются за секунды без перезапуска; перезапуск нужен в редких случаях — например, когда ты создаёшь первый файл в папке agents, которой не было при старте сессии.

про команду /agents: в свежих версиях она лишь напоминает, где лежат файлы, а мастер создания был до версии 2.1.197 включительно. проще всего попросить claude: «создай субагента, который делает то-то, и сохрани в .claude/agents/» — он напишет файл сам.

пример: свой агент-ревьюер, полный файл

самый полезный первый агент — ревьюер, который смотрит свежие изменения перед коммитом и ничего не правит. вот как я бы его собрал.

шаг 1. создай папку в проекте

mkdir -p .claude/agents

шаг 2. положи файл .claude/agents/reviewer.md

---
name: reviewer
description: ревью свежих изменений перед коммитом — баги, ключи в коде, непроверенный ввод, лишние зависимости. use proactively после правок кода и когда пользователь собирается коммитить.
tools: Read, Grep, Glob, Bash
model: sonnet
color: orange
---

ты — строгий ревьюер. ты только читаешь и докладываешь, файлы не меняешь.

порядок работы:
1. запусти git diff и git diff --staged, чтобы увидеть изменения.
2. если из диффа не понятен контекст, открой изменённый файл целиком.
3. пройди по списку ниже. ничего не исправляй сам и не запускай команды, которые меняют файлы.

что ищешь:
- явные баги: опечатки в именах, необработанные ошибки, забытый await
- секреты: ключи api, токены, пароли, файл .env в коммите
- ввод пользователя без проверки: формы, query-параметры, загрузка файлов
- лишние зависимости и мёртвый код
- для страниц сайта: битые ссылки, пустые title и description, картинки без alt

формат ответа, по группам:
- критично (чинить до коммита)
- стоит поправить
- мелочи

у каждого пункта: файл и строка, что не так, как исправить в одну-две строки.
если всё чисто — скажи об этом одной фразой.

почему так. в tools нет Edit и Write, поэтому агент не перепишет код, пока ревьюит. Bash нужен ради git diff, но честно: через bash файл изменить всё-таки можно, поэтому запрет продублирован в промпте. если нужна жёсткая гарантия, документация показывает, как повесить хук PreToolUse, который проверяет каждую команду перед запуском. фраза «use proactively» в описании подталкивает claude вызывать ревьюера самому.

шаг 3. вызови агента

есть три способа, от мягкого к жёсткому. первый — просто попросить словами, и claude, скорее всего, делегирует:

используй субагента reviewer и проверь мои последние изменения

второй — упомянуть через @: набери собаку и выбери агента из списка. так он гарантированно запустится:

@"reviewer (agent)" глянь правки в форме заявки

третий — запустить всю сессию от лица агента, с его инструментами и моделью:

claude --agent reviewer

шаг 4. проверь и подкрути описание

поправь пару строк, попроси «проверь перед коммитом» и посмотри, позовёт ли claude ревьюера сам. если нет — дело почти всегда в description: в нём должно быть ясно, когда этот агент нужен и чем он отличается от остальных.

параллельная работа: несколько агентов, фон и worktree

несколько субагентов можно запустить разом, если пути исследования не зависят друг от друга. claude соберёт их выводы в одну сводку:

изучи модули авторизации, базы данных и api параллельно, отдельными субагентами

по умолчанию одновременно работают до 20 субагентов, число меняет переменная CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS. в обычной интерактивной сессии субагенты по умолчанию уходят в фон, а ты продолжаешь работать. если фоновому агенту нужно разрешение, запрос всплывает в основной сессии с его именем. уже запущенную задачу отправляет в фон ctrl+b, а команда /tasks показывает всё, что крутится в фоне.

главная проблема параллели — два агента правят одни и те же файлы и затирают друг друга. для этого есть worktree: отдельная рабочая папка со своей веткой и общей историей git. попроси claude «use worktrees for your agents» или добавь агенту в шапку isolation: worktree. каждый получит временную копию репозитория, а если ничего не поменял, копия удалится сама.

подвох, о котором мало кто пишет: такая копия по умолчанию ответвляется от основной ветки репозитория, обычно main, а не от того, что у тебя сейчас открыто. если агенту нужна твоя текущая ветка, поставь в настройках worktree.baseRef в "head". а файлов, которых нет в коммитах, там не будет в любом случае: копия — это свежий checkout.

кроме субагентов, документация описывает ещё несколько способов работать параллельно:

для своих worktree добавь .claude/worktrees/ в .gitignore, а файлы вроде .env перечисли в .worktreeinclude в корне проекта — тогда они будут копироваться в каждую новую копию.

когда агенты claude code реально помогают

документация формулирует критерий просто: субагент нужен, когда задача даёт много вывода, который не нужен в основном разговоре, когда нужно ограничить инструменты и когда работа самостоятельная и сводится к короткому итогу. на практике это вот что:

• поиск по большому коду. explore читает десятки файлов у себя, а тебе возвращает ответ. основной контекст остаётся чистым, и claude дольше не теряет нить.
• ревью. у агента свежий контекст без твоих рассуждений, поэтому он смотрит на дифф как сторонний человек. в документации есть пример ревью, разделённого на линзы: один агент смотрит безопасность, второй производительность, третий тесты.
• шумные операции. прогон тестов, разбор логов, чтение документации: «прогони тесты и верни только упавшие с текстом ошибок».
• независимые задачи. исследовать три модуля, проверить три гипотезы о баге — всё, что не ждёт друг друга.
• дешёвая модель на простую работу. агенту для поиска или сводки можно поставить model: haiku, и такая работа стоит меньше.

я делаю сайты, ботов и seo через claude code, и правило у меня одно: агенту отдаю то, результат чего могу проверить по короткому отчёту. если чтобы проверить, надо перечитать всё, что он делал, — выгоды нет.

когда агенты только жгут лимиты и токены

тут честно. у каждого субагента своё окно контекста, и его запросы списываются из тех же лимитов, что и основной разговор. пять агентов — это пять параллельных расходов, а не один. плюс их ответы возвращаются в основной контекст, и много подробных отчётов съедают его не хуже, чем сам поиск.

• мелкие точечные правки. поменять текст кнопки, поправить отступ — быстрее в основном чате. новый субагент стартует с нуля и тратит время, чтобы собрать контекст.
• связанные изменения. если план, код и тесты опираются на один и тот же контекст, дробить их по агентам — значит каждый раз заново объяснять одно и то же.
• частые уточнения. когда ты итеративно доводишь вёрстку «чуть левее, чуть темнее», нужен один собеседник, а не цепочка поручений.
• правки в одних файлах. два агента в одном файле затирают друг друга, если не развести их по worktree или по разным файлам.
• agent teams на рутине. по документации команда в режиме планирования тратит примерно в 7 раз больше токенов, чем обычная сессия. на рутинные задачи одна сессия выгоднее.

если нужно спросить что-то про уже обсуждённое, агент вообще не нужен: команда /btw видит весь твой контекст, работает без инструментов и не добавляет ответ в историю. а сколько уходит на агентов, видно в /usage: на подписке там есть разбивка расхода по skills, субагентам, плагинам и mcp-серверам.

ии агенты для программирования: claude code и не только

субагенты — это особенность claude code, но агентов, которые сами пишут и запускают код, делают и другие компании. codex cli от openai — агент, который работает локально у тебя на компьютере, его код открыт под лицензией apache-2.0, а вход — через план chatgpt или ключ api. devin от cognition описывает себя как автономного ии-инженера, который пишет, запускает и тестирует код. подробное сравнение агентов, редакторов и конструкторов я собрал в статье ии для вайбкодинга: агенты, редакторы и конструкторы.

про запрос «бесплатный ии агент для программирования»: сама программа бывает бесплатной и открытой, но модель за ней почти всегда платная — подпиской или оплатой api. claude code требует аккаунт pro, max, team, enterprise или console, бесплатный план claude.ai доступа к нему не даёт. сколько стоят тарифы — в разборе claude code подписка: сколько стоят pro, max и api.

вопросы

чем субагент отличается от skill?

skill — сохранённая инструкция, которая работает в контексте основного разговора. субагент работает в своём контексте и возвращает итог. если нужен повторяемый порядок действий без изоляции, бери skill — как его написать, есть в статье claude code skills: что такое skills и как написать свой.

можно ли дать агенту свой разговор целиком?

да, это форк: субагент, который наследует весь разговор, а не стартует с нуля. запускается командой /subtask. форки делят кэш промпта с родителем, поэтому стоят меньше свежего агента, если им нужен тот же контекст.

как продолжить работу агента, а не начинать заново?

попроси claude продолжить с тем же агентом — он отправит ему сообщение, и агент вернётся со всей своей историей. explore и plan одноразовые, их продолжить нельзя.

может ли субагент сам запускать субагентов?

может: по умолчанию до трёх уровней вложенности ниже основного разговора. глубину задаёт CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH, значение 1 отключает вложенность.

источники

• create custom subagents — документация claude code
• run agents in parallel — документация claude code
• run parallel sessions with worktrees — документация claude code
• orchestrate teams of claude code sessions — документация claude code
• manage costs effectively — документация claude code
• advanced setup — документация claude code
• openai/codex — github
• devin docs — cognition