Agent Teams
Ir para notas que citam estaAgent Teams é um recurso experimental do Claude Code em que os agentes de um time, os teammates, conversam diretamente entre si e puxam trabalho de uma lista de tarefas compartilhada.
O recurso ataca um limite dos Subagentes no Claude Code: neles, toda comunicação passa pelo agente principal, e um agente que depende de outro precisa esperar que ele termine. No Agent Teams, quem trava por falta de uma informação pergunta a quem a tem, e o time segue andando. É um sistema multiagente que imita uma equipe, com papéis que não são fixos nem exclusivos de software.
O Agent Teams não vem habilitado por padrão e ainda não tem lançamento oficial. Ativação, comportamento e custo podem mudar entre versões.
Team lead, teammates e a lista de tarefas compartilhada
O agente principal, o team lead, tem papel organizacional, não avaliador. Ele cria (spawna) os agentes necessários, monta a lista de tarefas e a disponibiliza ao time. Diferente do Agente Orquestrador clássico, ele não valida nem agrega respostas: cada teammate pega da lista o item que combina com o seu perfil, quebra em subtarefas quando precisa e reporta checkpoints ao líder.
A comunicação é horizontal. Se o agente 1 precisa de algo do agente 3, a troca tem duas partes, pergunta e resposta, em vez de passar pelo principal na ida e na volta.
Num bolão de futebol feito por quatro teammates (backend, frontend, reviewer e testes), o backend avisou o time de que uma mudança no núcleo afetaria os demais, o frontend confirmou o contrato combinado com o backend e o agente de testes abriu um navegador para testes automatizados.
Pipeline de microtarefas e a troca de mensagens
O Claude Code executa o trabalho de um agente como uma fila de microtarefas: editar uma linha, abrir outro arquivo para ver contexto. Por isso o terminal não bloqueia: uma pergunta nova entra na fila de microtarefas, não na da tarefa principal, e é respondida entre uma ação e outra. A documentação chama essa sequência de pipeline.
A comunicação entre teammates usa o mesmo mecanismo. Quando um agente percebe que precisa de contexto de outro, acrescenta à própria fila a ação de mandar uma mensagem, e a troca acontece entre uma microtarefa e a seguinte.
Ativação e acompanhamento no terminal
A ativação é uma flag em um arquivo settings.json. Na prática, a flag só na pasta do projeto não bastou: o Claude Code imitava o time, mas usava o agente principal como barramento. Repetir a configuração no settings.json global, na home do usuário, resolveu, detalhe que a documentação não menciona.
Os agentes são definidos como nos subagentes: arquivos na pasta do projeto ou na global, ou um time descrito no próprio prompt, pedindo explicitamente que os pares certos conversem direto. Criar quatro agentes levou cerca de 10 minutos; trocar de subagentes para Agent Teams, cerca de 1 minuto.
No terminal, cada agente aparece como um ícone com arroba e o nome do papel, cinza quando parado e colorido quando trabalhando; clicar nele mostra o log com as mensagens trocadas. O tmux permite uma aba por agente.
Custo de tokens e quando compensa
O ganho vem com custo de tokens bem maior. No bolão, os subagentes usaram cerca de 50 mil tokens e o Agent Teams cerca de 100 mil. A proporção não é fixa e varia com o volume de conversa, que chegou a cerca de 10 mensagens em dois minutos. Cada mensagem custa duas vezes: um agente gera o texto e o outro o interpreta dentro de todo o seu contexto. Cerca de três testes consumiram por volta de 35% de uma janela de uso de 5 horas.
O paradoxo se resolve pela linha de base. Contra subagentes forçados a conversar pelo principal, com três partes por troca, o Agent Teams economiza. Contra o subagente padrão, que não conversa com ninguém, gasta mais, porque cria uma comunicação que não existia.
A escolha de modelo por agente reduz a conta: um modelo mais capaz no team lead e um mais barato nos teammates. Nem todo projeto justifica o gasto.