Controlos de Equipas de Agentes

Problema: Ativaste as Equipas de Agentes Claude Code e a tua primeira equipa está a funcionar. Mas o líder continua a fazer o trabalho ele próprio em vez de delegar. Os colegas editam os mesmos ficheiros. Não consegues ver em que é que cada um está a trabalhar. Os controlos para resolver cada um desses problemas existem. É que não são óbvios à partida.

Vitória Rápida: Pressiona Shift+Tab logo após iniciar uma equipa para entrar no modo delegado. O líder para de tocar no código e foca-se na coordenação.

Nota: Este é um guia complementar ao guia de visão geral das Equipas de Agentes. Começa por lá se ainda não configuraste uma equipa.

Modos de Exibição

As Equipas de Agentes dão-te dois modos de exibição que mudam como monitorizas e interages com os colegas.

Modo In-Process (Padrão)

Todos os colegas correm dentro do teu terminal principal. Moves-te entre eles com atalhos de teclado:

Funciona em qualquer terminal. Sem configuração extra, sem dependências. Vês o output de um colega de cada vez e mudas entre eles quando precisas. Para a maioria dos fluxos de trabalho, o modo in-process cobre tudo.

Modo Split Pane

Cada colega tem o seu próprio painel de terminal. Vês o output de todos lado a lado e clicas em qualquer painel para interagir diretamente. Útil quando queres ver vários colegas a trabalhar num problema difícil ao mesmo tempo.

O modo split pane precisa de tmux ou iTerm2. No macOS, tmux -CC dentro do iTerm2 é o ponto de entrada recomendado. Importante: o modo split-pane NÃO é suportado no terminal integrado do VS Code, Windows Terminal, ou Ghostty. O tmux tem lacunas de compatibilidade conhecidas em alguns sistemas operativos e funciona melhor no macOS.

Configura o teu modo preferido através do settings.json:

Três opções:

• "auto" (padrão) usa painéis divididos quando já estás a correr dentro do tmux, caso contrário volta ao in-process
• "tmux" ativa painéis divididos e deteta automaticamente se estás no tmux ou iTerm2
• "in-process" força tudo para o teu terminal principal

Substitui por sessão com o flag CLI:

Modo Delegado

Sem modo delegado, o líder às vezes começa a implementar tarefas ele próprio em vez de esperar pelos colegas. Isso derrota o objetivo. Disseste-lhe para coordenar. Ele pegou numa chave inglesa e começou a construir.

Pressiona Shift+Tab para entrar no modo delegado depois de iniciar uma equipa. Isto restringe o líder a ferramentas apenas de coordenação: criar colegas, enviar mensagens, desligá-los e gerir tarefas. O líder não pode tocar no código diretamente. Fica totalmente na orquestração.

Usa o modo delegado quando queres que o líder atue como gestor de projeto em vez de contribuidor individual. Isto importa mais em equipas maiores, onde o trabalho inteiro do líder é coordenação. Na prática, ativar o modo delegado para sessões com 4+ colegas reduz visivelmente o consumo desnecessário de contexto do líder e impede-o de competir com os seus próprios colegas pelo trabalho.

Se o líder está a avançar enquanto os colegas ainda estão a trabalhar, podes dizer-lhe diretamente: "Espera que os teus colegas completem as suas tarefas antes de continuar." Às vezes um empurrão em linguagem natural resolve. Mas para um comportamento consistente entre sessões, o modo delegado aplica a restrição automaticamente.

Fluxo de Aprovação de Planos

Para tarefas complexas ou arriscadas, exige que os colegas planeiem antes de implementar qualquer coisa. O colega trabalha em modo de plano apenas de leitura até o líder rever e aprovar a abordagem.

O fluxo de trabalho:

1. O colega recebe a tarefa e entra em modo apenas de leitura
2. O colega cria um plano e envia um pedido de aprovação de plano ao líder
3. O líder revê o plano e aprova ou rejeita com feedback
4. Se rejeitado, o colega fica em modo de plano, revisa e volta a submeter
5. Uma vez aprovado, o colega sai do modo de plano e começa a implementação

O líder toma decisões de aprovação de forma autónoma. Molda o seu julgamento através do prompt inicial. Diz-lhe "aprova apenas planos que incluam cobertura de testes" ou "rejeita planos que modifiquem o schema da base de dados sem uma migração." O líder aplica essas regras como filtro em cada plano que recebe.

