Subagentes do Claude Code: quando usar e como configurar
Atualizado 2026-11
TL;DR: Subagentes do Claude Code são IAs especialistas que tiram uma tarefa da sessão principal. Cada um tem seu próprio contexto, instruções e ferramentas, e devolve só um resumo. Eles brilham quando você quer avançar trabalho independente em paralelo; evite passar um plano de design de um subagente para o outro como numa corrente de baldes.

Captura de tela da página de subagentes na documentação oficial do Claude Code.
O que são subagentes do Claude Code?
Subagentes do Claude Code são IAs que atuam como especialistas num tipo de tarefa. Em novembro de 2026, a documentação oficial diz que cada um roda na sua própria janela de contexto, com um prompt de sistema próprio e acesso a ferramentas específicas. Eles mantêm a conversa principal limpa e devolvem só um resumo ao terminar, então 1 chat longo não precisa mais carregar tudo.
Se você vai adicionando funções à sua IA, o prompt pode ficar tão enorme que ela começa a ficar instável. O que causa isso?
É porque você está enfiando design, desenvolvimento e testes numa única IA. Nem uma pessoa consegue fazer tudo isso perfeitamente sozinha. O importante é dividir os papéis com a ideia de subagentes.
Então é como montar uma equipe de especialistas, cada um focado numa tarefa específica.
A precisão e a facilidade de manutenção sobem muito.
Cada IA consegue focar no próprio trabalho, então as alucinações que parecem verdade também diminuem. No fundo, é dividir o trabalho em partes menores.
3 casos em que os subagentes ajudam
Os casos em que os subagentes ajudam são trabalhos que costumam confundir um único agente. Um vídeo explicativo de novembro de 2026 citou dois principais: quando você quer avançar trabalho independente em paralelo e quando há ferramentas MCP, skills ou instruções demais para um só agente escolher bem. Trabalho em que cada passo depende do anterior não combina.
O terceiro caso é quando um único agente tem dificuldade para resolver conflitos na escolha de ferramentas ou nas instruções.
Quando há muitas ferramentas MCP, subagentes ou skills para escolher, um único agente tem dificuldade para escolher e chamar a certa. Aí você separa as responsabilidades e passa esse trabalho para um subagente.
De qualquer forma, o principal é o segundo: use quando quiser avançar trabalho independente em paralelo.
Um cuidado: mesmo para trabalho independente, como montar um plano de design, evite usar os subagentes como uma corrente de baldes, passando o trabalho de um para o outro.
Como criar um subagente
Criar um subagente é escrever um arquivo Markdown. Em novembro de 2026, a documentação oficial coloca no topo as configurações em YAML (name, description, tools, model) e embaixo o prompt de sistema, salvo em .claude/agents/ para um projeto ou em ~/.claude/agents/ para todos. Você também pode pedir ao Claude que escreva e depois ajustar ao seu projeto.
Se você der a cada agente um papel claro e uma definição clara de pronto, até projetos complexos podem ser concluídos sem problemas.
Mais do que habilidade técnica, o que importa é o quão concretamente você consegue colocar seu fluxo de trabalho humano em palavras.
Comece tornando seu trabalho visível e decidindo quais partes vão para os subagentes. Acumule pequenas vitórias e comece com uma configuração simples de 2 agentes.
Rode subagentes em paralelo
O padrão orquestrador-trabalhador é um jeito de trabalhar em que o agente principal planeja e distribui partes do trabalho para vários subagentes que rodam em paralelo. Um vídeo de novembro de 2026 descreveu isso como uma forma de reduzir o tempo de trabalho e ao mesmo tempo ampliar o que é coberto. Você pode iniciar só pedindo com suas palavras, sem sintaxe especial.
A partir daí você espalha subagentes, inicia em paralelo e coloca para trabalhar em paralelo por ângulos diferentes.
Isso encurta o trabalho e amplia o alcance. E mantém o agente principal focado no design e nas etapas iniciais do trabalho, não na execução.
Digite o pedido para os subagentes direto na caixa de texto, com suas próprias palavras.
Se você disser "faça estas 30 tarefas com 30 subagentes", ele faz. O agente com quem você fala é o agente pai. Os subagentes são como filhos que ele cria e coloca para trabalhar.

