К содержанию
Все статьи

Субагенты в Claude Code: как раздать работу

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

🧑‍💻Сергей Шульман 8 мин чтения

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

Коротко:

  • Субагент — отдельный помощник со своим контекстом, своими инструментами и, при желании, своей моделью. Он делает задачу и возвращает главному агенту короткий итог.
  • Встроенные субагенты: Explore (быстрый поиск по коду, только чтение), Plan (сбор контекста для плана) и general-purpose (сложные задачи с правками).
  • Свой субагент — Markdown-файл в .claude/agents/. Обязательны только имя и описание.
  • Фоновые сессии (claude --bg, экран claude agents) и задачи по расписанию (облачные, десктопные, /loop) позволяют агентам работать без вас.
  • Каждый агент расходует свои токены из того же лимита. Параллелить стоит независимые задачи, а не всё подряд.

Субагенты простыми словами

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

Аналогия с компанией. Руководитель не читает сам все 300 договоров, чтобы найти пункт про штрафы. Он поручает это юристу, а получает короткую справку. Голова руководителя остаётся свободной для решений.

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

Что дают субагенты по документации:

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

Встроенные субагенты

В Claude Code уже есть несколько субагентов, которых Claude вызывает сам:

СубагентЧто делаетМожет менять файлы
ExploreБыстрый поиск и анализ кода, с уровнем тщательности от быстрого до очень подробногоНет
PlanСобирает контекст в режиме плана, прежде чем предложить планНет
general-purposeСложные многошаговые задачи, где нужно и изучить, и изменитьДа

Обычно о них не нужно думать: вы ставите задачу, а Claude решает, когда отправить разведчика Explore, чтобы не читать весь проект самому.

Как создать своего субагента

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

---
name: code-reviewer
description: Reviews code for quality and best practices
tools: Read, Glob, Grep
model: sonnet
---

You are a code reviewer. When invoked, analyze the code and provide
specific, actionable feedback on quality, security, and best practices.

Обязательны только name и description. В tools перечисляют разрешённые инструменты (здесь только чтение и поиск), в model — модель: sonnet, opus, haiku, fable, полный ID модели или inherit, то есть та же, что в основном разговоре. По умолчанию субагент работает на той же модели, что и разговор, который его запустил.

Где хранить:

ГдеДля кого
.claude/agents/Текущий проект, можно хранить в git для всей команды
~/.claude/agents/Вы, во всех проектах
Папка agents/ плагинаТам, где плагин включён
Managed settingsВся организация, самый высокий приоритет

Для бизнеса это удобный способ закрепить роли. Условный пример: субагент «редактор» проверяет тексты на соответствие тону компании и запрещённым формулировкам, у него только чтение. Субагент «аналитик» готовит сводки по выгрузкам. Каждый — отдельный файл, который команда правит сама.

Фоновые агенты и параллельная работа

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

Следующий уровень — фоновые сессии. Это полноценные разговоры с Claude Code, которые работают без открытого терминала. Все они видны на одном экране:

claude agents

Запустить задачу в фоне прямо из командной строки:

claude --bg "investigate the flaky SettingsChangeDetector test"

Уже открытую сессию можно отправить в фон командой /bg. На экране агентов видно, кто работает, кто ждёт вашего ответа, кто закончил. Ответить можно, не открывая сессию целиком.

Важная деталь: фоновые сессии по умолчанию работают в отдельных копиях репозитория (git worktree), чтобы параллельные агенты не правили одни и те же файлы. Функция пока в статусе research preview, интерфейс может меняться.

Задачи по расписанию

Третий способ раздать работу — поручить её на время. В Claude Code три варианта:

ОблачныеДесктопные/loop
Где выполняютсяВ облакеНа вашем компьютереНа вашем компьютере
Нужен включённый компьютерНетДаДа
Нужна открытая сессияНетНетДа
Доступ к локальным файламНет, свежая копия репозиторияДаДа
Минимальный интервал1 час1 минута, если задаёт Claude; 1 час в формах1 минута

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

/loop 5m check if the deployment finished and tell me what happened

Повторяющиеся задачи /loop автоматически истекают через 7 дней, чтобы забытый цикл не работал вечно.

