Setup Completo: do zero ao Claude Code · Capítulo 15 de 18 · 15 min
Divida tarefas grandes entre Claudes ajudantes (avançado, opcional)
Ajudantes especializados trabalham ao mesmo tempo e entregam em minutos a auditoria que levaria uma tarde.
Este capítulo faz parte do curso gratuito Setup Completo: do zero ao Claude Code.
Selo: Avançado (opcional). Vale conhecer o conceito; configurar fica a seu critério. No dia a dia o Claude Code aciona sub-agents sozinho, sem você perceber, então pode pular sem prejuízo.
A ideia em uma frase
Se o Claude principal é o gerente do projeto, os sub-agents são a equipe de estagiários que ele aciona por demanda para tarefas específicas. Um pesquisa, outro testa, outro revisa o texto, todos ao mesmo tempo. Cada um entrega seu relatório e encerra; o gerente junta os resultados e apresenta o resumo consolidado a você. O ganho é o de qualquer delegação bem feita: mais rápido, porque corre em paralelo, e mais completo, porque cada estagiário foca em uma coisa só. Suponha uma agência pequena revisando o site de um cliente: um ajudante confere os textos enquanto outro testa os links, e o relatório chega junto.
VOCÊ
│ "audite todo o meu site"
│
▼
CLAUDE PRINCIPAL (maestro)
│
├──────────┬──────────┬──────────┐
▼ ▼ ▼ ▼
Agent 1 Agent 2 Agent 3 Agent 4
SEO Perfor- Acessi- Segur-
audit mance bilidade ança
│ │ │ │
▼ ▼ ▼ ▼
relat. relat. relat. relat.
│ │ │ │
└──────────┴──────────┴──────────┘
│
▼
CLAUDE PRINCIPAL
consolida tudo
│
▼
VOCÊ ← relatório completo em ¼ do tempo que levaria sequencialPor que isso importa para você (mesmo sem mexer em nada)
Quando você pede uma tarefa grande tipo "audite todo o meu site e me diga o que melhorar", o Claude principal automaticamente:
- 01Divide a tarefa em pedaços (auditar SEO, auditar performance, auditar acessibilidade...).
- 02Manda cada pedaço para um sub-agent rodar em paralelo.
- 03Espera todos terminarem.
- 04Junta os resultados num relatório único para você.
Você recebe a resposta mais rápido (porque é em paralelo) e mais completa (porque cada sub-agent foca em uma coisa só).
Sub-agents prontos que já vêm instalados
O Claude Code vem com alguns sub-agents prontos
- Explore: usado quando o Claude precisa procurar algo em vários arquivos do seu projeto.
- Plan: usado quando o Claude precisa montar um plano antes de mexer em algo grande.
- general-purpose: para tarefas variadas em paralelo.
Você não precisa chamar eles à mão. O Claude principal decide quando convém usar.
┌─────────────────────────────────────────────────────────────────┐ │ Claude Code — Agents /exit │ ├─────────────────────────────────────────────────────────────────┤ │ │ │ Sub-agents disponíveis: │ │ ───────────────────────────────────────────────────── │ │ │ │ ● Explore (nativo) │ │ Busca e lê arquivos em projetos grandes. Apenas leitura. │ │ │ │ ● Plan (nativo) │ │ Monta plano de ação antes de executar tarefa complexa. │ │ │ │ ● general-purpose (nativo) │ │ Tarefas variadas em paralelo. │ │ │ │ ── Seus agents personalizados ───────────────────────────── │ │ ● revisor-pt Revisão de português e ortografia │ │ ● auditor-seo Auditoria técnica de SEO em HTML │ │ │ │ [+ Criar novo agent] │ └─────────────────────────────────────────────────────────────────┘
Quando você QUER mexer (cenário avançado)
Algumas pessoas criam sub-agents personalizados com especialidades, por exemplo um "revisor de português" que checa só ortografia, ou um "avaliador de design" que olha só estética. Você cria assim:
- 01Dentro do Claude Code, digite /agents e Enter.
- 02Aparece um menu visual mostrando seus sub-agents e permitindo criar novos.
- 03Escolha "Criar novo", descreva em português o que esse ajudante faz, e o Claude monta para você.
Metáfora: pense no Claude principal como maestro de orquestra: ele rege, divide e cobra. Sub-agents são os músicos especialistas: o violinista não sabe tocar tuba, mas toca o violino melhor do que o maestro tocaria. Cada sub-agent tem prompt próprio, ferramentas próprias e às vezes até modelo Claude diferente (Sonnet 5 ou Haiku 4.5), mais barato para tarefas simples. Quando dois ajudantes mexem em arquivos ao mesmo tempo, cada um pode receber a própria cópia de trabalho do projeto (a worktree), e um não atropela o outro.
4 sub-agents úteis para colocar no seu Windows
1. Revisor PT-BR. Metáfora: "a tia professora de português". Lê seu texto, aponta acentuação, concordância, regência. Não muda o tom: só sinaliza.
2. Auditor de SEO. Metáfora: "inspetor da imobiliária antes da venda". Bate a página HTML contra checklist (title, meta description, headings, alt em imagens, schema) e devolve relatório.
3. Caçador de bugs. Metáfora: "detetive Sherlock para código". Recebe arquivo + descrição do bug, vai investigar até achar a causa raiz, sem tentar 'chutes'.
4. Escritor de README. Metáfora: "redator técnico do manual da Brastemp". Olha o projeto e escreve um README claro, com seções padrão, exemplos e instruções de uso.
Esses 4 são os mais úteis pra começar. Quando você criar o agent via prompt, o Claude vai gerar o arquivo .md correto em %USERPROFILE%\.claude\agents\. Para usar depois, dentro do Claude Code é só pedir naturalmente. Exemplo: "revise este texto" dispara automaticamente o revisor-pt, "audite o SEO desta página" dispara o auditor-seo. Você não precisa chamar pelo nome.
Crie o revisor-pt com o primeiro prompt e digite /agents. Acertou se ele aparece na lista e, ao receber a frase com erros de propósito, devolve cada problema com linha, trecho e sugestão. Depois rode /usage e veja quanto o ajudante gastou: com Sonnet, a revisão deve custar uma fração do que custaria no Opus.
Seu caderno neste capítulo
Abrir o caderno completoSelecione um trecho do capítulo para destacar ou anotar. Nos vídeos e áudios, use Anotar este momento. No teclado, selecione com Shift e as setas e use Alt+Shift+D para destacar ou Alt+Shift+N para anotar.
Salvo neste navegador. Entre na sua conta para levar o caderno a outros aparelhos.
Entre na sua conta para compartilhar o que aprendeu e convidar alguém para estudar com você.
Conexões deste capítulo
Veja o que estudar antes e para onde seguir depois, explore os conceitos e compare abordagens em outros cursos. Sugestões marcadas como “sugerido pelo grafo” vêm dos assuntos em comum, não do índice do curso.
Estude antes
- Agent Mode: a IA que executa sob supervisãosugerido pelo grafoApresenta o conceito “Agent”, usado em “Divida tarefas grandes entre Claudes ajudantes (avançado, opcional)”.
- CursoGitHub: Controle de Versão do Zerosugerido pelo grafo6 capítulos de “Setup Completo: do zero ao Claude Code” usam conceitos apresentados em “GitHub: Controle de Versão do Zero”.
Depois, siga para
- CursoClaude Code CLI: Programação com IA
- CursoAgentes de código para executivossugerido pelo grafoO Setup ensina permissões, contexto do projeto e escolha de modelo por custo. Essa preparação sustenta os exercícios de comparação de assistentes, criação do gerador de UTM e regras de projeto no curso de aprendizado por reforço e vibecoding.
- CursoSetup de Vibecoding no Macsugerido pelo grafo11 capítulos de “Setup de Vibecoding no Mac” usam conceitos apresentados em “Setup Completo: do zero ao Claude Code”.
- CursoVídeo com IA: Claude Code, Codex e ElevenLabssugerido pelo grafo7 capítulos de “Vídeo com IA: Claude Code, Codex e ElevenLabs” usam conceitos apresentados em “Setup Completo: do zero ao Claude Code”.
Conceitos deste capítulo
O mesmo assunto em outros cursos
- Setup de Vibecoding no MacSub-agents — Claudes ajudantes em paralelo (opcional)Examinar conexões de Sub-agents — Claudes ajudantes em paralelo (opcional)
- Bastidores: Como Este Portal Foi ConstruídoAgentes em worktrees: produção em paraleloExaminar conexões de Agentes em worktrees: produção em paralelo
- Claude Code CLI: Programação com IARevisar o plano antes de agir e ligar suas ferramentasExaminar conexões de Revisar o plano antes de agir e ligar suas ferramentas
- Agentes de IA Autônomos: Do Conceito à ProduçãoClaude Agent SDKExaminar conexões de Claude Agent SDK
Leve uma ideia para a prática
Escolha uma atividade no painel e volte a este curso quando quiser.
Atividades e evolução ficam reunidas no painel da sua conta.