Claude Code abre o modo de batalha em equipe! As Agent Teams que você precisa usar!

Claude Code lançou outra bomba: Agent Teams, que pode ser entendida como uma versão super aprimorada dos Sub Agents! A imagem abaixo é uma comparação entre Agent Teams e Subagents:

Eu fui o primeiro a usar (e adorei! Adorei! Adorei!)

Condições para ativar o Agent Teams:

1. Atualize o Claude Code para a versão mais recente (claude update)

2. Adicione a seguinte linha em settings.json:

"CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1" 3. Reinicie o Claude Code~

4. Em seguida, use linguagem natural para fazer com que o Claude Code crie um Agent Teams (claro, explique claramente o que você quer que o Agent Teams faça)

Além disso, outros modelos não afetam o trabalho do Agent Teams (eu uso KIMi para codificação)

Mais detalhes sobre o Agent Teams podem ser encontrados no artigo abaixo (escrito pela Anthropic oficialmente)!

Agent Teams permite que você coordene várias instâncias do Claude Code para trabalhar juntas. Uma sessão atua como líder, coordenando o trabalho, atribuindo tarefas e sintetizando os resultados. Os subordinados trabalham de forma independente, cada um em sua própria janela de contexto, e podem até conversar diretamente uns com os outros.

Ao contrário dos subagentes (Subagents) (que são executados em uma única sessão e só podem se reportar ao agente principal), você também pode interagir diretamente com subordinados individuais, sem passar pelo líder.

Este documento cobre:

• • Quando usar Agent Teams, incluindo os melhores casos de uso e uma comparação com subagentes

• • Iniciando uma equipe

• • Controlando os subordinados, incluindo o modo de exibição, atribuição de tarefas e delegação

• • Melhores práticas para trabalho paralelo

Quando usar Agent Teams

Agent Teams são mais eficazes em tarefas onde a exploração paralela pode agregar valor real. Os casos de uso mais fortes incluem:

• • Pesquisa e revisão - Vários subordinados podem investigar simultaneamente diferentes aspectos de um problema, e então compartilhar e desafiar as descobertas uns dos outros

• • Novos módulos ou funcionalidades - Os subordinados podem cada um possuir partes independentes, sem interferência mútua

• • Depuração com hipóteses concorrentes - Os subordinados testam diferentes teorias em paralelo, encontrando respostas mais rapidamente

• • Coordenação entre camadas - Mudanças abrangendo front-end, back-end e testes, cada um responsável por um subordinado diferente

Agent Teams aumentam a sobrecarga de coordenação (Você ousaria usar Opus4.6 para abrir Agent Teams🤣) e aumentam significativamente o consumo de tokens em comparação com uma única sessão. Eles funcionam melhor quando os grupos podem operar de forma independente. Para tarefas sequenciais, edição do mesmo arquivo ou trabalho com muitas dependências, uma única sessão ou subagentes são mais eficazes.

Comparação com subagentes

Agent Teams e subagentes permitem que você trabalhe em paralelo, mas operam de maneiras diferentes. Escolha com base em se seus trabalhadores precisam se comunicar uns com os outros:

Subagentes

Agent Teams

Contexto

Sua própria janela de contexto; resultados retornados ao chamador

Sua própria janela de contexto; totalmente independente

Comunicação

Apenas reporta resultados ao agente principal

Subordinados enviam mensagens diretamente uns aos outros

Coordenação

O agente principal gerencia todo o trabalho

Lista de tarefas compartilhada, auto-coordenação

Melhor para

Tarefas focadas que se preocupam apenas com os resultados

Trabalho complexo que requer discussão e colaboração

Custo de Token

Mais baixo: resultados resumidos de volta ao contexto principal

Mais alto: cada subordinado é uma instância Claude independente

Use subagentes quando precisar de trabalhadores rápidos e focados para reportar resultados. Use Agent Teams quando um grupo precisar compartilhar descobertas, desafiar uns aos outros e se auto-coordenar.

Habilitando Agent Teams

Agent Teams estão desabilitados por padrão. Habilite-os definindo a variável de ambiente CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS para 1, seja no ambiente shell ou através de settings.json:

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

Iniciando seu primeiro Agent Team

Depois de habilitar o Agent Teams, diga ao Claude para criar um Agent Team, descrevendo a tarefa e a estrutura de equipe desejada em linguagem natural. Claude cria a equipe, gera subordinados e coordena o trabalho com base em suas instruções.