Условные бизнес-примеры: каждое утро сводка по новым заявкам и зависшим сделкам; раз в неделю проверка сайта на битые ссылки и ошибки; ежедневная сверка остатков с выгрузкой. Важно помнить: задача в сессии отправляет весь контекст при каждом запуске и тратит лимит, даже когда вы не за компьютером.

Когда параллельные агенты окупаются, а когда нет

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

Окупается:

  • Независимые задачи: три разных раздела сайта, три отчёта из разных источников.
  • Объёмная «грязная» работа: прогон тестов, разбор логов, чтение документации. Субагент переварит, вернёт суть, основной контекст останется чистым.
  • Исследование: несколько вариантов решения параллельно, потом выбор лучшего.
  • Простые массовые задачи на дешёвой модели: model: haiku в настройках субагента.

Не окупается:

  • Задачи, где каждый шаг зависит от предыдущего. Агенты будут ждать друг друга.
  • Мелкие задачи на пару минут. Расходы на запуск и передачу контекста больше выгоды.
  • Ситуации, где агенты правят одни и те же файлы без изоляции.

Ещё есть «команды агентов» (agent teams), где несколько экземпляров Claude Code координируются между собой. Они экспериментальные и выключены по умолчанию, а документация оценивает расход примерно в 7 раз выше обычной сессии, когда участники работают в режиме плана. Для большинства бизнес-задач хватает обычных субагентов.

Агенты как команда: аналогия, которая помогает

Когда я учу команды работать с агентами, лучше всего заходит аналогия с отделом:

В компанииВ Claude Code
Руководитель, который ставит задачи и принимает результатГлавная сессия и вы
Должностная инструкцияСистемный промпт субагента
Доступы сотрудникаПоле tools и разрешения
Стажёр на простых задачах, опытный — на сложныхВыбор модели: haiku для простого, opus или fable для сложного
Регламент «каждое утро сдать отчёт»Задача по расписанию
Отдельный рабочий стол, чтобы не мешать друг другуИзоляция фоновых сессий в worktree

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

Агенты в других инструментах

Логика субагентов есть и у альтернатив:

  • OpenCode: встроенные агенты build (полный доступ), plan (только чтение) и субагент general.
  • Kimi Code: субагенты coder, explore и plan.
  • DeepSeek Harness: фоновые задачи с отслеживанием прогресса и задачи по расписанию.

Поэтому роли и инструкции агентов я описываю так, чтобы их можно было перенести. Обзор вариантов — в статье Аналоги Claude Code, которые работают в России.

Доступ из России

Anthropic официально не обслуживает Россию — ни приложения, ни API, ни компании, которые базируются в России. Команды Claude Code из этой статьи — для команд с легальным доступом. Подход с ролями, фоновыми задачами и расписанием переносится на OpenCode, Kimi Code и DeepSeek Harness с легально доступными моделями. Подробнее — в статье Когда режут VPN: на чём работать с ИИ-агентами в России.

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

Чем субагент отличается от обычной сессии Claude Code? Субагент работает в своём контексте внутри вашей сессии и возвращает главному агенту короткий итог. Фоновая сессия — полноценный отдельный разговор, который работает без терминала.

Сколько субагентов можно запустить одновременно? По документации, по умолчанию до 20 в одной сессии. Но каждый расходует токены из того же лимита, поэтому больше — не значит лучше.

Можно ли запустить агента по расписанию, если компьютер выключен? Да, облачные задачи по расписанию работают без вашего компьютера. Десктопные и /loop требуют, чтобы компьютер был включён.

Как сэкономить на субагентах? Отдавать простые задачи модели haiku, держать описания субагентов короткими и не параллелить зависимые задачи.

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


Хотите, чтобы рутину в компании делали агенты по расписанию, а люди принимали результат? Я настраиваю Claude Code или альтернативу, описываю роли агентов под ваши процессы и учу команду ими управлять. Напишите в Telegram, какую работу хотите раздать.

Похожие статьи: MCP: как подключить к ИИ-агенту CRM, базы и сервисы · Скиллы и плагины Claude Code: что это и что поставить

Читайте также

Есть похожая задача?

Разберу её бесплатно за 30 минут и предложу решение. Пишите в Telegram или звоните.