# Agent Teams в Claude Code: как устроены команды агентов изнутри

> 3–5 независимых агентов работают над одной задачей, переписываются и делят задачи. Как включить, чем отличается от суб-агентов и когда это оправдано.

Источник: https://blog.uspeshnyy.ru/blog/agent-teams-claude-code/
Автор: Александр Успешный · blog.uspeshnyy.ru
Опубликовано: 2026-03-02
Теги: Claude, AI-агенты

---

[Claude Code](/blog/claude-code-rukovodstvo-inzhenera/) получил крупное обновление агентной системы — **Agent Teams**. Это не косметическая итерация старой модели «задача + суб-агент», а принципиально другая модель исполнения: 3–5 независимых инстансов Claude Code работают над одним проектом, делят контекст, обмениваются сообщениями и координируются через общий список задач.

<video class="media-embed media-embed-portrait" data-loop-src="/videos/agent-teams-claude-code-video.mp4" poster="/images/posts/agent-teams-claude-code-video-poster.webp" data-title="Agent Teams — за минуту" data-sound muted loop playsinline controls preload="none" aria-label="Ролик: чем команда агентов в Claude Code отличается от суб-агентов — общий список задач, сообщения и спор"></video>

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

**Старая модель (суб-агенты):** главный агент вызывает инструмент Task → поднимается суб-агент → работает в изоляции → сессия завершается → главному возвращается только краткое резюме. Никакого общения по ходу работы.

**Новая модель (Agent Teams):** общий список задач, обмен сообщениями между агентами и явное управление жизненным циклом (запуск и остановка участников).

![Суб-агент против команды агентов](/images/posts/agent-teams-vs-subagents-ru.webp)

## Как включить

1. Обновите Claude Code до последней версии.
2. Agent Teams пока за экспериментальным флагом — добавьте его в глобальный `settings.json` и перезапустите терминал.
3. Команда создаётся, когда промпт **явно просит** собрать команду:

> «Проектирую CLI-инструмент для отслеживания TODO-комментариев. Собери команду агентов и посмотри на задачу с разных сторон: один отвечает за UX, второй — за архитектуру, третий играет адвоката дьявола».

Лучший способ наблюдать за командой — многопанельный терминал (tmux или iTerm2 с включённым Python API): отдельная панель у тим-лида и у каждого агента. Можно кликнуть в любую панель, смотреть работу агента вживую и даже писать ему напрямую.

## Пять внутренних инструментов

Автор вытащил из логов механику целиком:

1. **TeamCreate** — создаёт папку команды в `.claude/teams/`. Пока это только каркас, агентов ещё нет.
2. **TaskCreate** — создаёт задачи (JSON-файлы в `.claude/tasks/<team-id>`): ID, описание, статус, владелец, зависимости (`blocks` / `blocked_by`). Задачи раздаёт тим-лид сверху вниз, либо агенты **сами разбирают их** из общего списка.
3. **Task** — тот же инструмент, что поднимал суб-агентов, но с новыми параметрами `name` и `team_name`: с ними вместо изолированного суб-процесса запускается участник команды.
4. **taskUpdate** — агент отмечает: взял задачу, работает, закончил.
5. **sendMessage** — личные сообщения агент→агент и broadcast на всю команду. Под капотом сообщения пишутся в `inbox/` каждого агента и подмешиваются в его диалог как новые реплики. Остановка тоже через сообщения: тим-лид шлёт `shutdown_request`, агент подтверждает.

## Когда команды лучше суб-агентов

Показательный пример из официальной документации — глубокая отладка:

> «Пользователи жалуются, что приложение закрывается после одного сообщения. Подними 5 агентов с разными гипотезами. Пусть они спорят и опровергают теории друг друга, как в научном дебате. Зафиксируй консенсус в документе».

Суб-агенты такое не умеют в принципе: они не видят друг друга. Команда — умеет, и автор подтверждает, что на реальном проекте это сработало отлично.

Трейдофф честный: **заметно больше токенов и времени**. Поэтому команды не заменяют суб-агентов: для простых параллельных задач изоляции по-прежнему достаточно, команды — для задач, где нужен спор, обмен находками и общий контекст.

Где команда агентов оправдана, а где хватит одного агента или простой цепочки шагов, — в разборе [шести паттернов оркестрации](/blog/patterny-orkestracii-ai-agentov/): там есть и данные о том, сколько токенов тратят системы из многих агентов.

## Что здесь важно, если вы не разработчик

От себя. Посмотрите на паттерн, а не на код: несколько специализированных «сотрудников» с разными ролями, общим списком задач и правом спорить друг с другом — это модель любого сильного отдела, включая маркетинговый. Именно так я собираю [AI-системы](/blog/ai-kompaniya-na-openclaw/) клиентам: агент-квалификатор, агент-контентщик и аналитика не работают в вакууме — они обмениваются данными, и решения рождаются из их «спора». Инфраструктура для этого, как видите, уже становится штатной функцией инструментов.

> Хотите такую «команду» под ваш маркетинг? Напишите «система» в [Telegram](https://t.me/uspeshnyy) — за 15 минут разберём, какие роли нужны именно вам.