Este exemplo funciona bem porque os três papéis são independentes e podem explorar o problema sem esperar uns pelos outros:

Create an agent team to explore this from different angles: one teammate on UX, one on technical architecture, one playing devil's advocate. (Crie um Agent Team para explorar isso de diferentes ângulos: um colega de equipe em UX, um em arquitetura técnica, um fazendo o papel de advogado do diabo.)

A partir daí, Claude cria uma equipe com uma lista de tarefas compartilhada, gera subordinados para cada perspectiva, permite que eles explorem o problema, sintetizem as descobertas e tentem limpar a equipe quando terminarem.

O terminal do líder lista todos os subordinados e o que eles estão trabalhando. Use Shift+Up/Down para selecionar um subordinado e enviar mensagens diretamente para ele.

Controlando seu Agent Team

Diga ao líder o que você quer em linguagem natural. Ele lida com a coordenação da equipe, atribuição de tarefas e delegação com base em suas instruções.

Selecionando o modo de exibição

Agent Teams suporta dois modos de exibição:

• • Modo in-process - Todos os subordinados são executados dentro do seu terminal principal. Use Shift+Up/Down para selecionar um subordinado e digitar para enviar mensagens diretamente. Adequado para qualquer terminal, sem configuração adicional.

• • Modo de tela dividida - Cada subordinado tem seu próprio painel. Você pode ver a saída de todos simultaneamente e clicar nos painéis para interagir diretamente. Requer tmux ou iTerm2.

O padrão é "auto", que usa tela dividida se você já estiver executando em uma sessão tmux, caso contrário, usa o modo in-process.

Para forçar o modo in-process para uma única sessão, passe a flag:

claude --teammate-mode in-process

Especificando subordinados e modelos

Claude decide quantos colegas de equipe gerar com base em sua tarefa, ou você pode especificar exatamente o que deseja:

Create a team with 4 teammates to refactor these modules in parallel. Use Sonnet for each teammate. (Crie uma equipe com 4 colegas de equipe para refatorar esses módulos em paralelo. Use Sonnet para cada colega de equipe.)

Requerendo aprovação de plano dos colegas de equipe

Para tarefas complexas ou arriscadas, você pode exigir que os colegas de equipe planejem antes de implementar. Os colegas de equipe trabalham em modo de plano somente leitura até que o líder aprove sua abordagem:

Spawn an architect teammate to refactor the authentication module. Require plan approval before they make any changes. (Gere um colega de equipe arquiteto para refatorar o módulo de autenticação. Exija aprovação do plano antes que eles façam qualquer alteração.)

Quando um colega de equipe termina de planejar, ele envia uma solicitação de aprovação de plano para o líder. O líder revisa o plano e aprova ou rejeita com feedback.

Usando o modo de delegação

Sem o modo de delegação, o líder às vezes começa a implementar tarefas sozinho, em vez de esperar que os subordinados terminem. O modo de delegação impede isso, restringindo o líder apenas a ferramentas de coordenação. Pressione Shift+Tab para alternar para o modo de delegação.

Conversando diretamente com subordinados

Cada subordinado é uma sessão Claude Code completa e independente. Você pode enviar mensagens diretamente para qualquer subordinado:

• • Modo in-process: Use Shift+Up/Down para selecionar um subordinado e, em seguida, digite para enviar uma mensagem. Pressione Enter para ver a sessão do subordinado e, em seguida, pressione Escape para interromper sua rodada atual. Pressione Ctrl+T para alternar a lista de tarefas.

• • Modo de tela dividida: Clique no painel do subordinado para interagir diretamente com sua sessão.

Atribuindo e reivindicando tarefas

Uma lista de tarefas compartilhada coordena o trabalho da equipe. O líder cria tarefas e os subordinados as concluem. As tarefas têm três estados: pendente, em andamento, concluída. As tarefas também podem depender de outras tarefas.

O líder pode atribuir tarefas explicitamente ou os subordinados podem reivindicá-las sozinhos depois de terminar uma tarefa.

Desligando subordinados

Para encerrar a sessão de um colega de equipe de forma elegante:

Ask the researcher teammate to shut down (Peça ao colega de equipe pesquisador para desligar)

O líder envia uma solicitação de desligamento. O colega de equipe pode aprovar e sair graciosamente ou recusar e explicar o motivo.

Limpando a equipe

Quando terminar, peça ao líder para limpar:

Clean up the team (Limpe a equipe)

