Subagent — delegando como uma pessoa dev sênior
Mande tarefas focadas para instâncias especializadas do Claude
⏱ Estim. ~6 min
01 · Ler
Pessoas dev sêniores não fazem tudo sozinhas — elas delegam. Quando uma pessoa júnior pede para a sênior investigar um bug, a sênior não larga o trabalho atual. Ela manda alguém investigar e voltar com o resultado.
Subagents deixam você fazer isso com o Claude Code. Em vez de uma conversa gigante tentando dar conta de tudo — ler arquivos, rodar testes, investigar arquitetura — você pode mandar tarefas focadas para subagents especializados, que trabalham na própria janela de contexto.
A grande vantagem: subagents mantêm sua conversa principal limpa. Um subagent pode ler 50 arquivos para entender seu sistema de validação, mas devolve só um resumo curto para sua janela de contexto.
💡 Imagine assimPense num subagent como mandar uma pessoa assistente de pesquisa até a biblioteca. Você não vai lá amontoar livros na sua mesa — ela vai, lê tudo e volta com um resumo de uma página. Sua mesa fica livre para o que importa.
Pontos-chave
- Subagents rodam em uma janela de contexto separada da sua conversa principal
- Eles investigam, analisam e executam tarefas de forma independente
- Só o resumo volta para seu contexto — não todos os arquivos que eles leram
- Sua conversa principal continua focada na implementação
02 · Ler
O Claude Code tem alguns tipos de subagent embutidos, cada um pensado para uma tarefa específica: - Explore — pesquisa em modo read-only. Procura arquivos, lê código, responde dúvidas sobre o codebase. Não pode editar. - Plan — design de arquitetura. Explora o codebase e propõe um plano de implementação. Fica read-only até você aprovar. - Bash — especialista em comandos. Roda comandos no terminal. Use para rodar testes, builds, checagens de sistema.
O Claude gera subagents automaticamente quando reconhece uma tarefa que deve ser isolada — como investigar um codebase grande ou rodar uma suíte de testes. Você também pode pedir explicitamente.
Pontos-chave
- Explore: pesquisa read-only e análise de codebase
- Plan: design de arquitetura e planejamento de implementação
- Bash: comandos de terminal e operações de sistema
- O Claude gera subagents automaticamente quando faz sentido
03 · Exemplo de código
Você pode pedir direto para o Claude usar subagents. Abaixo está um prompt que aciona a delegação para subagent.
Prompt que aciona subagent
"Use a subagent to investigate how auth works in this codebase"
"Explore the database schema and summarize what tables we have"
"Run the test suite and report which tests fail"
"Analyze the API routes and list all endpoints"
Quando você pede para o Claude "investigar", "explorar", "analisar" ou "rodar os testes", ele frequentemente delega para um subagent automaticamente. O subagent faz o trabalho pesado no próprio contexto e devolve um resumo enxuto para sua conversa.
04 · Ler
Você pode criar seus próprios subagents escrevendo um SKILL.md com frontmatter YAML. Isso define um agente especializado com instruções, restrições de ferramentas e escolha de modelo próprias.
Agentes customizados são poderosos porque você pode restringir as capacidades. Um code reviewer só precisa ler arquivos — não deveria editar nem rodar comandos. Um test runner precisa de Bash, mas não de Edit. Restringir ferramentas deixa o agente mais seguro e mais focado.
Pontos-chave
- Agentes customizados são definidos em SKILL.md com frontmatter YAML
- O campo tools: restringe o que o agente pode fazer
- Reviewer precisa de Read/Grep/Glob — não de Edit nem Bash
- Restrições deixam o agente mais seguro e mais focado
05 · Exemplo de código
Abaixo está como criar um subagent code-reviewer customizado. O frontmatter YAML configura o comportamento dele.
.claude/skills/code-reviewer/SKILL.md
---
name: code-reviewer
description: Expert code review specialist. Use after code changes.
tools: Read, Grep, Glob
model: sonnet
---
Review code for:
1. Bug risks and logic errors
2. Security vulnerabilities (injection, auth bypass)
3. Performance issues (N+1 queries, unnecessary loops)
4. Style inconsistencies with the existing codebase
Provide specific line references and severity ratings.
Esse agente só consegue ler código — não pode editar arquivos nem rodar comandos. A restrição tools: Read, Grep, Glob garante que ele fique focado em revisar. model: sonnet significa que ele usa Sonnet (rápido, cost-effective) em vez do modelo que sua conversa principal está usando.
06 · Quiz
Você está implementando uma feature nova e precisa entender como o sistema de validação atual funciona. Isso envolve ler mais de 20 arquivos. Qual é a forma mais eficiente em termos de contexto?
- Ler todos os 20 arquivos sozinho na conversa principal
- Pedir ao Claude para explicar a validação sem ler os arquivos
- Abrir uma nova session do Claude para a investigação
- Usar um subagent para investigar e devolver um resumo
07 · Combinar
Combine cada tipo de subagent com seu melhor uso.
(Esta seção é interativa — ative o JavaScript para usar.)
Outras lições deste capítulo
⚠ A experiência interativa completa precisa de JavaScript. Ative-o e recarregue a página.
※ Este é um projeto educacional independente — não é um produto oficial da Anthropic. Claude™ é uma marca registrada da Anthropic, PBC.