🧩 O que sao Subagentes
Subagentes sao processos filhos autonomos que o Claude Code pode lancar para executar tarefas em paralelo. Em vez de fazer tudo sequencialmente no mesmo contexto, o agente principal delega partes do trabalho para subagentes especializados, cada um com seu proprio contexto e ferramentas.
🎯 Conceito Principal
Pense em subagentes como membros de uma equipe. O agente principal e o lider que distribui tarefas. Cada subagente recebe uma missao especifica, executa de forma independente e retorna o resultado. Isso permite paralelismo real e protecao do contexto principal.
- • Contexto isolado: Cada subagente tem seu proprio contexto, o que significa que pesquisas pesadas nao poluem a janela principal
- • Paralelismo: Multiplos subagentes podem rodar simultaneamente, acelerando tarefas complexas
- • Especializacao: Cada tipo de subagente tem ferramentas e capacidades otimizadas para seu proposito
- • Resultado consolidado: O agente principal recebe os resultados e toma decisoes informadas
💡 Dica Pratica
Voce ja usa subagentes sem perceber. Quando o Claude Code faz uma pesquisa profunda no codebase, ele internamente lanca um subagente Explore. Quando planeja uma implementacao complexa, usa um subagente Plan. Entender esse mecanismo permite que voce tire proveito maximo da ferramenta.
🔧 Tipos de Subagentes
O Claude Code oferece diferentes tipos de subagentes, cada um otimizado para um tipo especifico de tarefa. Escolher o tipo certo e fundamental para eficiencia e qualidade do resultado.
🎯 Conceito Principal
Cada tipo de subagente tem acesso a ferramentas diferentes e e otimizado para um proposito:
- • Explore: Rapido para navegacao de codebase. Usa Glob, Grep, Read. Ideal para encontrar arquivos, buscar padroes, responder perguntas sobre o codigo. Nao pode editar
- • Plan: Arquiteto de software. Analisa o codebase e cria planos de implementacao. Identifica arquivos criticos, considera tradeoffs. Nao pode editar
- • General-purpose: Agente completo com todas as ferramentas. Pode ler, escrever, executar comandos. Usado para tarefas complexas e multi-step
Comparacao de Subagentes
| Tipo | Velocidade | Pode editar | Melhor para |
|---|---|---|---|
| Explore | Rapido | Nao | Busca, navegacao, pesquisa |
| Plan | Moderado | Nao | Arquitetura, planejamento |
| General-purpose | Variavel | Sim | Tarefas complexas, multi-step |
💡 Dica Pratica
Use Explore para perguntas rapidas sobre o codigo ("onde esta a funcao X?"). Use Plan quando precisa de uma estrategia antes de implementar. Use General-purpose apenas quando a tarefa exige edicao ou execucao de comandos no subagente.
✨ /simplify - Revisao e Simplificacao Automatica
O comando /simplify e uma das adicoes mais poderosas de 2026. Ele analisa o codigo que voce acabou de escrever ou modificar e busca oportunidades de simplificacao: reuso, qualidade e eficiencia.
🎯 Conceito Principal
O /simplify funciona em tres etapas automaticas:
- • Analise de reuso: Identifica codigo duplicado ou padroes que poderiam ser extraidos em funcoes/componentes reutilizaveis
- • Verificacao de qualidade: Busca anti-patterns, complexidade desnecessaria, imports nao usados, variaveis mortas
- • Otimizacao de eficiencia: Sugere alternativas mais performaticas ou idiomaticas para a linguagem
EXEMPLO DE USO
# Apos escrever ou modificar codigo, rode:
/simplify
# Claude vai:
# 1. Analisar todas as mudancas recentes
# 2. Identificar oportunidades de melhoria
# 3. Aplicar simplificacoes com sua aprovacao
# Para simplificar arquivo especifico:
Simplify the code in src/utils/helpers.ts💡 Dica Pratica
Use /simplify como ultimo passo antes de commitar. E como ter um colega senior fazendo uma revisao rapida do seu codigo. A regra de ouro: se tres linhas similares aparecem no codigo, provavelmente podem ser uma funcao. O /simplify encontra isso automaticamente.
📦 /batch - Processamento em Lote
O /batch permite executar a mesma operacao em multiplos alvos de uma vez. Imagine precisar adicionar tratamento de erro em 20 endpoints, ou atualizar imports em 50 arquivos. Em vez de fazer um por um, o /batch paraleliza e automatiza.
🎯 Conceito Principal
O /batch funciona como um map() sobre arquivos ou tarefas. Voce define a operacao e os alvos, e o Claude executa em paralelo usando subagentes:
- • Alvos por glob: "aplique X em todos os *.test.ts" - seleciona arquivos por padrao
- • Alvos por lista: "aplique X nestes 5 arquivos: [lista]" - selecao manual
- • Execucao paralela: Cada arquivo e processado por um subagente independente
- • Relatorio consolidado: Ao final, voce recebe um resumo de todas as mudancas
EXEMPLOS DE USO
# Adicionar error handling em todos os endpoints
Add try/catch error handling to all route handlers in src/routes/*.ts
# Migrar imports de CommonJS para ESM
Convert all require() to import statements in src/**/*.js
# Adicionar JSDoc a todas as funcoes exportadas
Add JSDoc comments to all exported functions in src/utils/💡 Dica Pratica
Antes de usar /batch em todo o projeto, teste em 2-3 arquivos primeiro. Verifique se o resultado esta correto, depois aplique em lote. Isso evita ter que reverter dezenas de mudancas incorretas. Sempre faca um git stash ou commit antes de operacoes em lote.
🌳 Paralelismo e Worktrees
Uma das inovacoes mais importantes para subagentes e o conceito de git worktrees isolados. Quando um subagente precisa fazer mudancas no codigo, ele pode trabalhar numa copia isolada do repositorio, evitando conflitos com o trabalho principal.
🎯 Conceito Principal
Worktrees resolvem um problema classico: como ter multiplos agentes editando o mesmo repositorio sem conflitos. Cada worktree e uma copia de trabalho independente:
- • Isolamento total: Cada subagente trabalha em sua propria branch e diretorio temporario
- • Sem conflitos: Mudancas nao interferem entre si ate o momento de merge
- • Cleanup automatico: Se o subagente nao fez mudancas, o worktree e removido automaticamente
- • Merge controlado: Voce decide quais mudancas de quais subagentes incorporar ao branch principal
💡 Dica Pratica
Worktrees sao especialmente uteis quando voce quer testar duas abordagens diferentes para resolver o mesmo problema. Lance dois subagentes com isolation: "worktree", cada um implementando uma solucao diferente. Compare os resultados e faca merge da melhor abordagem.
🎯 Quando Delegar para Subagentes
Subagentes sao poderosos, mas nem toda tarefa precisa de delegacao. Usar subagentes desnecessariamente adiciona overhead de contexto e pode tornar as coisas mais lentas. O segredo e saber quando delegar e quando fazer diretamente.
🎯 Conceito Principal
Framework de decisao para subagentes:
- • DELEGAR quando: A tarefa exige pesquisa profunda que poluiria o contexto, ou quando multiplas tarefas independentes podem rodar em paralelo
- • DELEGAR quando: Voce precisa de isolamento (worktree) para testar mudancas sem afetar o branch atual
- • NAO delegar quando: A tarefa e simples e direta (editar um arquivo, rodar um comando)
- • NAO delegar quando: O resultado do subagente depende do contexto da conversa atual
✓ Bons casos para subagentes
- ✓ Pesquisa ampla no codebase (Explore)
- ✓ Planejamento de implementacao (Plan)
- ✓ Operacoes em lote (/batch)
- ✓ Testes de abordagens alternativas (worktree)
✗ Maus casos para subagentes
- ✗ Editar um unico arquivo
- ✗ Rodar um comando simples
- ✗ Tarefas que dependem do historico da conversa
- ✗ Busca simples por nome de arquivo (use Glob)
💡 Dica Pratica
Regra simples: se a tarefa leva menos de 30 segundos no agente principal, faca direto. Se leva mais, considere delegar. Se sao multiplas tarefas independentes, sempre delegue em paralelo. O ganho de tempo compensa o overhead de lancamento do subagente.
🏋️ Exercicio Pratico
Use /simplify num projeto real e analise os resultados. Este exercicio vai consolidar seu entendimento de subagentes e comandos de simplificacao.
Preparar o ambiente
Navegue ate um projeto seu com pelo menos 5 arquivos de codigo. Faca um commit limpo antes de comecar.
Rodar /simplify
Execute o comando /simplify e observe quais sugestoes o Claude faz. Anote quantas oportunidades de reuso, qualidade e eficiencia ele encontra.
Analisar as sugestoes
Para cada sugestao, avalie: e uma melhoria real? Mantem o comportamento? Simplifica de verdade? Aceite as boas, rejeite as desnecessarias.
Testar uma operacao em lote
Identifique uma mudanca repetitiva (ex: adicionar um import em varios arquivos) e peca ao Claude para aplicar em lote.
Verificar e commitar
Rode os testes, verifique que nada quebrou, e faca o commit das melhorias.
CHECKLIST DE CONCLUSAO
- ☐ Rodou /simplify em pelo menos 1 projeto
- ☐ Analisou e aceitou/rejeitou sugestoes criticamente
- ☐ Executou uma operacao em lote com sucesso
- ☐ Testes passando apos as mudancas
- ☐ Commit limpo com as melhorias