# Субагенты Claude Code: когда раздавать работу помощникам и сколько это стоит в лимитах

Субагенты Claude Code простым языком: чем помощник отличается от второго окна и скилла, когда раздавать ему работу и как не сжечь лимит подписки.

URL: https://posts.danashkin.ru/guides/subagenty-claude-code
Обновлено: 2026-11-10

---

Субагент в Claude Code - это помощник, которого запускает сам агент. Ты ставишь задачу основному чату, он режет её на куски и раздаёт их помощникам. Каждый работает в своём чистом контексте и возвращает короткую сводку. Это экономит место в главном чате и ускоряет разведку. Платишь лимитом подписки: каждый помощник тратит его так же, как основной чат.

## Коротко

**Главное**

- Субагент - помощник с чистым контекстом, которого запускает основной агент. Он видит только поручение и возвращает сводку.
- Раздавать стоит три вида работы: разведку с большим объёмом чтения, независимую проверку и однотипные куски, которые не зависят друг от друга.
- Запросы субагентов идут в тот же лимит, что и основной чат. Однажды Claude Code у меня запустил 103 помощника на одно исследование.
- Потолок ставится словами в поручении («не больше 5 субагентов») и настройками: по документации на ноябрь 2026 года по умолчанию одновременно работают до 20 субагентов, вложенность до трёх слоёв.

## Что такое субагент в Claude Code?

**Главное**

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

Разберём простым языком. Ты работаешь с [ИИ-агентом](/concepts/ai-agent) в одном чате. Он может сам открыть ещё несколько скрытых чатов, дать каждому задание и собрать ответы. Главного на занятиях я называю оркестратором, помощники и есть субагенты.

Документация Claude Code описывает их так: у каждого субагента своё контекстное окно, свой системный промпт, свои инструменты и разрешения. Он делает побочную работу, которая иначе завалила бы главный чат результатами поиска, логами и содержимым файлов, и возвращает только сводку.

В Claude Code есть встроенные субагенты, и ты их наверняка видел в работе:

- **Explore** - только чтение: ищет по файлам и разбирается в устройстве проекта, править ничего не может.
- **Plan** - собирает материал в режиме планирования, тоже без права записи.
- **General-purpose** - универсальный помощник для задач, где нужно и искать, и менять файлы.

Своего субагента можно создать, попросив об этом Claude. Он запишет файл с именем, описанием, списком инструментов и моделью. Личные субагенты лежат в `~/.claude/agents/` и работают во всех проектах, проектные - в `.claude/agents/` внутри проекта.

## Субагент, второе окно и скилл: в чём разница

**Главное**

Субагента запускает агент, второе окно открываешь ты, скилл - это записанный порядок действий, который агент выполняет в текущем чате. Скилл описывает порядок работы, субагент - отдельного исполнителя с чистой памятью.

Эти три вещи путают чаще всего. Сведу в одну таблицу:

| | Субагент | Второе окно | Скилл |
|---|---|---|---|
| Кто запускает | основной агент | ты | агент по описанию или ты командой |
| Контекст | чистый, видит только поручение | чистый, видит только твой запрос | тот же, что у текущего чата |
| Куда идёт результат | сводкой в главный чат | остаётся во втором окне, переносишь сам | в текущий чат |
| Лимит подписки | общий с основным чатом | общий | общий |
| Когда нужен | разведка, проверка, параллельные куски | отдельная задача, которую ведёшь сам | повторяемая процедура |

Второе окно ведёшь ты сам. Когда два окна правят одни и те же файлы, начинаются тихие потери правок, это разобрано в статье [два окна агента одновременно](/guides/dva-okna-agenta-odnovremenno). Субагентами дирижирует основной агент. Но правило то же: двух агентов на один файл оставлять нельзя.

Скилл живёт в текущем чате. Документация советует брать скилл, когда нужен повторяемый порядок работы в контексте основного разговора, а не в изолированном. Эти вещи сочетаются: у скилла есть настройка `context: fork`, и тогда он выполняется в субагенте. Чем скилл отличается от подключения к внешним сервисам, я разбирал в статье [скилл и MCP: в чём разница](/guides/skill-i-mcp-v-chem-raznica).

## Когда раздавать работу субагентам?

**Главное**

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

Документация Claude Code даёт простой критерий. Субагент нужен, если задача даёт много промежуточного вывода, который потом не понадобится, или если работа самостоятельная и сводится к сводке. Главный чат лучше для частого обмена репликами, быстрых правок и этапов с общим контекстом. Ещё субагент стартует с нуля, и на сбор контекста у него уходит время.

На практике у меня три сценария.

