Melhores Subagentes do Claude Code em 2026 (e Como Criar os Teus)

Os melhores subagentes do Claude Code são papéis focados nos quais delegas: um planeador, um revisor de código, um testador, um depurador e um investigador. Cada um corre no seu próprio contexto com as suas próprias ferramentas, faz um trabalho bem feito e devolve um resultado limpo sem inundar a tua sessão principal. Defines-los como ficheiros Markdown na tua pasta .claude/agents/, e podes escrever os teus em poucos minutos.

Este guia ordena os papéis que vale a pena configurar primeiro e depois mostra-te exatamente como construir um personalizado.

O que é mesmo um subagente

Um subagente é um agente especializado ao qual a sessão principal do Claude Code pode entregar uma tarefa. Tem as suas próprias instruções, as suas próprias ferramentas permitidas e a sua própria janela de contexto fresca. Quando o agente principal delega, o subagente trabalha, devolve uma mensagem final e o seu output intermédio de ferramentas fica fora da tua conversa principal.

Essa última parte é a verdadeira vantagem. Uma pesquisa longa ou uma corrida de testes ruidosa podem comer o teu contexto principal. Um subagente absorve esse ruído e devolve só a conclusão. Para a fundamentação de design mais aprofundada, vê design de subagentes e boas práticas de subagentes.

Os 5 subagentes que vale a pena configurar primeiro

1. O planeador

Um planeador pega num pedido de funcionalidade e devolve um plano de construção ordenado, passo a passo: o que alterar, em que ordem e o que depende do quê. Corre-lo antes de escrever qualquer código. Impede o agente principal de se atirar a uma tarefa grande sem mapa. Junta-o ao desenvolvimento orientado por specs para os resultados mais fortes.

2. O revisor de código

Um revisor lê o diff com um só trabalho: encontrar bugs, falhas de segurança e padrões desleixados. O truque é que revê com olhos frescos e um prompt cético, por isso não fica enviesado pelo raciocínio que produziu o código. Dá-lhe ferramentas só de leitura e um prompt que lhe diga para, por defeito, sinalizar tudo o que for incerto.

3. O testador

Um testador escreve testes para o código novo e corre-os, e depois reporta passou ou falhou. Delegar isto mantém o passo de verificação honesto: o agente que escreveu a funcionalidade não é o que a avalia. As corridas de testes são também ruidosas, que é exatamente o tipo de output que um subagente deve absorver.

4. O depurador

Quando algo parte, um subagente depurador reproduz a falha, estreita-a e reporta a causa raiz. A depuração gasta muitas chamadas de ferramentas e becos sem saída, por isso isolá-la num subagente protege a tua sessão principal da confusão, sem deixar de resolver o problema.

5. O explorador

Um explorador pesquisa no teu código (ou na web) para responder a uma pergunta e devolve um resumo curto em vez de despejar cada ficheiro que leu. Quando responder significa varrer muitos ficheiros, é este o subagente que guarda a conclusão e deita fora o ruído. Vê distribuição de tarefas para perceberes como lançar vários destes ao mesmo tempo.

Como construir o teu próprio subagente

Um subagente é só um ficheiro Markdown em .claude/agents/. Aqui está um revisor de código completo e a funcionar que podes pôr a usar já.

---
name: code-reviewer
description: Reviews the current diff for bugs, security issues, and risky patterns. Use after writing or editing code, before committing.
tools: Read, Grep, Glob, Bash
---

You are a skeptical senior code reviewer. Review only the current diff.

Focus, in order:
1. Correctness bugs that would break at runtime.
2. Security issues: missing auth checks, unsafe input handling, leaked secrets, missing row-level security.
3. Risky patterns: duplicated logic, swallowed errors, untested edge cases.

Rules:
- Default to flagging anything you are unsure about.
- Quote the file and line for every finding.
- Do not rewrite the code. Report findings only.

Your final message is the review. Return a short list of findings, each with file, line, severity, and a one-line fix. If the diff is clean, say so plainly.

O frontmatter faz três coisas. name é o id do agente. description diz à sessão principal quando delegar nele, por isso escreve-a como um gatilho ("usar depois de escrever código"). tools limita aquilo a que ele pode tocar; um revisor só precisa de ler e pesquisar, por isso não recebe acesso de escrita.

O corpo é o system prompt. Mantém o papel estreito, lista as regras e termina dizendo ao agente que a sua mensagem final é o valor de retorno, para que devolva um resultado limpo em vez de um resumo conversado. Para mais sobre isto, vê agentes personalizados.

Três regras para bons subagentes

1. Um trabalho cada. Um subagente que faz duas coisas faz as duas pior. Divide-o.
2. Menos ferramentas. Dá-lhe só as ferramentas de que o trabalho precisa. Um revisor que não consegue escrever código não consegue alterá-lo por acidente.
3. Retornos limpos. Escreve o prompt para que a mensagem final seja exatamente os dados que a sessão principal quer, não um parágrafo sobre o que fez.

Acerta nisto e a tua sessão principal mantém-se clara enquanto subagentes focados fazem o trabalho pesado e ruidoso. Para coordenar vários ao mesmo tempo, lê boas práticas de agent teams. Para a diferença entre um subagente e uma sessão forkada, vê fork e subagente no Claude Code.

Partir de um conjunto pré-construído

Se preferires não escrever cada subagente do zero, coleções da comunidade como a awesome-claude-code-subagents da VoltAgent juntam dezenas de definições de papéis que podes instalar e adaptar. E se o teu objetivo é lançar um produto, o Build This Now é um kit de Claude Code de $29 de pagamento único que entrega agentes especialistas e uma stack de produção em conjunto, para que os papéis de planeamento, construção e teste já estejam ligados à volta de autenticação, pagamentos e uma base de dados segura.

FAQ

O que é um subagente do Claude Code? Um subagente é um agente especializado com as suas próprias instruções, ferramentas e janela de contexto, ao qual a sessão principal delega uma tarefa. Faz o seu trabalho, devolve um resultado e mantém o seu output ruidoso de ferramentas fora da conversa principal. Os subagentes definem-se como ficheiros Markdown na tua pasta .claude/agents/.

Como crio um subagente personalizado no Claude Code? Cria um ficheiro Markdown em .claude/agents/ com frontmatter para nome, descrição e ferramentas permitidas, seguido de um system prompt a descrever o seu papel e as suas regras. Mantém-no estreito, dá-lhe só as ferramentas de que precisa e escreve o prompt para que a sua mensagem final devolva exatamente o resultado que queres.

Quais são os subagentes do Claude Code mais úteis para configurar? Um planeador, um revisor de código, um testador, um depurador e um investigador ou explorador. Estes cobrem as partes da construção em que um contexto fresco e focado bate uma sessão sobrecarregada.

Quantos subagentes devo correr? Configura primeiro os cinco papéis centrais e só acrescenta mais quando uma tarefa real e repetida o justificar. Cada subagente deve ter um trabalho claro; um monte de agentes sobrepostos é mais difícil de gerir do que uns poucos bem afiados.