O modo de plano é especialmente valioso quando os colegas trabalham em infraestrutura partilhada, tocam em schemas de base de dados, ou fazem alterações que são caras de reverter. O custo do planeamento é uma fração do custo de reverter uma má implementação em múltiplos ficheiros. Para uma visão mais aprofundada de como a aprovação de planos se integra numa fase de planeamento estruturado, ver o fluxo de trabalho de ponta a ponta.

Hooks para Gates de Qualidade

As Equipas de Agentes integram-se com o sistema de hooks do Claude Code para verificações de qualidade automatizadas. Dois hooks são construídos especificamente para fluxos de trabalho em equipa:

TeammateIdle: Corre quando um colega está prestes a ficar inativo. Sai com código 2 para enviar feedback e manter o colega a trabalhar. Usa isto para atribuir tarefas de seguimento automaticamente ou redirecionar um colega que terminou cedo. Se um colega fechar a sua tarefa principal enquanto outros ainda estão a trabalhar, um hook TeammateIdle pode encaminhá-lo para tarefas de revisão ou limpeza sem qualquer passo manual.

TaskCompleted: Corre quando uma tarefa está a ser marcada como completa. Sai com código 2 para bloquear a conclusão e enviar feedback. Usa isto para aplicar gates de qualidade: exige que os testes passem, as verificações de lint tenham sucesso, ou critérios de aceitação específicos sejam cumpridos antes de uma tarefa poder fechar.

Estes hooks permitem construir gates de qualidade estruturados sem monitorizar cada colega manualmente. Um hook TaskCompleted que corre a tua suite de testes significa que nenhuma tarefa fecha com testes a falhar, independentemente de qual colega escreveu o código. Para um guia completo do sistema de hooks e configuração, ver o guia de hooks.

Mensagens Diretas a Colegas

Cada colega é uma sessão Claude Code completa e independente. Podes enviar mensagens a qualquer colega diretamente sem passar pelo líder.

Modo in-process: Usa Shift+Up/Down para selecionar um colega, depois escreve para enviar uma mensagem. Pressiona Enter para ver a sessão completa de um colega e ver tudo o que fizeram. Pressiona Escape para interromper a sua volta atual se estiverem a seguir o caminho errado.

Modo split-pane: Clica no painel de um colega para interagir com a sua sessão diretamente. Cada painel comporta-se exatamente como uma sessão Claude Code independente.

Isto é útil quando queres redirecionar um colega específico, dar contexto adicional que o líder não tem, ou fazer uma pergunta de acompanhamento direcionada. Às vezes o caminho mais rápido é falar diretamente com o trabalhador em vez de passar por um coordenador.

Gestão de Tarefas

A lista de tarefas partilhada coordena cada peça de trabalho em toda a equipa. O líder cria tarefas e os colegas trabalham nelas. As tarefas têm três estados: pendente, em progresso, e concluída. As tarefas podem depender de outras tarefas. Uma tarefa pendente com dependências não resolvidas não pode ser reclamada até que essas dependências se completem. Isto espelha os padrões de cadeia de dependências da orquestração de equipas.

O líder pode atribuir tarefas explicitamente a colegas específicos, ou os colegas podem reclamar o que estiver disponível. Depois de terminar uma tarefa, um colega pega na próxima tarefa não atribuída e desbloqueada sozinho. Esse comportamento de auto-reclamação mantém a equipa em movimento sem intervenção constante do líder.

A reclamação de tarefas usa bloqueio de ficheiros para bloquear condições de corrida em que dois colegas apanham a mesma tarefa simultaneamente. O sistema trata as dependências de tarefas automaticamente: quando um colega termina uma tarefa de que outros dependem, as tarefas bloqueadas desbloqueiam sem ação manual. Um colega à espera de uma dependência começa a trabalhar no momento em que essa dependência se resolve.

Para mais sobre padrões de coordenação de tarefas, ver distribuição de tarefas e fluxos de trabalho de todo.

Tamanho da Equipa e Seleção de Modelo

Claude escolhe o número de colegas com base na complexidade da tua tarefa, ou podes especificar exatamente o que queres:

Também podes misturar modelos dentro de uma única equipa. Corre o líder em Opus para coordenação estratégica enquanto os colegas correm em Sonnet para implementação focada. Isso equilibra custo com capacidade. O líder precisa de raciocínio forte para decomposição de tarefas e aprovação de planos. Os colegas que fazem trabalho de implementação com âmbito definido muitas vezes funcionam bem em Sonnet a uma fração do custo.

Para respostas do líder ainda mais rápidas durante fases com muita coordenação, combina equipas de agentes com o modo rápido.

Gestão de Custo em Tokens