Isso remove os recursos compartilhados da equipe. Quando o líder executa a limpeza, ele verifica os subordinados ativos e falha se ainda houver algum em execução, então desligue-os primeiro.

Como Agent Teams funciona

Arquitetura

Agent Team inclui:

• • Líder: A sessão Claude Code principal que cria a equipe, gera subordinados e coordena o trabalho

• • Subordinados: Instâncias Claude Code independentes que lidam com tarefas atribuídas

• • Lista de tarefas: Uma lista compartilhada de itens de trabalho que os subordinados reivindicam e concluem

• • Caixa de correio: Um sistema de mensagens para comunicação entre agentes

As dependências de tarefas são gerenciadas automaticamente. A equipe e as tarefas são armazenadas localmente:

• • Configuração da equipe: ~/.claude/teams/{team-name}/config.json

• • Lista de tarefas: ~/.claude/tasks/{team-name}/

Contexto e comunicação

Cada subordinado tem sua própria janela de contexto. Quando gerado, um subordinado carrega o mesmo contexto de projeto que uma sessão regular: CLAUDE.md, servidor MCP e habilidades. O histórico de conversas do líder não é transmitido.

Como os subordinados compartilham informações:

• • Mensagens automáticas: Quando um subordinado envia uma mensagem, ela é automaticamente entregue ao destinatário

• • Notificações de inatividade: Quando um subordinado termina e para, o líder é notificado automaticamente

• • Lista de tarefas compartilhada: Todos os agentes podem ver o status da tarefa e reivindicar o trabalho disponível

Uso de Token

Agent Teams aumenta significativamente o consumo de tokens em comparação com uma única sessão. Cada subordinado tem sua própria janela de contexto e o uso de tokens aumenta com o número de subordinados ativos. Para pesquisa, revisão e trabalho de novos recursos, os tokens adicionais geralmente valem a pena. Para tarefas regulares, uma única sessão é mais econômica.

Exemplos de casos de uso

Executando revisões de código paralelas

Revisores individuais tendem a se concentrar em um tipo de problema por vez. Dividir os critérios de revisão em áreas independentes significa que a segurança, o desempenho e a cobertura de testes recebem atenção completa simultaneamente.

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. (Crie um Agent Team para revisar PR #142. Gere três revisores: um focado em implicações de segurança, um verificando o impacto no desempenho, um validando a cobertura de testes. Faça com que cada um revise e relate as descobertas.)

Investigando com hipóteses concorrentes

Quando a causa raiz não está clara, um único agente tende a encontrar uma explicação aparentemente razoável e parar de procurar.

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.

Melhores práticas

Dê contexto suficiente aos subordinados

Os subordinados carregam automaticamente o contexto do projeto, mas não herdam o histórico de conversas do líder. Inclua detalhes específicos da tarefa nas instruções de geração.

Ajuste o tamanho da tarefa adequadamente

• • Muito pequeno: Os custos gerais de coordenação excedem os benefícios

• • Muito grande: Os subordinados trabalham por muito tempo sem verificação, aumentando o risco de desperdício de esforço

• • Na medida certa: Unidades autocontidas que produzem entregas claras

Espere que os subordinados terminem

Às vezes, o líder começa a implementar tarefas sozinho, em vez de esperar que o colega de equipe termine. Se você notar isso:

Wait for your teammates to complete their tasks before proceeding (Espere que seus colegas de equipe terminem suas tarefas antes de prosseguir)

Evite conflitos de arquivo

Dois subordinados editando o mesmo arquivo podem causar sobrescritas. Divida o trabalho para que cada subordinado possua um conjunto diferente de arquivos.

Monitore e guie

Verifique o progresso dos subordinados, redirecione abordagens que não estão funcionando e sintetize as descobertas à medida que avançam.

Limitações

Agent Teams é experimental. Limitações atuais:

• • Membros da equipe in-process não suportam recuperação de sessão: /resume e /rewind não restauram subordinados in-process

• • O status da tarefa pode estar atrasado: Os subordinados às vezes não conseguem marcar as tarefas como concluídas

• • O desligamento pode ser lento: Os subordinados terminam a solicitação atual antes de desligar

• • Uma equipe por sessão: Um líder só pode gerenciar uma equipe por vez

• • Equipes aninhadas não são suportadas: Os subordinados não podem gerar suas próprias equipes

• • Líder fixo: A sessão que cria a equipe é o líder durante seu ciclo de vida- • A tela dividida requer tmux ou iTerm2: Não há suporte para terminal integrado do VS Code, Windows Terminal ou Ghostty