Subagents no Claude Code: como delegar revisão e testes a agentes separados

Os subagents do Claude Code permitem delegar tarefas que consomem muitos recursos (revisão, testes, auditoria, exploração de código) a agentes separados, com contexto, ferramentas e regras independentes. Com isso, contornam a principal limitação da ferramenta: o esgotamento da janela de contexto.

Por que o contexto é o maior inimigo do Claude Code

A maioria dos desenvolvedores que começa a usar o Claude Code percebe o mesmo padrão: a ferramenta funciona muito bem no início da sessão e visivelmente pior perto do meio e do fim. A causa não está nas capacidades do modelo, já que a Anthropic melhora o Claude com regularidade. A causa está na forma como o contexto é tratado.

Cada interação dentro de uma sessão se acumula na janela de contexto: arquivos lidos, planos escritos, histórico de edições, saída de ferramentas, resultados de comandos. Quanto mais longa a sessão, mais "lixo" se acumula. O modelo passa a perder o fio do raciocínio, a contradizer instruções anteriores e, às vezes, a voltar a soluções que já havia descartado.

A saída padrão é dividir o trabalho em sessões curtas. Mas isso é incômodo: a cada vez é preciso restaurar o contexto manualmente, copiar resultados intermediários e explicar de novo ao agente o que já foi feito.

Os subagents oferecem uma resposta sistemática para esse problema.

O que são subagents e como funcionam

Subagents são instâncias separadas de agente que a sessão principal do Claude Code inicia para subtarefas específicas. A diferença essencial em relação a "abrir um novo chat" manualmente é que a delegação acontece de forma programática, e o resultado volta para a sessão principal de maneira estruturada.

Cada subagent trabalha em um ambiente isolado:

• Janela de contexto própria: independente da sessão principal e começando limpa
• Conjunto de ferramentas sob medida para a tarefa: apenas leitura de arquivos em uma auditoria, ou execução de testes em QA
• Regras e instruções próprias: o papel é configurado por um prompt de sistema ou por um arquivo CLAUDE.md
• Diretório de trabalho isolado: quando necessário, o subagent trabalha em um git worktree separado

O esquema é simples: o agente principal define a tarefa, repassa os arquivos e o contexto necessários e inicia o subagent. Ele trabalha em uma sessão isolada e devolve apenas o resultado (um relatório de revisão, uma lista de problemas, testes prontos), sem o raciocínio intermediário.

O paralelismo é um bônus. Vários subagents podem rodar ao mesmo tempo: enquanto um faz a revisão, outro escreve testes para o mesmo módulo. A sessão principal coordena o trabalho sem executá-lo.

Quais tarefas vale mais a pena delegar

Nem toda tarefa compensa ser enviada a um subagent, pois a delegação tem custo de inicialização e de transferência de contexto. Mas, em vários cenários, o ganho é evidente.

Code review: analisar um PR ou um arquivo específico exige mergulho profundo, mas o resultado é compacto, uma lista de observações com prioridades. O subagent lê o código e entrega um relatório sem poluir o contexto principal com milhares de linhas.

Escrita de testes: o subagent recebe a descrição de uma função ou o arquivo-fonte, escreve os testes, executa e informa o resultado. Enquanto isso, a sessão principal continua trabalhando em outras partes do projeto.

Auditoria de segurança: a verificação de vulnerabilidades com um checklist da OWASP e regras de segurança isoladas devolve uma lista curta de achados com prioridades, sem entulhar o contexto principal.

Exploração da base de código: localizar todas as ocorrências de um padrão ou estudar uma parte desconhecida do projeto. O subagent devolve um mapa estruturado de dependências sem ocupar espaço na janela principal.

O que isso significa

Os subagents mudam a forma de trabalhar com um assistente de IA no desenvolvimento: em vez de uma única sessão grande que se degrada conforme o contexto cresce, o desenvolvedor orquestra agentes especializados, cada um com uma janela de contexto limpa em sua área de responsabilidade. Um revisa, outro testa, um terceiro procura vulnerabilidades.

Isso se aproxima mais de gerenciar uma equipe pequena do que de conversar com um único assistente, e é justamente essa abordagem que permite ao Claude Code lidar de forma estável com tarefas grandes, de vários dias, sem perda de qualidade.