Quadro de um vídeo que explica como passar trabalho para um subagente dedicado.
Subagentes versus o consultor
O consultor é um recurso que deixa o Claude consultar um modelo mais forte em momentos-chave de uma tarefa. Em novembro de 2026, a documentação oficial o marca como experimental e ele é ativado com o comando /advisor. Muita gente confunde com subagentes, mas o que ele vê e o que ele faz são diferentes, como se explica com clareza neste vídeo.
O consultor lê a conversa inteira. Mas não mexe em nada. Só devolve conselhos.
Há 3 momentos em que ele costuma ser consultado: antes de decidir uma abordagem, quando o mesmo erro se repete e antes de dizer que terminou. O Claude decide quando perguntar.
O consultor vê a conversa inteira; um subagente vê só o pedido.
A outra diferença é o que fazem. O consultor só fala. Um subagente assume o trabalho inteiro. Quanto mais longa a tarefa, mais ajuda um consultor que lembra da conversa. Pesquisa vai para os subagentes; decisões difíceis, para o consultor.
Some outra visão com o Pachat
Pachat é um produto web em pachat.ai, descrito no site como "Different personal AI agents, in one group chat." Os subagentes dividem o trabalho dentro de uma ferramenta; o Pachat é um lugar para fazer a mesma pergunta a IAs diferentes.
- Escreva o design dos seus subagentes ou seu plano para dividir o trabalho.
- Abra o pachat.ai e coloque seus pontos do Claude, Grok Bot, Muse e ChatGPT num mesmo chat em grupo.
- Cole o plano e pergunte se a divisão faz sentido. Eles conferem os fatos uns dos outros e discutem, e no fim quem decide é você.
Leia mais em como usar o Claude Code, equipes de agentes do Claude Code e controle remoto do Claude Code.
Perguntas frequentes
Qual a diferença entre subagentes e equipes de agentes?
Subagentes trabalham dentro de uma única sessão e só devolvem um resumo para a conversa principal ao terminar. Em novembro de 2026, a documentação oficial indica equipes de agentes quando você precisa de várias sessões que conversam entre si e se coordenam, e agentes em segundo plano quando precisa de sessões independentes em paralelo.
Onde ficam salvos os subagentes do Claude Code?
São arquivos Markdown. Coloque em .claude/agents/ para o projeto atual ou em ~/.claude/agents/ para todos os seus projetos. Em novembro de 2026, o Claude Code observa essas pastas, então as edições valem em poucos segundos sem reiniciar. Em equipe, coloque a pasta do projeto no controle de versão para todos usarem os mesmos subagentes.
O comando /agents ainda funciona?
Em novembro de 2026, a documentação diz que /agents abre uma tela interativa na v2.1.197 e anteriores, enquanto as versões novas mostram um lembrete para pedir ao Claude ou editar .claude/agents/ diretamente. O mais fácil é pedir ao Claude algo como "crie um subagente revisor de código somente leitura".
Posso limitar quais ferramentas um subagente usa?
Sim. Liste só as ferramentas permitidas no campo tools do YAML, por exemplo Read, Grep e Glob, e você terá um subagente somente leitura. A documentação oficial também descreve 3 subagentes integrados: Explore para buscas rápidas somente leitura, Plan para planejamento e General-purpose para trabalho de vários passos. Em 2026 o Explore é o somente leitura.
Quantos subagentes podem rodar ao mesmo tempo?
Se você dividir o trabalho em tarefas independentes, vários podem rodar em paralelo. Um vídeo de outubro de 2026 mostrou como pedir "estas 30 tarefas com 30 subagentes" em linguagem natural. Mas mantenha o trabalho em paralelo independente e evite correntes em que cada subagente espera o resultado do anterior.
O Pachat pode me ajudar a desenhar subagentes?
Sim. Pachat é um produto web em pachat.ai onde você coloca seus pontos do Claude, Grok Bot, Muse e ChatGPT num mesmo chat em grupo. Cole seu plano de divisão de papéis entre subagentes e peça a 3 ou mais IAs que encontrem lacunas ou sobreposições. Eles conferem os fatos uns dos outros e discutem, e no fim quem decide é você.
Pronto para colocar IAs diferentes num mesmo chat em grupo? Comece em pachat.ai.
Referências
- Claude Code Docs, "Create custom subagents," fetched 2026-11-18: https://code.claude.com/docs/en/sub-agents
- Claude Code Docs, "Escalate hard decisions with the advisor tool," fetched 2026-11-18: https://code.claude.com/docs/en/advisor
- @kee11nig, 2025-07-30: https://x.com/kee11nig/status/1950352602660520410
- @akalink_soma, 2026-04-27: https://x.com/akalink_soma/status/2048561651532837346
- @papaneco_life, 2026-10-01: https://x.com/papaneco_life/status/2105642379437060530
- @starriver0513, 2026-10-29: https://x.com/starriver0513/status/2115763904882032831
- @msyn_ai, 2026-11-07: https://x.com/msyn_ai/status/2119091969737855382
- @msyn_ai, 2026-11-12: https://x.com/msyn_ai/status/2120762814990340136



