Equipes de agentes do Claude Code: como configurar e usar
Atualizado 2026-11
TL;DR: As equipes de agentes do Claude Code permitem que uma sessão do Claude Code atue como líder da equipe: ela cria uma lista de tarefas, inicia colegas e os coordena, enquanto cada colega trabalha na própria janela de contexto e pode mandar mensagens para os outros. O recurso é experimental e vem desativado. Ative com uma única configuração, descreva no prompt a equipe que você quer e fale diretamente com qualquer colega.

Captura da página oficial da documentação do Claude Code sobre equipes de agentes.
O que são as equipes de agentes do Claude Code?
As equipes de agentes do Claude Code são um recurso que permite coordenar várias instâncias do Claude Code trabalhando juntas em um mesmo projeto. A Anthropic lançou o recurso em fevereiro de 2026 e, em novembro de 2026, a documentação ainda o marca como experimental e desativado por padrão. Uma sessão vira a líder e as outras viram colegas, então 1 prompt pode iniciar uma pequena equipe que planeja, divide o trabalho e presta contas.
Isso permite montar uma equipe completa de agentes que trabalha dentro do Claude Code exatamente como uma equipe normal trabalharia.
Você tem uma lista de tarefas, pode atribuir tarefas aos colegas e eles vão lá e fazem. Em vez de uma única instância do Claude Code cuidar de tudo, agora você pode colocar vários agentes especializados em um só projeto. Cada um tem um papel diferente e habilidades diferentes, e todos trabalham juntos sem atrapalhar uns aos outros.
É a diferença entre contratar um freelancer e montar uma equipe de verdade.
Com as equipes de agentes do Claude, você pode rodar vários agentes diferentes ao mesmo tempo.
Um agente fica sobrecarregado; vários agentes dividem e conquistam, e o agente líder garante que ninguém duplique trabalho nem crie conflitos.
Como o líder da equipe trabalha
O líder da equipe é a conversa principal, a parte da equipe de agentes que transforma o seu prompt em trabalho. Nas demonstrações de fevereiro de 2026, o líder leu o código, escreveu uma lista de tarefas e iniciou 3 agentes em paralelo em poucos minutos. A documentação descreve o mesmo papel: o líder coordena o trabalho, atribui tarefas e reúne os resultados, enquanto os colegas trabalham de forma independente e se comunicam diretamente.
O líder da equipe é quem vai coordenar todos os agentes entre si.
Não é só mais um trabalhador. É o coordenador.
Ele enxerga o projeto inteiro. Sabe o que cada colega está fazendo. Percebe conflitos antes que aconteçam. Redistribui tarefas quando as prioridades mudam.
No fundo, você está dando instruções a um gerente de projeto, que depois gerencia a equipe de execução.
O líder cria uma lista mestra de tarefas e atribui as primeiras com base nas dependências. Assim, um especialista começa primeiro porque todos os outros precisam do resultado dele. Quando um especialista termina, marca a tarefa como concluída. O próximo desenvolvedor vê que está pronta e pega a próxima tarefa. Sem atraso, sem confusão, sem ficar pedindo atualização.
Como ativar as equipes de agentes do Claude Code
Ativar as equipes de agentes é uma mudança de 1 linha, porque o recurso ainda é um experimento em que você precisa entrar por conta própria. Em novembro de 2026, a documentação oficial manda definir a variável de ambiente CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS como 1, no seu shell ou no bloco env do settings.json. Depois disso, você já pode criar equipes.
- Abra o seu arquivo de configurações do Claude. Ele fica na sua pasta de usuário, dentro da pasta do Claude, e se chama settings.json.
- Adicione a linha
"CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"dentro deenv. Isso diz que é um recurso experimental e que você aceita testá-lo. - Inicie o Claude Code e descreva com palavras simples a equipe que você quer.
- Veja o líder criar a lista de tarefas e iniciar os colegas.
A configuração leva literalmente dois minutos. Você não dá instruções a cada agente separadamente. Você dá instruções ao líder, como se estivesse explicando o trabalho a um líder de equipe da sua empresa.

