> ## Content Index
> Fetch the complete content index at: https://matveev.tech/llms.txt
> Use this file to discover other available public pages before exploring further.

# Agent Teams в Claude Code: как запустить команду AI-агентов
- URL: https://matveev.tech/claude-code-agent-teams-instrukciya/
- Published: 2026-02-06T09:45:29.000Z
- Updated: 2026-02-15T10:43:49.000Z
- Description: Пошаговая инструкция по настройке Agent Teams в Claude Code. Несколько AI-агентов работают параллельно, общаются между собой и координируют задачи через общий список.
- Author: Pavel Matveev
- Tags: Claude Code, AI, Claude, Разработка, Агенты, Гайд

> **TL;DR:** В Claude Code появились Agent Teams — можно запустить несколько AI-агентов, которые работают параллельно, обмениваются сообщениями и координируют задачи через общий список. Один агент выступает лидером, остальные работают самостоятельно. Фича экспериментальная, но уже рабочая.

Помнишь, я писал про [TeammateTool](https://matveev.tech/claude-code-multi-agent-teammatetool/) — скрытую мультиагентную систему, которую нашли в бинарнике Claude Code? Так вот, Anthropic её официально выкатили. Называется Agent Teams, и это уже не просто подагенты, которые выполняют одну задачу и возвращают результат. Тут агенты реально общаются друг с другом, спорят и сами разбирают задачи.

Я поковырялся с этим и собрал инструкцию — как включить, запустить и не потерять кучу токенов впустую.

## Когда это нужно (а когда нет)

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

А вот где команды агентов реально полезны:

- Код-ревью с разных сторон — один смотрит на безопасность, другой на перформанс, третий проверяет тесты
- Дебаг с конкурирующими гипотезами — агенты параллельно проверяют разные теории и спорят между собой
- Разработка новых модулей — каждый агент пилит свой кусок, не мешая остальным
- Кросс-слойные изменения — фронт, бэк и тесты разнесены по разным агентам

## Чем отличается от подагентов

Подагенты (субагенты) — это рабочие, которые выполнили задачу и вернули результат. Всё общение идёт через главного агента.

Agent Teams — это полноценная команда. У каждого агента свой контекст, они переписываются напрямую друг с другом, есть общий список задач. Лидер координирует, но не является единственным каналом связи.

Если нужно быстро получить ответ и забыть — подагенты. Если задача требует обсуждения, взаимной проверки или параллельной работы над разными частями — Agent Teams.

## Включение

Фича экспериментальная и выключена по умолчанию. Чтобы включить, добавь переменную окружения в `settings.json`:

```json
{
  "env": {
    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
  }
}
```

Или можно задать переменную прямо в шелле перед запуском Claude Code.

## Запуск команды

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

Пример промпта:

```plaintext
Создай команду агентов для ревью PR #142. Три ревьюера:
- один проверяет безопасность
- один смотрит на производительность
- один валидирует тестовое покрытие
Пусть проверят и соберут результаты.
```

Claude создаст команду, раздаст задачи и начнёт координировать работу.

Можно и попроще:

```plaintext
Я проектирую CLI-тул для трекинга TODO-комментариев в коде.
Создай команду агентов: один на UX, один на архитектуру,
один играет роль devil's advocate.
```

## Режимы отображения

Два варианта:

**In-process** — все агенты работают в одном терминале. Переключаешься между ними через `Shift+Up/Down`. Работает везде, ничего дополнительно ставить не надо.

**Split panes** — каждый агент в своей панели. Видишь всех одновременно, кликаешь в панель для прямого взаимодействия. Нужен tmux или iTerm2.

> Для iTerm2 надо установить [it2 CLI](https://github.com/mkusaka/it2?ref=matveev.tech), затем включить Python API в **iTerm2 → Settings → General → Magic → Enable Python API**.

По умолчанию стоит `auto` — если ты уже внутри tmux, будет split panes, иначе in-process. Можно переключить:

```json
{
  "teammateMode": "in-process"
}
```

Или для одной сессии:

```bash
claude --teammate-mode in-process
```

## Управление командой

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

### Прямое общение с агентами

В режиме in-process — `Shift+Up/Down` для выбора агента, потом просто пишешь. `Enter` — просмотр сессии агента, `Escape` — прервать текущий ход. `Ctrl+T` — показать список задач.

В split panes — кликни в панель нужного агента.

### Задачи и координация

У команды общий список задач с тремя статусами: pending, in progress, completed. Задачи могут зависеть друг от друга — заблокированная задача не будет взята в работу, пока зависимости не закроются.

Лидер может назначать задачи конкретному агенту, а агенты могут сами подбирать незанятые задачи из списка.

### Режим делегирования

Иногда лидер начинает сам писать код вместо того, чтобы ждать агентов. Чтобы этого избежать, нажми `Shift+Tab` — включится delegate mode. Лидер сможет только координировать: создавать агентов, писать сообщения, управлять задачами. Без прямого доступа к коду.

### Требование плана перед работой

Для сложных задач можно потребовать, чтобы агент сначала составил план:

```plaintext
Запусти агента-архитектора для рефакторинга модуля авторизации.
Потребуй утверждение плана до начала изменений.
```

Агент будет работать в read-only режиме, пока лидер не одобрит план. Если план отклонён — агент получает фидбэк и переделывает.

## Как это устроено внутри

Команда состоит из четырёх компонентов:

- **Лидер** — основная сессия, которая создаёт команду и координирует
- **Агенты** — отдельные инстансы Claude Code, каждый со своим контекстом
- **Список задач** — общий для всей команды
- **Почтовый ящик** — система обмена сообщениями между агентами

Данные хранятся локально: - Конфиг команды: `~/.claude/teams/{team-name}/config.json`\- Задачи: `~/.claude/tasks/{team-name}/`

Каждый агент при запуске получает тот же проектный контекст, что и обычная сессия — CLAUDE.md, MCP-серверы, скиллы. Но история разговора лидера не передаётся. Поэтому важно давать агентам достаточно контекста в промпте при создании.

## Ограничения

Фича экспериментальная, и ограничения пока серьёзные:

- `/resume` и `/rewind` не восстанавливают in-process агентов. После возобновления сессии лидер может пытаться писать агентам, которых уже нет
- Агенты иногда забывают отметить задачу как выполненную, что блокирует зависимые задачи
- Завершение работы агента может быть медленным — он дожидается окончания текущей операции
- Одна команда на сессию. Нужно очистить текущую перед созданием новой
- Агенты не могут создавать свои команды (нет вложенных команд)
- Лидер фиксирован на всю жизнь команды
- Split panes не работают в VS Code terminal, Windows Terminal и Ghostty

## Что ещё почитать

- [В Claude Code нашли мультиагентную систему — TeammateTool](https://matveev.tech/claude-code-multi-agent-teammatetool/) — предыстория Agent Teams, когда фичу нашли в бинарнике
- [Oh My Claude Code: мультиагентная система для тех, кому лень настраивать Claude Code](https://matveev.tech/oh-my-claudecode-multi-agent/) — альтернативный подход к мультиагентности через плагин
- [Claude Superpowers — плагин для Claude Code](https://matveev.tech/claude-superpowers-plugin/) — ещё один способ расширить возможности Claude Code
- [MCP серверы для Claude — что это и как настроить](https://matveev.tech/claude-mcp-nastrojka/) — если хочешь, чтобы агенты работали с внешними сервисами