Claude Code Agent Teams - Da Configuracao aos Atalhos

O Claude Code Agent Teams foi lancado junto com a versao Opus 4.6. Sinceramente, considero o recurso ineficiente neste estagio - o consumo de tokens e alto e a sobrecarga de coordenacao e real.

Mas depois de ler o guia do Tom (@tomcrawshaw01), percebi que a arquitetura em si merece ser compreendida. Familiarizar-se com ela durante a fase de preview fara diferenca quando o recurso atingir disponibilidade geral.

Agentes Solo Agora Constroem Equipes

Um agente lider decompoe o trabalho e distribui entre multiplos colegas rodando em paralelo.

A diferenca principal em relacao a sub-agentes: os colegas trocam mensagens diretamente entre si. Em vez de apenas reportar resultados ao lider, eles compartilham descobertas e ate questionam o trabalho uns dos outros.

A Configuracao Leva 30 Segundos

O recurso e experimental, entao vem desativado por padrao. Uma unica linha o habilita.

Adicione CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS com o valor "1" no bloco env do seu settings.json. Voce tambem pode definir como variavel de ambiente do shell, mas o settings.json persiste entre sessoes e e mais conveniente.

Os Unicos Atalhos Que Voce Precisa

Com uma equipe em execucao, voce vai alternar entre o lider e os colegas para monitorar o progresso. Nao ha muito o que memorizar.

• Shift+Up / Shift+Down - Alternar entre colegas (modo in-process - e o que voce vai usar na maior parte do tempo)
• Enter - Ver detalhes da sessao do colega selecionado
• Escape - Interromper o turno atual do colega selecionado
• Ctrl+T - Alternar a lista de tarefas compartilhada
• Shift+Tab - Alternar o modo Delegate, que restringe o lider a apenas coordenar (sem programar)
• Modo split-pane - Clicar no painel de um colega para interagir diretamente

O modo Delegate e importante. Sem ele, o lider as vezes comeca a programar em vez de delegar para os colegas.

A Compatibilidade de Terminal Varia

O modo split-pane so funciona no tmux e no iTerm2. O terminal integrado do VS Code, Windows Terminal e Ghostty nao sao oficialmente suportados.

Se voce esta usando Ghostty, vai utilizar o modo in-process padrao com Shift+Up/Down para alternar entre colegas.

Para visualizar a saida dos colegas lado a lado, execute o Claude Code dentro de uma sessao tmux. O teammateMode padrao e "auto", entao ele muda automaticamente para split-pane quando detecta o tmux.

Tenho usado tmux new -s {meu-projeto} no iTerm, depois iniciando com claude --teammate-mode tmux. Isso da uma visao em tela cheia de toda a atividade da equipe.

Como as Tarefas Fluem

O trabalho e organizado em torno de uma lista de tarefas. O lider cria as tarefas e os colegas assumem cada uma delas.

• Quando o lider cria uma lista de tarefas, os colegas automaticamente reivindicam a proxima tarefa nao atribuida
• Dependencias entre tarefas sao suportadas - tarefas sucessoras sao desbloqueadas somente apos as predecessoras serem concluidas
• Voce pode atribuir tarefas especificas a colegas especificos instruindo o lider
• O encerramento dos colegas segue um protocolo: o lider envia uma solicitacao de shutdown, o colega confirma e entao encerra
• Para limpeza completa: confirme que todos os colegas foram encerrados e depois instrua o lider a fazer a limpeza

Um prompt simples que mencione “team” ja ativa o recurso automaticamente. Mas para um controle mais preciso, defina o numero total de colegas, atribua nomes e funcoes a cada um, delimite o escopo de delegacao e forneca um arquivo externo com regras de dependencia entre tarefas.

Os Tokens Acabam Mais Rapido do Que Voce Esperaria

Cada colega e uma sessao independente do Claude Code. Executa-los em paralelo escala os custos rapidamente. Algumas praticas ajudam.

• Escreva prompts especificos ao criar colegas. O historico de conversa do lider nao e transferido - apenas o CLAUDE.md e o contexto do servidor MCP sao carregados automaticamente
• Dois colegas editando o mesmo arquivo causarao sobrescrita. Particione o trabalho no nivel de arquivo
• Comece com pesquisa ou revisao de codigo em vez de geracao de codigo. A complexidade de coordenacao e menor
• Mantenha as unidades de tarefa pequenas e concretas - uma unica funcao ou um unico arquivo de teste funciona bem

Limitacoes Que Vale a Pena Conhecer Antes de Encontra-las

Isto e um preview. Arestas sao esperadas. Conhece-las antecipadamente evita frustracao.

• Usar /resume ou /rewind encerra os colegas em modo in-process. Voce precisara pedir ao lider para criar novos
• O status das tarefas pode atrasar. Se um colega conclui o trabalho mas nao marca a tarefa como concluida, as tarefas sucessoras permanecem bloqueadas. Verifique manualmente e peca ao lider para atualizar
• Apenas uma equipe por sessao. Colegas nao podem criar sub-equipes
• A sessao que cria a equipe permanece como lider. Nao e possivel trocar de lider ou promover colegas durante a sessao

O preview e rudimentar e a questao de custo-eficiencia permanece em aberto. Mas se voce quer entender para onde os fluxos de trabalho multi-agente estao caminhando, o caminho mais rapido e ativar o recurso e testa-lo por conta propria. Ferramentas exigem experiencia pratica para serem avaliadas adequadamente.