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

Агенты 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: что это и что поставить