Claude Code стартира режим на групова битка! Агентските екипи, които трябва да използвате!
Claude Code отново изстреля голям удар: Агентски екипи, които могат да се разбират като супер засилена версия на Sub Agents～ На следващата снимка е сравнението между Агентски екипи и Subagents:
Аз съм "първият, който ги използва"! (Много яко! Много яко! Много яко!)
Условия за активиране на Агентски екипи:
1. Актуализирайте Claude Code до най-новата версия (claude update)
2. В settings.json добавете един ред:
"CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1" 3. Рестартирайте Claude Code～
4. След това директно използвайте естествен език, за да накарате Claude Code да създаде Агентски екип (разбира се, трябва да обясните какво трябва да прави Агентският екип)
Освен това, други модели не влияят на работата на Агентските екипи (аз използвам KIMi for coding)
Повече подробности за Агентските екипи вижте по-долу (официална статия от Anthropic)!
Агентските екипи ви позволяват да координирате множество инстанции на Claude Code да работят заедно. Една сесия е главната, координира работата, разпределя задачите, комбинира резултатите. Подчинените работят независимо, всеки в собствената си контекстна прозорец, и могат директно да си говорят помежду си.
За разлика от под-агентите (Subagents) (под-агентите работят в една сесия, могат само да докладват на главния агент), вие можете директно да взаимодействате с отделни подчинени, без да минавате през главния.
Този документ обхваща:
• Кога да използвате Агентски екипи, включително най-добри случаи на употреба и сравнение с под-агенти
• Стартиране на екип
• Контрол над подчинените, включително режими на показване, разпределяне на задачи и делегиране
• Най-добри практики за паралелна работа
Кога да използвате Агентски екипи
Агентските екипи са най-ефективни в задачи, където паралелното изследване може да добави реална стойност. Най-силните случаи на употреба включват:
• Изследване и преглед —— Няколко подчинени могат едновременно да изследват различни аспекти на проблем, след това да споделят и оспорват откритията си
• Нови модули или функции —— Подчинените могат да имат независими части, без да се пречат
• Отстраняване на грешки с конкурентни хипотези —— Подчинените паралелно тестват различни теории, за да намерят отговор по-бързо
• Координация между слоеве —— Промени, обхващащи фронтенд, бекенд и тестване, всеки отговорен от различен подчинен
Агентските екипи увеличават режийните разходи за координация (Ще използвате ли Opus4.6, за да стартирате Агентски екипи🤣), използват значително повече токени в сравнение с една сесия. Те работят най-добре, когато малките групи могат да работят независимо. За последователни задачи, редактиране на един файл или работа с много зависимости, една сесия или под-агенти са по-ефективни.
Сравнение с под-агенти
Агентските екипи и под-агентите ви позволяват да работите паралелно, но работят по различен начин. Изберете според това дали вашите работници трябва да комуникират помежду си:
Под-агенти
Агентски екипи
Контекст
Собствен контекстен прозорец; резултатите се връщат на извикващия
Собствен контекстен прозорец; напълно независими
Комуникация
Докладват резултати само на главния агент
Подчинените си изпращат съобщения директно
Координация
Главният агент управлява цялата работа
Споделен списък със задачи, само-координация
Най-подходящи за
Фокусирани задачи, при които се интересувате само от резултата
Сложна работа, изискваща дискусия и сътрудничество
Разходи за токени
По-ниски: резултатите се обобщават обратно в главния контекст
По-високи: всеки подчи��ен е независима инстанция на Claude
Използвайте под-агенти, когато имате нужда от бързи, фокусирани работници, които докладват резултати. Използвайте Агентски екипи, когато групата трябва да споделя открития, да се предизвиква взаимно и да се само-координира.
Активиране на Агентски екипи
Агентските екипи са деактивирани по подразбиране. Активирайте ги, като зададете променливата на средата CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS на 1, може в shell среда или чрез settings.json:
{
"env": {
"CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
}
}Стартиране на първия ви Агентски екип
След като активирате Агентските екипи, кажете на Claude да създаде Агентски екип, като използвате естествен език, за да опишете задачата и желаната от вас структура на екипа. Claude създава екипа въз основа на вашата подсказка, генерира подчинени и координира работата.
Този пример работи добре, защото трите роли са независими и могат да изследват проблема без да чакат една друга:
Create an agent team to explore this from different angles: one teammate on UX, one on technical architecture, one playing devil's advocate.
(Създайте Агентски екип, за да изследвате това от различни ъгли: един съотборник по UX, един по техническа архитектура, един играещ ролята на адвокат на дявола.)
Оттам Claude създава екип със споделен списък със задачи, генерира подчинен за всяка гледна точка, позволява им да изследват проблема, комбинира откритията и след като приключи, се опитва да почисти екипа.
Терминалът на главния показва всички подчинени и какво работят. Използвайте Shift+Нагоре/Надолу, за да изберете подчинен и директно да му изпратите съобщение.
Контрол над вашия Агентски екип
Използвайте естествен език, за да кажете на главния какво искате. Той обработва координацията на екипа, разпределението на задачите и делегирането според вашите указания.
Избор на режим на показване
Агентските екипи поддържат два режима на показване:
• Режим в процеса —— Всички подчинени работят във вашия главен терминал. Използвайте Shift+Нагоре/Надолу, за да изберете подчинен и директно да въведете съобщение. Подходящ за всеки терминал, не изисква допълнителна настройка.
• Режим с разделен екран —— Всеки подчинен има собствен панел. Можете едновременно да виждате изхода на всички, кликнете върху панела за директно взаимодействие. Изисква tmux или iTerm2.
По подразбиране е "auto", ако вече работите в tmux сесия, използва разделен екран, в противен случай използва режим в процеса.
За да принудите режим в процеса за една сесия, подайте флаг:
claude --teammate-mode in-processУказване на подчинени и модели
Claude решава колко съотборника да генерира въз основа на вашата задача, или можете точно да укажете какво искате:
Create a team with 4 teammates to refactor these modules in parallel. Use Sonnet for each teammate.
(Създайте екип от 4 съотборника, за да рефакторирате тези модули паралелно. Използвайте Sonnet за всеки съотборник.)
Изискване одобрение на план от съотборник
За сложни или рискови задачи можете да поискате съотборник да планира преди изпълнение. Съотборникът работи в режим само за четене на плана, докато главният не одобри неговия подход:
Spawn an architect teammate to refactor the authentication module. Require plan approval before they make any changes.
(Генерирайте съотборник архитект, за да рефакторира модула за удостоверяване. Изисквайте одобрение на плана, преди да направи каквито и да било промени.)
Когато съотборникът завърши плана, изпраща заявка за одобрение на плана до главния. Главният преглежда плана и одобрява или отхвърля, като предоставя обратна връзка.
Използване на режим на делегиране
Без режим на делегиране, главният понякога започва сам да изпълнява задачи, вместо да чака подчинените да завършат. Режимът на делегиране предотвратява това, като ограничава главния само до инструменти за координация. Натиснете Shift+Tab, за да превключите към режим на делегиране.
Директно разговор с подчинен
Всеки подчинен е пълна, независима сесия на Claude Code. Можете директно да изпращате съобщения на всеки подчинен:
• Режим в процеса: Използвайте Shift+Нагоре/Надолу, за да изберете подчинен, след това въведете и изпратете съобщение. Натиснете Enter, за да видите сесията на подчинения, след това натиснете Escape, за да прекъснете текущия им ход. Натиснете Ctrl+T, за да превключите списъка със задачи.
• Режим с разделен екран: Кликнете върху панела на подчинения за директно взаимодействие с неговата сесия.
Разпределяне и поемане на задачи
Споделеният списък със задачи координира работата на екипа. Главният създава задачи, подчинените ги изпълняват. Задачите имат три състояния: изчакващи, в ход, завършени. Задачите също могат да зависят от други задачи.
Главният може изрично да разпредели задачи, или подчинените могат сами да ги поемат след като завършат.
Затваряне на подчинен
За да приключите елегантно сесията на съотборник:
Ask the researcher teammate to shut down
Главният изпраща заявка за затваряне. Съотборникът може да одобри и да излезе елегантно, или да откаже и да обясни защо.
Почистване на екипа
След като приключите, помолете главния да почисти:
Clean up the team
(Почистете екипа)
Това премахва споделените ресурси на екипа. Когато главният изпълни почистване, проверява за активни подчинени, и ако все още има работещи, не успява, така че първо ги затворете.
Как работят Агентските екипи
Архитектура
Агентският екип включва:
• Главен: Главната сесия на Claude Code, която създава екипа, генерира подчинени и координира работата
• Подчинени: Независими инстанции на Claude Code, всяка обработваща разпределени задачи
• Списък със задачи: Споделен списък с работни елементи, които подчинените поемат и изпълняват
• Пощенска кутия: Система за съобщения за комуникация между агенти
Системата автоматично управлява зависимостите на задачите. Екипът и задачите се съхраняват локално:
• Конфигурация на екипа:
~/.claude/teams/{team-name}/config.json• Списък със задачи:
~/.claude/tasks/{team-name}/
Контекст и комуникация
Всеки подчинен има собствен контекстен прозорец. При генериране, подчинените зареждат същия контекст на проекта като обикновена сесия: CLAUDE.md, MCP сървъри и умения. Историята на разговорите на главния не се предава.
Как подчинените споделят информация:
• Автоматично предаване на съобщения: Когато подчинен изпрати съобщение, то автоматично се предава на получателя
• Известие за бездействие: Когато подчинен завърши и спре, автоматично уведомява главния
• Споделен списък със задачи: Всички агенти могат да виждат състоянието на задачите и да поемат налична работа
Използване на токени
Агентските екипи използват значително повече токени в сравнение с една сесия. Всеки подчинен има собствен контекстен прозорец, използването на токени се увеличава с броя на активните подчинени. За изследване, преглед и работа по нови функции, допълнителните токени обикновено си струват. За редовни задачи, една сесия е по-рентабилна.
Примери за случаи на употреба
Изпълнение на паралелен преглед на код
Един прегледащ има тенденция да се фокусира върху един тип проблем наведнъж. Разделянето на критериите за преглед на независими области означава, че безопасността, производителността и покритието от тестове получават едновременно и задълбочено внимание.
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.
(Създайте Агентски екип, за да прегледа 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.Най-добри практики
Дайте достатъчно контекст на подчинените
Подчинените автоматично зареждат контекста на проекта, но не наследяват историята на разговорите на главния. Включете специфични за задачата детайли в подсказката за генериране.
Подходящо определяне на размера на задачите
• Твърде малки: Режийните разходи за координация надвишават ползите
• Твърде големи: Подчинените работят твърде дълго без проверка, увеличавайки риска от загуба на усилия
• Точно: Самостоятелни единици, произвеждащи ясни резултати
Изчакване на подчинените да завършат
Понякога главният започва сам да изпълнява задачи, вместо да чака съотборниците да завършат. Ако забележите това:
Wait for your teammates to complete their tasks before proceeding
Избягване на конфликти във файлове
Двама подчинени, редактиращи един и същ файл, водят до презаписване. Разделете работата така, че всеки подчинен да притежава различен набор от файлове.
Мониторинг и насочване
Проверявайте напредъка на подчинените, пренасочвайте методи, които не работят, и комбинирайте откритията с напредъка.
Ограничения
Агентските екипи са експериментални. Текущи ограничения:
• Членове в процеса не поддържат възстановяване на сесия: /resume и /rewind няма да възстановят подчинени в процеса
• Състоянието на задачите може да изостане: Подчинените понякога не могат да маркират задачи като завършени
• Затварянето може да е бавно: Подчинените завършват текущата заявка преди затваряне
• Един екип на сесия: Един главен може да управлява само един екип наведнъж
• Не се поддържат вложени екипи: Подчинените не могат да генерират собствени екипи
• Главният е фиксиран: Сесията, която създава екипа, е главен през целия му живот
• Разделеният екран изисква tmux или iTerm2: Не се поддържа интегриран терминал на VS Code, Windows Terminal или Ghostty
