Claude Code розпочинає командний бій! Агентські команди, які ви повинні використовувати!

Claude Code знову зробив великий крок: Agent Teams, що можна розуміти як супер-посилену версію Sub Agents. Нижче наведено порівняння Agent Teams і Subagents:

Я «використовую першим, щоб віддати належне»! (Дуже круто! Дуже круто! Дуже круто!)

Умови для активації Agent Teams:

1. Оновіть Claude Code до останньої версії (claude update)

2. Додайте рядок у settings.json:

"CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1" 3. Перезапустіть Claude Code~

4. Потім просто використовуйте природну мову, щоб Claude Code створив Agent Teams (звичайно, потрібно чітко пояснити, що Agent Teams має робити)

Крім того, інші моделі не впливають на роботу Agent Teams (я використовую KIMi для кодування)

Більше деталей про Agent Teams дивіться нижче (офіційна стаття Anthropic)!

Agent Teams дозволяє координувати роботу кількох екземплярів Claude Code разом. Одна сесія виступає в ролі лідера, координуючи роботу, розподіляючи завдання та узагальнюючи результати. Підлеглі працюють незалежно, кожен у своєму контекстному вікні, і навіть можуть безпосередньо спілкуватися один з одним.

На відміну від субагентів (Subagents) (які працюють в одній сесії та можуть звітувати лише головному агенту), ви також можете безпосередньо взаємодіяти з окремими підлеглими, не звертаючись до лідера.

Цей документ охоплює:

• • Коли використовувати Agent Teams, включаючи найкращі випадки використання та порівняння з субагентами

• • Запуск команди

• • Керування підлеглими, включаючи режим відображення, розподіл завдань і делегування

• • Найкращі практики для паралельної роботи

Коли використовувати Agent Teams

Agent Teams є найбільш ефективними в завданнях, де паралельне дослідження може додати реальну цінність. Найсильніші випадки використання включають:

• • Дослідження та перевірка —— кілька підлеглих можуть одночасно досліджувати різні аспекти проблеми, а потім ділитися та оскаржувати висновки один одного

• • Нові модулі або функції —— підлеглі можуть мати незалежні частини, не заважаючи один одному

• • Налагодження з конкуруючими гіпотезами —— підлеглі паралельно перевіряють різні теорії, щоб швидше знайти відповідь

• • Міжшарова координація —— зміни, що охоплюють фронтенд, бекенд і тестування, кожна з яких відповідає різним підлеглим

Agent Teams збільшує координаційні витрати (Ви б наважилися використовувати Opus4.6 для запуску Agent Teams🤣), і значно збільшує споживання токенів порівняно з однією сесією. Вони найкраще працюють, коли група може працювати незалежно. Для послідовних завдань, редагування одного файлу або роботи з великою кількістю залежностей, одна сесія або субагенти є більш ефективними.

Порівняння з субагентами

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

Субагенти

Agent Teams

Контекст

Власне контекстне вікно; результати повертаються викликаючому

Власне контекстне вікно; повністю незалежний

Зв'язок

Звітує лише головному агенту

Підлеглі безпосередньо обмінюються повідомленнями

Координація

Головний агент керує всією роботою

Спільний список завдань, самокоординація

Найкраще підходить для

Зосереджених завдань, де важливі лише результати

Складної роботи, яка потребує обговорення та співпраці

Вартість токенів

Нижча: результати зводяться до головного контексту

Вища: кожен підлеглий є незалежним екземпляром Claude

Використовуйте субагентів, коли вам потрібні швидкі, зосереджені працівники, які звітують про результати. Використовуйте Agent Teams, коли групі потрібно ділитися висновками, оскаржувати один одного та самостійно координуватись.

Увімкнення Agent Teams

Agent Teams вимкнено за замовчуванням. Увімкніть їх, встановивши змінну середовища CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS в 1, або в середовищі shell, або через settings.json:

{ "env": { "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1" } }

Запуск вашої першої Agent Team

Після ввімкнення Agent Teams, скажіть Claude створити Agent Team, використовуючи природну мову для опису завдання та бажаної структури команди. Claude створить команду, згенерує підлеглих і скоординує роботу на основі вашого запиту.

Цей приклад добре працює, оскільки три ролі є незалежними та можуть досліджувати проблему, не чекаючи один на одного:

Create an agent team to explore this from different angles: one teammate on UX, one on technical architecture, one playing devil's advocate. (Створіть Agent Team для дослідження цього з різних кутів: один учасник команди з UX, один з технічної архітектури, один грає роль адвоката диявола.)