**Разведка.** Прочитать двадцать файлов, документацию или выдачу поиска и вынести три вывода. Весь шум остаётся в контексте помощника, в главный чат приходит выжимка. Это главное лекарство от разбухшего окна, о котором я писал в статье [гигиена контекстного окна](/guides/gigiena-kontekstnogo-okna).

**Однотипные куски, которые не зависят друг от друга.** План новой функции для своей платформы мониторинга я однажды отдал на критику трём субагентам сразу. Каждый получил цель, одну роль (скептик, эксперт, прагматик) и тот же план, отзывы друг друга им не передавались. Все трое одобрили подход только с условиями, безусловного «да» не дал никто. Условия ушли в план до первой строки кода.

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

**Где субагенты не помогают**

Задачи с последовательными шагами, где каждый следующий зависит от предыдущего, и правки одного файла несколькими помощниками. Документация Codex прямо советует: параллельно запускать то, что читает, и осторожнее с тем, что пишет, потому что агенты, которые правят код одновременно, создают конфликты.

## Независимая проверка: почему приёмщик не должен быть автором

**Главное**

Агент, который сделал работу, проверяет её по памяти о том, что делал, и отчитывается шире, чем сделано. Субагент без этой памяти вынужден всё запустить и прочитать заново. Поэтому он видит дыры, которых автор не замечает.

В моём рабочем регламенте это записано правилом. Закрыл фазу работы - до слова «готово» её принимает не автор. Обычную фазу принимает субагент прямо в чате автора, в своей копии проекта. Отчёт автора для него гипотеза, а не факт: он заново запускает заявленное и пишет вердикт «принимать» или «вернуть» файлом. Автор показывает этот вердикт мне дословно и снять «вернуть» сам не может.

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

Как это работает на деле. Фазу с новым каналом сбора данных в платформе мониторинга принимал субагент. Он не поверил отчёту автора, а в своей копии заново прогнал проверку типов, линтер, сборку и все тесты: 275 файлов, 3682 теста, числа сошлись с заявленными. В конструкторе счетов моей платформы для обучения два субагента-ревьюера, один на ошибки и один на безопасность, нашли три проблемы. Одна из них: два разных счёта одному человеку на одну сумму, выставленные с разницей меньше 90 секунд, склеивались в один. Все три исправлены в тот же день.

Приём переносится на любую работу. Попроси агента: «Запусти субагента-проверяющего. Дай ему только результат и требования, без своего отчёта. Пусть проверит заново и вернёт список проблем с доказательствами».

## Сколько субагенты стоят в лимитах?

**Главное**

Столько же, сколько такие же запросы основного чата. Каждый субагент шлёт свои запросы, и они идут в тот же лимит подписки поверх главного чата. Десять помощников на исследование - это десять параллельных потребителей лимита.

Документация Claude Code говорит прямо: субагент отправляет свои запросы, и они считаются в те же лимиты использования, что и основной разговор.

Теперь история из моей практики. Летом я запускал в Claude Code глубокие исследования. В одном случае агент сам запустил 103 субагента, в другом 106. Лимиты таяли на глазах. Я остановил чат и написал ему: «Ты что, столько агентов запустил? Сокращай до 10». Как методология это классно, но дороговато.

И вот тут самое интересное. По документации лимит стоит только на число субагентов, которые работают одновременно. Общего лимита на число субагентов за сессию нет. Агент может запускать новые пачки, пока не закончится задача или твоя подписка.

Отдельная осторожность с режимом ultracode. С ним Claude сам оркестрирует многошаговые процессы с множеством агентов для серьёзных задач, а лимит на одновременно работающих субагентов в таких сессиях не действует. Ученикам я так и говорю: с этим режимом работаем очень осторожно, лимит может закончиться раньше, чем решится задача. Документация про такие процессы советует то же: сначала прогнать их на маленьком куске, одной папке вместо всего проекта.

Сколько ушло на субагентов, видно в Claude Code командой `/usage`. На тарифах Pro, Max, Team и Enterprise она показывает, какая доля недавнего расхода пришлась на скиллы, субагентов, плагины и подключения. Как вообще устроены лимиты подписки, подробно в статье [сколько стоит Claude Code: подписка или API](/guides/skolko-stoit-claude-code-podpiska-vs-api).

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

**Главное**

Первый потолок - словами в поручении: сколько помощников и какую сводку вернуть. Второй - настройками Claude Code: число одновременных субагентов, глубина вложенности и более дешёвая модель для простых помощников.

1. **Назови число в поручении**

   Пиши прямо: «Раздели задачу на 3 части, запусти по одному субагенту на часть, больше не запускай. Дождись всех и сведи итог». Документация Codex описывает хорошее поручение так же: как делить работу, ждать ли всех и какую сводку вернуть.