Captura da página de equipes de agentes na documentação oficial do Claude Code.
Seu primeiro prompt para uma equipe de agentes
Um primeiro prompt para uma equipe de agentes é um briefing curto que diz o objetivo, os papéis e o que significa terminar. Uma demonstração de fevereiro de 2026 usou 3 papéis em um mesmo recurso: um agente de PRD, um designer de UI e um redator de blog. Você explica o projeto. Explica os objetivos. Explica como é o sucesso. Depois diz de que tipo de especialista precisa.
Monte uma equipe de dois agentes para criar uma calculadora.
O agente de PRD cria a documentação de requisitos do produto com base no que você passa, o designer de UI faz o protótipo da interface e há um redator de blog. Assim, toda vez que você adiciona um recurso novo, um blog novo é escrito. Como você vê, o agente já começou a entender o código e a montar a equipe.
Dá para ver que ele começou a iniciar três agentes em paralelo e a atribuir tarefas a eles. A melhor parte é que tudo acontece em paralelo. Outra demonstração seguiu o mesmo padrão: você pede uma equipe de agentes com um desenvolvedor de front end, um de back end e QA. Ele define as dependências das tarefas, atribui responsáveis e inicia esses agentes.
Deixar muito claro como o líder também deve agir é a forma de criar boas equipes de agentes. Por exemplo, que ele atribua 6 tarefas, seja bem claro e pergunte antes de se encerrar. Depois, defina restrições suficientes: o que precisa ser feito e onde, e como cada tarefa é considerada concluída.
Equipes de agentes vs. subagentes
Equipes de agentes e subagentes são duas formas de dividir o trabalho no Claude Code, e a diferença está em quem fala com quem. Na documentação de novembro de 2026, os subagentes só devolvem resultados ao agente principal, enquanto os colegas compartilham 1 lista de tarefas, pegam trabalho e trocam mensagens diretamente. Por isso subagentes são melhores para tarefas focadas, e equipes para trabalho que exige discussão.
A diferença mais importante entre subagentes e uma equipe de agentes é que, com subagentes, você depende de cada agente terminar o trabalho e voltar ao agente principal
Isso obriga você a gerenciar muito os agentes. Funciona bem para tarefas simples, mas não quando você tenta fazer várias coisas ao mesmo tempo. Nesse caso, você continua sendo o gargalo enquanto o agente principal estiver no meio.
Numa equipe de agentes, a conversa principal vira o seu líder de equipe. Ela cria a lista de tarefas, atribui as tarefas e deixa você falar com cada colega separadamente. Não precisa ser o agente 1 passando para o agente 2 e o agente 2 passando para o agente 3, porque talvez isso nem peça uma equipe de agentes. Equipes de agentes trabalham juntas em paralelo e precisam se comunicar o tempo todo.
Como falar com cada colega
Falar diretamente com um colega é um dos principais motivos para usar uma equipe de agentes em vez de uma única sessão longa. Desde o lançamento de fevereiro de 2026, você pode mandar mensagem a qualquer colega sem passar pelo líder, e a documentação traz 2 modos de exibição. O modo em processo funciona em qualquer terminal, e os painéis divididos exigem tmux ou iTerm2.
Uma das vantagens das equipes de agentes é que você pode mandar mensagem para um subagente individualmente, se quiser.
Com o Claude Code rodando num terminal tmux, o desenvolvedor de front end acabou de ser criado aqui, e ele é o agente azul. Aqui está outro, o desenvolvedor de back end, que é o agente verde. E lá vem o agente de QA, o amarelo.
Você consegue ver com muita clareza o que cada um desses agentes está fazendo, o que é muito legal.

Quadro de uma demonstração: um líder e três colegas em painéis separados do tmux.
Você pode vir aqui e falar com o desenvolvedor de front end. Pode aprovar coisas ou passar mais informações. Na visualização em processo, dá para entrar em cada agente separadamente: por exemplo, ir até o redator de blog e pedir mais dois blogs sobre o recurso de 401k, e isso vai só para o redator de blog. Você vê que todos os outros agentes ficam ociosos.
Quando o trabalho termina, basta pedir ao líder que encerre a equipe de agentes. Ao encerrar, ele avisa a equipe inteira: trabalho feito, tchau. E você vê que os três colegas foram encerrados.
Três regras para uma boa equipe de agentes
Uma boa equipe de agentes é a que segue 3 regras simples, e elas importam mais do que o tamanho da equipe. Elas vêm de uma explicação de setembro de 2026 e combinam com a orientação oficial de dar arquivos diferentes a cada colega. A primeira é que cada agente tem o seu território: deve ter o próprio arquivo e trabalhar nas próprias entregas.