Звідти Claude створить команду зі спільним списком завдань, згенерує підлеглих для кожної перспективи, дозволить їм досліджувати проблему, узагальнювати висновки та спробує очистити команду після завершення.

Термінал лідера перелічує всіх підлеглих і їхню роботу. Використовуйте Shift+Up/Down, щоб вибрати підлеглого та надіслати йому повідомлення безпосередньо.

Керування вашою Agent Team

Скажіть лідеру, що ви хочете, природною мовою. Він обробляє координацію команди, розподіл завдань і делегування відповідно до ваших інструкцій.

Вибір режиму відображення

Agent Teams підтримує два режими відображення:

• • Режим в процесі —— усі підлеглі працюють у вашому головному терміналі. Використовуйте Shift+Up/Down, щоб вибрати підлеглого та ввести повідомлення безпосередньо. Підходить для будь-якого терміналу, не потребує додаткових налаштувань.

• • Режим розділеного екрана —— кожен підлеглий має власну панель. Ви можете бачити вихідні дані всіх одночасно та натискати на панель для безпосередньої взаємодії. Потрібен tmux або iTerm2.

За замовчуванням використовується "auto", який використовує розділений екран, якщо ви вже працюєте в сесії tmux, інакше використовується режим в процесі.

Щоб примусово використовувати режим в процесі для однієї сесії, передайте прапорець:

claude --teammate-mode in-process

Вкажіть підлеглих і моделі

Claude вирішує, скільки teammate згенерувати, на основі вашого завдання, або ви можете точно вказати, що ви хочете:

Create a team with 4 teammates to refactor these modules in parallel. Use Sonnet for each teammate. (Створіть команду з 4 учасників для паралельного рефакторингу цих модулів. Використовуйте Sonnet для кожного учасника.)

Вимагайте затвердження плану від teammate

Для складних або ризикованих завдань ви можете вимагати від teammate планування перед впровадженням. Teammate працює в режимі планування лише для читання, доки лідер не затвердить їхній метод:

Spawn an architect teammate to refactor the authentication module. Require plan approval before they make any changes. (Створіть архітектора teammate для рефакторингу модуля аутентифікації. Вимагайте затвердження плану перед внесенням будь-яких змін.)

Коли teammate завершує планування, він надсилає запит на затвердження плану лідеру. Лідер переглядає план і затверджує або відхиляє його з наданням відгуку.

Використовуйте режим делегування

Без режиму делегування лідер іноді починає впроваджувати завдання самостійно, не чекаючи завершення підлеглих. Режим делегування запобігає цьому, обмежуючи лідера лише інструментами координації. Натисніть Shift+Tab, щоб переключитися в режим делегування.

Спілкуйтеся безпосередньо з підлеглими

Кожен підлеглий є повною, незалежною сесією Claude Code. Ви можете надсилати повідомлення безпосередньо будь-якому підлеглому:

• • Режим в процесі: Використовуйте Shift+Up/Down, щоб вибрати підлеглого, а потім введіть і надішліть повідомлення. Натисніть Enter, щоб переглянути сесію підлеглого, а потім натисніть Escape, щоб перервати їхній поточний раунд. Натисніть Ctrl+T, щоб переключитися на список завдань.

• • Режим розділеного екрана: Натисніть на панель підлеглого, щоб безпосередньо взаємодіяти з його сесією.

Призначення та отримання завдань

Спільний список завдань координує роботу команди. Лідер створює завдання, підлеглі виконують. Завдання має три стани: очікує, виконується, завершено. Завдання також можуть залежати від інших завдань.

Лідер може явно призначати завдання, або підлеглі можуть самостійно отримувати їх після завершення завдання.

Закриття підлеглих

Щоб коректно завершити сесію teammate:

Ask the researcher teammate to shut down (Попросіть дослідника teammate закритися)

Лідер надсилає запит на закриття. Teammate може затвердити та коректно вийти, або відхилити та пояснити причину.

Очищення команди

Після завершення попросіть лідера очистити:

Clean up the team (Очистіть команду)

Це видалить спільні командні ресурси. Коли лідер запускає очищення, він перевіряє активних підлеглих і зазнає невдачі, якщо ще є працюючі, тому спочатку потрібно їх закрити.

Як працюють Agent Teams

Архітектура

Agent Team включає:

• • Лідер: Головна сесія Claude Code, яка створює команду, генерує підлеглих і координує роботу