2. **Попроси короткую сводку**

   Добавь формат: «каждый возвращает не больше 10 строк и пути к файлам». Иначе отчёты помощников раздуют главный чат.

3. **Повтори важное правило в поручении**

   Субагент не видит историю твоего чата и прочитанные файлы, он стартует с поручения, которое написал основной агент. Твой CLAUDE.md большинство субагентов загружают, а встроенные Explore и Plan пропускают. Правило вроде «папку archive не трогай» лучше повторить словами.

4. **Ограничь настройками**

   По умолчанию одновременно работают до 20 субагентов, переменная `CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS` меняет это число. Субагент может запускать своих помощников до трёх слоёв вниз; `CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH` со значением `1` выключает вложенность. Простому помощнику для поиска можно прописать в файле `model: haiku`, это дешевле.

5. **Проверь расход**

   После большой задачи открой `/usage` и посмотри долю субагентов. Если она заметная, режь число помощников или объём их сводок.

## Субагенты в Codex

**Главное**

В Codex субагенты тоже есть и включены по умолчанию. Локальный Codex раздаёт работу помощникам, когда ты просишь прямо или когда это велят правила проекта или скилл. Тратят они больше токенов, чем работа одного агента.

Справка OpenAI описывает ту же механику: Codex запускает агентов параллельно и собирает их результаты в один ответ. Шумная работа уходит из главного чата, а каждый помощник тратит свои токены.

Отличие в запуске. По справке, текущие локальные версии Codex делегируют работу, когда ты просишь прямо («запусти два агента», «по агенту на пункт») или когда об этом говорят инструкции в AGENTS.md или скилле. Потолок одновременных помощников задаётся настройкой `agents.max_concurrent_threads_per_session`. Если выбираешь между двумя агентами целиком, сравнение в статье [Claude Code или Codex: что выбрать](/guides/claude-code-ili-codex-chto-vybrat).

Если хочешь пройти это на своих задачах, на [обучении работе с ИИ-агентами](https://danashkin.ru/agents/) я разбираю изнутри инструменты, которые собрал в агенте сам, и то, как они проверяются. В занятии про первый код работаем по циклу: агент предлагает план, ты критикуешь, он пишет, проверяем.

## Частые вопросы

**Главное**

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

### Частые вопросы

**Нужно ли создавать своих субагентов?**

Для начала нет. Встроенные Explore, Plan и general-purpose закрывают разведку и большинство задач. Своего стоит завести, когда ты третий раз даёшь помощнику одну и ту же инструкцию, например проверяющему тексты или договоры.

**Как понять, что агент запустил субагентов?**

В чате появляется строка вызова с именем помощника и коротким описанием задачи. Если их подозрительно много, останови чат и попроси сократить число, как я сделал на тех 103.

**Субагент может испортить файлы?**

Может, если у него есть право записи. Explore и Plan только читают. Своему проверяющему не давай права править проверяемые файлы: его задача найти проблему, чинить будет автор.

**Чем субагенты отличаются от команды агентов?**

Субагенты работают внутри одной сессии и отчитываются основному чату. Команда агентов в Claude Code - это несколько отдельных экземпляров со своими окнами, по документации она по умолчанию выключена. Общая теория ролей и схем - в статье [мультиагентные системы](/guides/multiagentnye-sistemy).

## Главный вывод

**Главное**

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

Самая недооценённая роль субагента - проверяющий, который не помнит, как делалась работа. Самая дорогая ошибка - отдать агенту исследование без числа помощников.

Практический шаг на сегодня: в следующей большой задаче допиши к запросу одну строку - «не больше 3 субагентов, каждый возвращает до 10 строк». После задачи загляни в `/usage`.

Какую работу ты отдашь субагенту первой: разведку или проверку?

### Источники

- [Create custom subagents - что такое субагенты, встроенные Explore и Plan, лимит одновременных субагентов, вложенность и контекст, документация Claude Code](https://code.claude.com/docs/en/sub-agents)
- [Manage costs effectively - лимиты подписки, доля субагентов в /usage, почему расход растёт, документация Claude Code](https://code.claude.com/docs/en/costs)
- [Model configuration - уровни усилий и режим ultracode, документация Claude Code](https://code.claude.com/docs/en/model-config)
- [Orchestrate subagents at scale with dynamic workflows - стоимость многоагентных процессов и предупреждение о больших запусках, документация Claude Code](https://code.claude.com/docs/en/workflows)
- [Subagents, ChatGPT Learn - субагенты в Codex: когда запускаются, расход токенов, настройки, справка OpenAI](https://learn.chatgpt.com/docs/agent-configuration/subagents)