Quadro de um slide de demonstração com as três regras.
Eles podem enviar o trabalho uns aos outros e se comunicar, mas cada um só deve editar a própria parte. A segunda é, de novo, a mensagem direta: eles podem conversar entre si sem usar a sessão principal como intermediária. E a terceira é que podem trabalhar ao mesmo tempo.
Limites das equipes de agentes do Claude Code
Os limites das equipes de agentes do Claude Code são poucos e claros, e a maioria vem do fato de o recurso ainda ser experimental. A documentação de novembro de 2026 cita problemas conhecidos na retomada de sessões, na coordenação de tarefas e no encerramento, e permite 1 equipe por sessão, sem equipes aninhadas. O líder também não muda durante a sessão. Conhecer esses limites antes da primeira execução grande evita recomeços confusos.
- Você só pode ter uma equipe por sessão, e os colegas não podem criar as próprias equipes.
- O líder com que você começa continua líder até a sessão acabar.
- Os colegas começam com as configurações de permissão do líder.
- Ao retomar uma sessão, os colegas em processo nem sempre voltam.
Rodar várias sessões lado a lado não é novidade. Uma demonstração rodou 6 sessões separadas do Claude em paralelo para criar um CRM de vendas completo para uma empresa, e terminou assim:
E tudo funciona com um prompt, um prompt com um ou dois erros no final.
Eram seis sessões paralelas, não o recurso oficial. As equipes de agentes acrescentam o líder, a lista de tarefas compartilhada e as mensagens diretas. Um ótimo uso é construir rapidamente o front end e o back end de um recurso na mesma equipe. A documentação oficial cita usos parecidos: pesquisa e revisão, novos módulos ou recursos, depuração com hipóteses concorrentes e mudanças que atravessam várias camadas.
Use as equipes de agentes do Claude Code com o Pachat
Uma equipe de agentes são várias sessões do Claude Code trabalhando dentro do seu projeto, e o Pachat é o lugar onde você pode colocar IAs diferentes juntas. O Pachat é um produto web em pachat.ai, descrito no site como «Different personal AI agents, in one group chat» (diferentes agentes de IA pessoais, em um só chat de grupo).
- Deixe a sua equipe de agentes do Claude Code terminar a tarefa e escrever o resultado.
- Abra o pachat.ai e coloque o seu Claude, Grok Bot, Muse e ChatGPT em um só chat de grupo.
- Pergunte ao grupo sobre o plano ou o resultado. Eles conferem os fatos uns dos outros e discutem, e depois você decide.
Para ver como o Claude Code é descrito ao lado de outros agentes, leia a página do agente Claude Code, o caso de uso de Codex e Claude Code e o guia da sua primeira tarefa no Claude Code.
Perguntas frequentes
O que são as equipes de agentes do Claude Code?
São um recurso que coordena várias instâncias do Claude Code em um mesmo projeto. Uma sessão é a líder da equipe, que cria a lista de tarefas, atribui o trabalho e junta os resultados. Cada colega trabalha na própria janela de contexto e pode mandar mensagens diretamente para os outros. O recurso chegou em fevereiro de 2026 e ainda é experimental em novembro de 2026, então fica desligado até você ativá-lo.
Como ativo as equipes de agentes no Claude Code?
Defina a variável de ambiente CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS como 1. Você pode exportá-la no shell ou adicioná-la ao bloco env do seu arquivo settings.json. Depois, inicie o Claude Code e peça que ele crie uma equipe de agentes com os papéis que você quer. A documentação de novembro de 2026 descreve essa 1 configuração como a única chave necessária antes da primeira equipe.
Qual a diferença entre equipes de agentes e subagentes?
Os subagentes rodam dentro de uma sessão e só devolvem os resultados ao agente principal. Os colegas de uma equipe compartilham uma lista de tarefas, pegam trabalho e trocam mensagens diretamente, e você pode falar com qualquer um deles. A documentação de 2026 sugere subagentes para tarefas focadas em que só o resultado importa, e equipes para trabalho complexo que precisa de discussão entre 2 ou mais agentes.
Posso falar com um colega sem passar pelo líder?
Sim. No modo de exibição em processo, use as setas para escolher um colega e digite a mensagem; no modo de painéis divididos, clique no painel desse colega. Em novembro de 2026, os painéis divididos exigem tmux ou iTerm2. Uma mensagem enviada assim chega só a esse 1 colega, enquanto os outros ficam ociosos ou seguem com as próprias tarefas.
Que tipo de trabalho combina com uma equipe de agentes?
Combina o trabalho que pode ser dividido em partes que andam ao mesmo tempo e ainda assim precisam se comunicar. A documentação de 2026 cita 4 casos fortes: pesquisa e revisão, novos módulos ou recursos, depuração com hipóteses concorrentes e mudanças que atravessam front end, back end e testes. Para uma mudança pequena em um único arquivo, uma sessão ou um subagente costuma bastar.
O Pachat roda equipes de agentes do Claude Code?
Não, eles fazem trabalhos diferentes. As equipes de agentes são sessões do Claude Code dentro do seu próprio projeto. O Pachat é um produto web em que você coloca o seu Claude, Grok Bot, Muse e ChatGPT em um só chat de grupo, e eles conferem os fatos uns dos outros e discutem, e depois você decide. Em 2026 você pode usar os dois: deixe uma equipe terminar a tarefa e leve o resultado ao pachat.ai.
Quer colocar IAs diferentes em um só chat de grupo? Comece em pachat.ai.
Referências
- Claude Code Docs, "Orchestrate teams of Claude Code sessions," fetched 2026-11-18: https://code.claude.com/docs/en/agent-teams
- @akshatbahety, 2026-02-21: https://x.com/akshatbahety/status/2025269286357618991
- @catmanyau, 2026-09-16: https://x.com/catmanyau/status/2100057764995174565
- @danhergir, 2026-02-25: https://x.com/danhergir/status/2026699963586245088
- @SEOMastery2026, 2026-02-09: https://x.com/SEOMastery2026/status/2020907067578646964
- @JulianGoldieSEO, 2026-02-14: https://x.com/JulianGoldieSEO/status/2022603591199133779
- @rick_boers, 2026-02-07: https://x.com/rick_boers/status/2020154972936220735