• • Підлеглі: Незалежні екземпляри Claude Code, кожен з яких обробляє призначені завдання

• • Список завдань: Спільний список робочих елементів, які підлеглі отримують і виконують

• • Поштова скринька: Система обміну повідомленнями між агентами

Система автоматично керує залежностями завдань. Команда та завдання зберігаються локально:

• • Конфігурація команди: ~/.claude/teams/{team-name}/config.json

• • Список завдань: ~/.claude/tasks/{team-name}/

Контекст і зв'язок

Кожен підлеглий має власне контекстне вікно. Під час генерації підлеглий завантажує той самий контекст проекту, що й звичайна сесія: CLAUDE.md, MCP-сервер і навички. Історія розмов лідера не передається.

Як підлеглі діляться інформацією:

• • Автоматичне надсилання повідомлень: Коли підлеглий надсилає повідомлення, воно автоматично надсилається одержувачу

• • Сповіщення про простій: Коли підлеглий завершує роботу та зупиняється, лідер автоматично отримує сповіщення

• • Спільний список завдань: Усі агенти можуть бачити стан завдань і отримувати доступну роботу

Використання токенів

Agent Teams значно збільшує споживання токенів порівняно з однією сесією. Кожен підлеглий має власне контекстне вікно, і використання токенів збільшується зі збільшенням кількості активних підлеглих. Для досліджень, перевірок і нової функціональності додаткові токени зазвичай варті того. Для звичайних завдань одна сесія є більш економічно вигідною.

Приклади використання

Запуск паралельної перевірки коду

Окремі рецензенти, як правило, зосереджуються на одному типі проблем за раз. Розбиття критеріїв перевірки на незалежні області означає, що безпека, продуктивність і охоплення тестами одночасно отримують ретельну увагу.

Create an agent team to review PR #142. Spawn three reviewers: one focused on security implications, one checking performance impact, one validating test coverage. Have them each review and report findings. (Створіть Agent Team для перевірки PR #142. Створіть трьох рецензентів: один зосереджений на наслідках для безпеки, один перевіряє вплив на продуктивність, один перевіряє охоплення тестами. Нехай кожен перегляне та повідомить про висновки.)

Дослідження з конкуруючими гіпотезами

Коли першопричина незрозуміла, окремий агент, як правило, знаходить одне правдоподібне пояснення та припиняє пошук.

Users report the app exits after one message instead of staying connected. Spawn 5 agent teammates to investigate different hypotheses. Have them talk to each other to try to disprove each other's theories, like a scientific debate. Update the findings doc with whatever consensus emerges.

Найкращі практики

Надайте підлеглим достатньо контексту

Підлеглі автоматично завантажують контекст проекту, але не успадковують історію розмов лідера. Включіть деталі, специфічні для завдання, у підказку генерації.

Відповідно налаштуйте розмір завдання

• • Занадто малий: Координаційні витрати перевищують вигоди

• • Занадто великий: Підлеглі працюють занадто довго без перевірки, збільшуючи ризик марних зусиль

• • В самий раз: Самодостатній блок, який дає чіткий результат

Зачекайте, поки підлеглі завершать роботу

Іноді лідер сам починає впроваджувати завдання, не чекаючи завершення teammate. Якщо ви помітили це:

Wait for your teammates to complete their tasks before proceeding (Зачекайте, поки ваші teammates завершать свої завдання, перш ніж продовжувати)

Уникайте конфліктів файлів

Редагування одного файлу двома підлеглими призведе до перезапису. Розділіть роботу, щоб кожен підлеглий мав різний набір файлів.

Моніторинг і керівництво

Перевіряйте прогрес підлеглих, перенаправляйте методи, які не працюють, і узагальнюйте висновки в міру їх надходження.

Обмеження

Agent Teams є експериментальними. Поточні обмеження:

• • Члени команди в процесі не підтримують відновлення сесії: /resume і /rewind не відновлюють підлеглих в процесі

• • Стан завдання може відставати: Підлеглі іноді не можуть позначити завдання як завершене

• • Закриття може бути повільним: Підлеглі завершують поточний запит перед закриттям

• • Одна команда на сесію: Один лідер може керувати лише однією командою за раз

• • Не підтримуються вкладені команди: Підлеглі не можуть генерувати власні команди

• • Лідер фіксований: Сесія, яка створила команду, є лідером протягом усього її життєвого циклу- • Для розділення екрану потрібні tmux або iTerm2: Не підтримуються інтегрований термінал VS Code, Windows Terminal або Ghostty