Дмитрий Анашкин

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

Опубликовано 10 нояб. 2026 г.10 мин чтенияНачальный
Субагенты Claude Code: когда раздавать работу помощникам и сколько это стоит в лимитах
Туториал
Субагенты Claude Code
Дмитрий Анашкин · 10 мин
Чему вы научитесь
  • Чем субагент отличается от второго окна и от скилла
  • Три вида работы, которые стоит раздавать субагентам
  • Как ограничить число помощников и проверить их расход в /usage
Начальный
1просмотров

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

Коротко

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

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

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

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

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

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

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

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

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

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

Скилл живёт в текущем чате. Документация советует брать скилл, когда нужен повторяемый порядок работы в контексте основного разговора, а не в изолированном. Эти вещи сочетаются: у скилла есть настройка context: fork, и тогда он выполняется в субагенте. Чем скилл отличается от подключения к внешним сервисам, я разбирал в статье скилл и MCP: в чём разница.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Сколько ушло на субагентов, видно в Claude Code командой /usage. На тарифах Pro, Max, Team и Enterprise она показывает, какая доля недавнего расхода пришлась на скиллы, субагентов, плагины и подключения. Как вообще устроены лимиты подписки, подробно в статье сколько стоит Claude Code: подписка или API.

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

  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

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

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

Если хочешь пройти это на своих задачах, на обучении работе с ИИ-агентами я разбираю изнутри инструменты, которые собрал в агенте сам, и то, как они проверяются. В занятии про первый код работаем по циклу: агент предлагает план, ты критикуешь, он пишет, проверяем.

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

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

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

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

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

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

Источники

Отправь другу или себе в избранное в Telegram, чтобы не потерять.

Поделиться в Telegram
Было полезно?
Автор
Дмитрий Анашкин
Практик-интегратор ИИ в бизнес

Основатель NeuroDA и SMAIPL. Корпоративные воркшопы по ИИ, внедрение AI в бизнес-процессы.

Похожие гайды

Альтернативы Claude Code в 2026: OpenCode, Qwen Code и GigaCode - в чём уступают и когда хватает

С 12 ноября 2026 года Anthropic отдельно прописал правило для компаний из неподдерживаемых регионов и их сотрудников. Сравниваю три альтернативы Claude Code: модель, куда уходят данные, лицензия, что проверить. Показываю, когда замены хватает и как проверить её за вечер на своей задаче.

12 мин

Мультиагентные системы: как несколько ИИ работают над одной задачей

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

12 мин

Замена ИИ-модели: как проверить её на своих задачах до перехода

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

9 мин

Мониторинг задач по расписанию: как поймать сбой, если скрипт молчит

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

8 мин

Связанные понятия