As Equipas de Agentes consomem significativamente mais tokens do que uma única sessão. Cada colega corre a sua própria janela de contexto, e o uso de tokens escala com os colegas ativos. Quando os colegas correm em modo de plano antes da implementação, espera cerca de 7x os tokens de uma sessão padrão para essa fase.

Para onde vão os tokens:

• Cada colega carrega contexto do projeto de forma independente (CLAUDE.md, skills, ficheiros do projeto)
• A comunicação adiciona custo: cada mensagem entre agentes consome tokens no contexto tanto do emissor como do recetor
• A transmissão multiplica o custo pelo número de colegas que recebem a mensagem
• O líder consome tokens para coordenação, gestão de tarefas e síntese de resultados

Quando o custo vale a pena:

• Tarefas de pesquisa e revisão onde múltiplas perspetivas detetam problemas que uma única passagem perderia
• Sessões de debug onde o teste paralelo de hipóteses resolve problemas mais rápido do que adivinhar sequencialmente
• Implementações de funcionalidades grandes onde a economia de tempo justifica o gasto em tokens
• Decisões arquiteturais onde uma avaliação completa previne erros caros mais tarde

Quando manter os custos baixos:

• Usa Sonnet para colegas que fazem trabalho de implementação focado e reserva Opus para o líder
• Prefere mensagens diretas a transmissões quando possível
• Limita o tamanho da equipa ao que a tarefa realmente precisa (3 colegas é muitas vezes melhor que 6)
• Usa subagentes ou sessões individuais para tarefas de rotina que não precisam de comunicação entre agentes
• Define âmbito claro para cada colega para prevenir exploração desnecessária

Linha de orientação aproximada: Uma equipa de 3 colegas a correr durante 30 minutos consome aproximadamente 3-4x os tokens de uma sessão individual a fazer o mesmo trabalho sequencialmente. A troca é velocidade e cobertura versus custo.

Otimização do CLAUDE.md para Equipas

Cada colega carrega o teu CLAUDE.md no início com uma janela de contexto nova. A discussão anterior do líder não passa para os colegas, por isso a qualidade do CLAUDE.md importa tanto para equipas. Se o CLAUDE.md for vago, cada colega desperdiça tokens a re-explorar o código por conta própria. Três colegas a carregar contexto em simultâneo significa 3x o custo de tokens se esse contexto exigir exploração em vez de uma leitura rápida.

Três regras tornam as equipas de agentes visivelmente mais eficazes:

Regra 1: Descreve os Limites dos Teus Módulos

Quanto mais claros forem os limites dos teus módulos no CLAUDE.md, mais inteligentemente Claude divide o trabalho entre colegas. Usa uma tabela:

Quando dizes ao Claude para "criar uma equipa e dividir por posse de ficheiros," ele lê a estrutura e atribui listas explícitas de ficheiros a cada colega. Zero conflitos.

Regra 2: Mantém o Contexto do Projeto Curto e Operacional

Stack, ponto de entrada, comando de teste, base de dados. Leituras rápidas, não explorações.

Nenhum colega deve precisar de perguntar ao líder do que se trata o projeto ou onde vivem os ficheiros. Cada ronda de "que framework é este?" consome tokens tanto no contexto do colega como no contexto do líder quando responde.

Regra 3: Define o que "Verificado" Significa

Quando o CLAUDE.md lista como verificar que as coisas funcionam, os colegas usam esses sinais para auto-verificar o seu próprio trabalho antes de reportar.

Claude adapta a verificação por tarefa. Para uma tarefa de limpeza, os colegas podem usar grep para verificar remoções. Para uma funcionalidade, correm a suite de testes. Ter gates de todo o projeto dá ao líder um vocabulário para "concluído" que pode aplicar automaticamente.

Com regras claras no CLAUDE.md, os colegas reportam exatamente o que fizeram sem intervenção do líder. Regras claras dentro, relatórios claros fora. Para mais sobre como moldar os teus ficheiros de projeto, ver CLAUDE.md mastery.

Juntando Tudo

Tens agora os controlos para gerir equipas de agentes eficazmente. Começa com o modo delegado na tua próxima sessão de equipa e sente a diferença que faz no comportamento do líder. Adiciona um hook TaskCompleted para aplicar a tua suite de testes. Escreve limites de módulos no teu CLAUDE.md e deixa Claude dividir o trabalho automaticamente.

Para prompts do mundo real que podes copiar e adaptar, ver Casos de Uso e Modelos de Prompt das Equipas de Agentes. Para resolução de problemas comuns e limitações atuais, ver Boas Práticas das Equipas de Agentes. Para o fluxo de trabalho completo de planeamento a produção que une estes controlos, ver o guia de fluxo de trabalho de ponta a ponta.