Subagents no Claude Code: como delegar reviews e testes para agentes separados

Subagentes no Claude Code permitem delegar tarefas que consomem recursos — revisões, testes, auditorias, pesquisa de código — a agentes separados com contexto, ferramentas e regras independentes, contornando a principal limitação da ferramenta: esgotamento da janela de contexto.

Por que o contexto é o principal inimigo do Claude Code

A maioria dos desenvolvedores que começam a trabalhar com Claude Code notam um padrão: a ferramenta funciona brilhantemente no início de uma sessão e notavelmente pior — no meio e fim. A razão não são os recursos do modelo — Anthropic melhora regularmente Claude. A razão reside na arquitetura de gerenciamento de contexto.

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 "ruído" no contexto. O modelo começa a perder seu fio de raciocínio, produzir contradições com instruções anteriores, às vezes retornar a soluções já rejeitadas.

A solução padrão é dividir o trabalho em sessões curtas. Mas isso é inconveniente: você tem que restaurar o contexto manualmente cada vez, copiar resultados intermediários e re-explicar ao agente o que já foi feito.

Subagentes oferecem uma resposta sistêmica a este problema.

O que são subagentes e como funcionam

Subagentes são instâncias de agente separadas que a sessão principal do Claude Code inicia para sub-tarefas específicas. A diferença-chave do manual "iniciar um novo chat": a delegação acontece programaticamente e o resultado retorna à sessão principal em forma estruturada.

Cada subagente opera em um ambiente isolado:

• Sua própria janela de contexto — independente da sessão pai, começa limpo
• Um conjunto de ferramentas para a tarefa — apenas leitura de arquivos para auditorias, ou execução de testes para QA
• Regras e instruções separadas — a função é configurada via prompt do sistema ou arquivo CLAUDE.md
• Diretório de trabalho isolado — quando necessário, o subagente trabalha em um git-worktree separado

O esquema de interação é simples: o agente principal define uma tarefa, passa arquivos e contexto necessários, inicia o subagente. Funciona em uma sessão isolada e retorna apenas o resultado — um relatório de revisão, lista de problemas, testes prontos — sem raciocínio intermediário.

O paralelismo é um bônus adicional. Vários subagentes podem ser executados simultaneamente: enquanto um faz revisão, outro escreve testes para o mesmo módulo. A sessão principal coordena o trabalho sem executá-lo.

Quais tarefas são melhores para delegar

Nem toda tarefa faz sentido ser transferida para um subagente — delegação carrega sobrecarga de inicialização e transferência de contexto. Mas para vários cenários o retorno é óbvio.

Revisão de código — analisar um PR ou arquivo específico requer mergulho profundo mas produz resultados compactos: uma lista de observações com prioridades. Subagente lê código, retorna um relatório e não polui o contexto principal com milhares de linhas.

Escrever testes — subagente recebe descrição de função ou arquivo de origem, escreve testes, executa-os e relata resultados. A sessão principal enquanto isso continua trabalhando em outras partes do projeto.

Auditoria de segurança — verificar vulnerabilidades com checklist OWASP e regras de segurança isoladas retorna uma lista curta de achados com prioridades, não poluindo o contexto principal.

Pesquisa de base de código — encontrar todas as ocorrências de padrão ou explorar seções desconhecidas do projeto: subagente retorna um mapa de dependências estruturado sem ocupar espaço na janela principal.

O que significa

Subagentes mudam a abordagem para trabalhar com um assistente de IA em desenvolvimento: em vez de uma sessão grande única que se degrada com contexto crescente, o desenvolvedor obtém orquestração de agentes especializados — cada um trabalha com uma janela de contexto limpo em sua zona de responsabilidade.

Um revisa, outro testa, um terceiro caça vulnerabilidades. Isso é mais próximo a gerenciar um pequeno time do que conversar com um único ajudante — e esta abordagem exatamente permite que Claude Code lide estável com tarefas grandes e multidias sem perder qualidade.