Примечание автора: Пошаговое руководство по включению и использованию функции многоагентного взаимодействия Claude 4.6 Agent Teams. Освойте архитектуру Lead + Teammate, распределение задач, обмен сообщениями и практические приемы работы.
Вместе с релизом Claude Opus 4.6 была представлена функция Agent Teams (команды агентов), которая позволяет нескольким экземплярам Claude работать параллельно, как настоящая команда разработчиков. Многим разработчикам интересно: как включить Agent Teams? Как активировать эту функцию? Чем она отличается от обычных субагентов (Subagents) и для каких сценариев подходит?
Основная ценность: Прочитав эту статью, вы полностью освоите рабочий процесс Agent Teams — от настройки и активации до распределения задач и командного взаимодействия, что позволит вам сразу приступить к многоагентному программированию.
Что такое Claude Agent Teams
Agent Teams — это экспериментальная функция Claude Code (на стадии исследовательского превью), которая позволяет запускать несколько независимых экземпляров Claude Code в рамках одного проекта. Они взаимодействуют друг с другом через общую систему задач и сообщений.
Если вкратце: Agent Teams = один Lead (руководитель команды) + несколько Teammates (участников), которые работают автономно, общаются между собой и совместно решают сложные задачи.
| Параметр сравнения | Subagent (субагент) | Agent Teams (команда) |
|---|---|---|
| Способ связи | Отчитывается только основному агенту | Участники могут общаться напрямую |
| Координация | Основной агент управляет всем | Общий список задач + самостоятельный выбор |
| Контекст | Изолированный контекст, возврат результата | Изолированный контекст, полная автономия |
| Лучший сценарий | Узкие задачи, где нужен только результат | Сложные задачи, требующие обсуждения и сотрудничества |
| Расход токенов | Низкий (результат возвращается в основной контекст) | Высокий (каждый участник — отдельный экземпляр Claude) |
Основная архитектура Claude Agent Teams
Agent Teams состоит из 4 ключевых компонентов:
| Компонент | Обязанности | Описание |
|---|---|---|
| Lead Agent | Руководитель команды | Ваша основная сессия Claude Code. Отвечает за создание команды, распределение задач и сбор итогов. |
| Teammate | Участник команды | Независимые экземпляры Claude Code, каждый из которых выполняет свою задачу. |
| Task List | Общий список задач | Канбан-доска, видимая всем участникам. Поддерживает выбор задач, зависимости и отслеживание статуса. |
| Mailbox | Система сообщений | Канал связи между участниками. Поддерживает личные сообщения и рассылки. |
💡 Ключевое отличие: Субагент работает по модели «подчиненный — начальник», а Agent Teams — по модели «командное взаимодействие». Если ваша задача требует обсуждения, проверки разных точек зрения или параллельной работы над разными модулями, Agent Teams будет лучшим выбором.
Как включить Claude Agent Teams
Функция Agent Teams по умолчанию выключена, её нужно активировать вручную. Вот 3 способа это сделать:
Шаг 1: Включение экспериментальной функции
Способ А — Файл конфигурации (рекомендуется)
Добавьте в settings.json для Claude Code следующее:
{
"env": {
"CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
}
}
Способ Б — Переменные окружения
# Добавьте в .bashrc или .zshrc
export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1
Способ В — Разовая сессия
CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 claude
Шаг 2: Запуск Agent Teams обычными словами
Команды через слэш вроде /agent-teams не существует. После включения функции вам достаточно просто описать нужную команду на естественном языке:
Создай команду агентов для ревью PR #142. Сгенерируй трех проверяющих:
- один ищет уязвимости в безопасности
- второй проверяет влияние на производительность
- третий проверяет покрытие тестами
Пусть каждый проведет ревью и отчитается о результатах.
Или еще проще:
Create a team with 4 teammates to refactor these modules in parallel.
Use Sonnet for each teammate.
Claude автоматически создаст команду, сгенерирует «коллег» и распределит задачи. Claude также может сам предложить создать команду, если решит, что ваша задача подходит для параллельного выполнения, но сначала он спросит ваше подтверждение.
Шаг 3: Выбор режима отображения
| Режим отображения | Описание | Где подходит |
|---|---|---|
| in-process (по умолчанию) | Все коллеги работают в основном терминале | Любой терминал, включая VS Code |
| tmux | Каждый коллега в отдельной панели | Требуется tmux или iTerm2 |
| auto | Автоматический выбор | Если запущен tmux — разделит экран, иначе — in-process |
# Указать в командной строке
claude --teammate-mode tmux
# Или задать в settings.json
{
"teammateMode": "tmux"
}
Совет: Для первого раза рекомендуем использовать режим
in-process. Когда освоитесь, попробуйте режим разделения экрана вtmux. Получить лимиты для Claude API можно через APIYI (apiyi.com), чтобы полноценно протестировать разные конфигурации Agent Teams локально.
Руководство по работе с Claude Agent Teams
Шпаргалка по горячим клавишам
Во время работы Agent Teams вы можете использовать следующие сочетания клавиш:
| Сочетание клавиш | Функция |
|---|---|
| Shift+Up/Down | Переключение/выбор участника команды |
| Enter | Просмотр деталей сессии выбранного участника |
| Escape | Прервать текущую операцию участника |
| Ctrl+T | Переключить вид списка задач |
| Shift+Tab | Переключить режим делегирования (Lead только координирует, не пишет код) |
Механизм распределения и захвата задач
Система задач в Agent Teams поддерживает 3 статуса и зависимости:
Статусы задач: pending (ожидает) → in_progress (в процессе) → completed (завершено)
Механизм зависимостей: Для задач можно установить зависимость blockedBy. Как только блокирующая задача завершается, последующая задача разблокируется автоматически, ручное вмешательство не требуется.
Способы назначения:
- Назначение лидером (Lead): Вы явно говорите Lead-агенту распределить конкретную задачу на определенного участника.
- Самостоятельный захват: После завершения текущей задачи участник автоматически берет следующую доступную нераспределенную задачу.
- Файловые блокировки (File locks): Если несколько участников одновременно пытаются взять одну и ту же задачу, система использует файловые блокировки для предотвращения конфликтов.
Рекомендации по размеру задач: Лучшая практика — назначать каждому участнику по 5-6 задач. Если задачи слишком мелкие, затраты на координацию превысят выгоду; если слишком крупные — участник долго не будет сообщать о прогрессе.
Способы связи между участниками
| Тип связи | Описание | Сценарий использования |
|---|---|---|
| write (личное сообщение) | Отправка сообщения конкретному участнику | Координация по специфическим вопросам |
| broadcast (рассылка) | Отправка сообщения всем участникам | Важные уведомления (используйте осторожно, стоимость растет с размером команды) |
Связь работает по принципу «точка-точка», сообщениям не обязательно проходить через Lead-агента. Любой участник может написать другому напрямую.
Работа с Git и предотвращение конфликтов файлов
Самое важное правило в Agent Teams: если два участника редактируют один и тот же файл, это приведет к перезаписи данных.
Рекомендуемая стратегия разделения обязанностей:
# Пример разработки фулстек-фичи
Участник Backend → отвечает за src/api/ и src/migrations/
Участник Frontend → отвечает за src/components/
Участник Test → отвечает за tests/
⚠️ Важно: Участники Agent Teams работают в одной рабочей директории и не используют git worktree автоматически. Убедитесь, что каждый участник работает со своим набором файлов — это ключ к избежанию конфликтов.
5 основных сценариев использования Claude Agent Teams
Сценарий 1: Многостороннее код-ревью
Создай команду агентов для проверки этого PR:
- Специалист по безопасности: проверь на инъекции, XSS, проблемы с правами доступа.
- Специалист по производительности: проанализируй N+1 запросы, утечки памяти, стратегии кэширования.
- Специалист по тестированию: проверь покрытие тестами и граничные случаи.
Пусть каждый проведет ревью и доложит о результатах.
Почему это подходит для Agent Teams: Три направления проверки полностью независимы, не вызывают конфликтов файлов и могут выполняться параллельно.
Сценарий 2: Параллельная разработка новых модулей
Создай команду для разработки системы уведомлений пользователей:
- Участник 1: Разработка Backend API (src/api/notifications/)
- Участник 2: Разработка Frontend-компонентов (src/components/notifications/)
- Участник 3: Написание интеграционных тестов (tests/notifications/)
Почему это подходит: Каждый участник отвечает за свою директорию. Они естественным образом изолированы друг от друга, а по завершении работы результаты просто объединяются.
Сценарий 3: Отладка конкурирующих гипотез
Есть периодически возникающий баг. Создай команду для проверки разных гипотез:
- Участник А: проверь, не является ли это состоянием гонки (race condition).
- Участник Б: проверь, нет ли утечки памяти.
- Участник В: проверь, не случаются ли таймауты у стороннего API.
Пусть каждый независимо проверит свою гипотезу и отчитается.
Почему это подходит: Состязательная отладка. Несколько линий расследования идут параллельно — кто первым найдет истинную причину, тот и победил.
Сценарий 4: Координация изменений на разных слоях
Когда правки затрагивают фронтенд, бэкенд и базу данных одновременно, Agent Teams позволяет экспертам каждого слоя заниматься своим делом, координируя определения интерфейсов через систему сообщений.
Сценарий 5: Исследовательская работа
Я проектирую CLI-инструмент для отслеживания комментариев TODO в коде.
Создай команду для исследования с разных сторон:
- Один участник отвечает за проектирование UX.
- Второй участник отвечает за техническую архитектуру.
- Третий участник играет роль «адвоката дьявола» (ставит под сомнение решения).
Почему это подходит: Столкновение разных точек зрения. Участники бросают вызов гипотезам и выводам друг друга, что делает итоговое решение более продуманным.
Claude Agent Teams 与 Subagent 选择指南
| 判断维度 | 选 Subagent | 选 Agent Teams |
|---|---|---|
| 队友需要互相沟通？ | ❌ 不需要 | ✅ 需要 |
| 任务是否可并行？ | 部分可以 | ✅ 高度并行 |
| 是否涉及多文件编辑？ | ✅ 同文件安全 | ⚠️ 需分工避免冲突 |
| 任务复杂度？ | 聚焦单一目标 | 多角度、多模块 |
| Token 预算？ | 💰 更省 | 💸 约 3-7 倍消耗 |
| 是否需要讨论/质疑？ | ❌ | ✅ |
成本参考: 一个 3 人 Agent Teams 团队运行 30 分钟，Token 消耗约为单个会话的 3-4 倍。Plan 模式下约 7 倍。推荐通过 APIYI apiyi.com 灵活管理 Token 预算。
Claude Agent Teams 高级技巧
技巧一：混合模型降低成本
创建一个团队，Lead 使用 Opus，4 个队友使用 Sonnet。
Lead 负责战略决策用 Opus 4.6 保证质量，队友执行具体任务用 Sonnet 控制成本。
技巧二：Plan 审批工作流
生成一个架构师队友来重构认证模块。
要求在修改前先提交方案等待审批。
队友会先进入只读 Plan 模式，完成方案后发送审批请求给 Lead。Lead 批准后队友才开始实施。
技巧三：委派模式防止 Lead 下场
按 Shift+Tab 开启委派模式。这样 Lead 只负责协调和分配任务，不会自己动手写代码。防止 Lead "抢活干"。
技巧四：Quality Gate Hooks
通过 Hook 机制自动把控质量：
TeammateIdle: 队友即将空闲时触发，退出码 2 可以发送反馈让队友继续工作TaskCompleted: 任务标记完成时触发，退出码 2 可以阻止完成并要求修改
Особенности работы с Claude Agent Teams
Известные ограничения
- Нет восстановления сессий: команды
/resumeи/rewindне восстанавливают уже закрытых «напарников» по команде. - Одна сессия — одна команда: Lead-агент может управлять только одной группой одновременно.
- Никаких вложенных команд: участники команды не могут создавать свои собственные подкоманды.
- Наследование прав: напарники наследуют режим разрешений Lead-агента, но после их создания права можно подправить индивидуально.
- Ограничения режима разделения экрана: разделение экрана через tmux не поддерживается во встроенном терминале VS Code, Windows Terminal и Ghostty.
- Сбой участника: если агент «вылетает», срабатывает 5-минутный таймаут (heartbeat), после чего его задачу может забрать другой участник команды.
Лучшие практики
- Размер команды: рекомендуем держать в штате от 2 до 5 агентов. Как показывает практика, 3 участника часто справляются лучше, чем 6.
- Дробление задач важнее количества «рук»: команда из 3 человек с четко распределенными задачами эффективнее, чем плохо организованная группа из 6 агентов.
- Задачи с упором на чтение (ревью кода, исследования) — это «конек» (sweet spot) для Agent Teams.
- Параллельное редактирование (Write-intensive) всё еще остается вызовом. Здесь требуется строгое разделение файлов между участниками.
Часто задаваемые вопросы
Q1: Какая подписка нужна для использования Agent Teams?
Agent Teams — это экспериментальная функция Claude Code. Для неё требуется подписка Claude Max ($100-200 в месяц), чтобы получить достаточный объем лимитов для Opus 4.6. Пользователи API платят по стандартным тарифам Opus 4.6 ($5/$25 за миллион токенов). Также можно воспользоваться платформой APIYI (apiyi.com) для более гибких вариантов оплаты.
Q2: Обязательно ли использовать только Opus 4.6?
Нет. Хотя Agent Teams были представлены вместе с Opus 4.6, вы можете комбинировать модели. Рекомендуемая схема: использовать Opus 4.6 в качестве Lead-агента для принятия стратегических решений, а напарникам поручать конкретные задачи на Sonnet. Это позволит сохранить качество координации и при этом оптимизировать расходы.
Q3: Можно ли использовать Agent Teams в VS Code?
Можно, но с ограничениями. Встроенный терминал VS Code поддерживает режим in-process (когда все участники команды работают в одном терминале). Однако режим разделения экрана tmux в VS Code недоступен — для этого придется использовать внешний терминал.
Итоги
Основные моменты Claude 4.6 Agent Teams:
- Как включить: Установите переменную окружения
CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1, а затем опишите свою команду на естественном языке. - Архитектурная модель: Ведущий агент (Lead Agent) координирует процесс, а агенты-напарники (Teammate Agents) работают параллельно, взаимодействуя через общий список задач и систему сообщений.
- Лучшие сценарии: Ревью кода, параллельная разработка новых модулей, проверка конкурирующих гипотез при отладке, кросс-уровневая координация и исследовательские задачи.
- Ключевые принципы: Грамотное разделение задач важнее количества агентов. Как правило, 3 напарника показывают себя лучше, чем 6.
- Контроль затрат: Гибридная схема (Opus для Lead + Sonnet для напарников) — это оптимальное соотношение цены и производительности.
Agent Teams переводят ИИ-программирование из эры «одиночек» в эпоху командной работы. Хотя функция всё еще находится в стадии Research Preview, она уже демонстрирует впечатляющие возможности параллельной разработки.
Рекомендуем использовать APIYI (apiyi.com) для получения доступа к Claude API. Платформа предлагает гибкую тарификацию и поддержку нескольких моделей, что удобно для тестирования различных конфигураций Agent Teams.
📚 Справочные материалы
⚠️ Примечание по формату ссылок: Все внешние ссылки указаны в формате
Название: domain.com. Их удобно копировать, но они не являются кликабельными для сохранения SEO-структуры.
-
Официальная документация Claude Code Agent Teams: Полное руководство по использованию Agent Teams
- Ссылка:
code.claude.com/docs/en/agent-teams - Описание: Официальные инструкции, способы активации, описание архитектуры и лучшие практики.
- Ссылка:
-
Инженерный блог Anthropic — Кейс с C-компилятором: 16 агентов Claude параллельно создают компилятор C
- Ссылка:
anthropic.com/engineering/building-c-compiler - Описание: Масштабный практический пример использования Agent Teams: более 2000 сессий и 100 000 строк кода на выходе.
- Ссылка:
-
Addy Osmani — Claude Code Swarms: Глубокий анализ Agent Teams от руководителя инженерного отдела Google
- Ссылка:
addyosmani.com/blog/claude-code-agent-teams - Описание: Разбор архитектуры и советы по эффективному применению.
- Ссылка:
-
Анонс Claude Opus 4.6: Официальное сообщение о релизе
- Ссылка:
anthropic.com/news/claude-opus-4-6 - Описание: Официальное представление возможностей Agent Teams.
- Ссылка:
Автор: Команда APIYI
Техническое обсуждение: Делитесь своим опытом использования Claude Agent Teams в комментариях. Больше материалов можно найти в техническом сообществе APIYI (apiyi.com).
