Subagents, hooks, slash commands e tarefas recorrentes — coloque o Claude Code no piloto automático e multiplique sua produtividade.
Aprenda a delegar tarefas complexas a subagentes paralelos e multiplique a capacidade do Claude Code sem aumentar o tempo de espera.
Um subagent é uma instância de Claude Code lançada pelo agente principal para executar uma tarefa específica de forma isolada. Ele recebe um prompt bem definido, executa de forma independente e retorna o resultado resumido ao orquestrador.
Com subagents você paraleliza trabalho — enquanto um pesquisa docs, outro escreve testes e um terceiro revisa o código. O que levaria horas em série acontece em minutos.
Nem toda tarefa merece um subagent. A delegação faz sentido quando a tarefa é independente, tem escopo claro e seu resultado pode ser consumido de forma atômica pelo orquestrador.
Delegar de forma errada aumenta custo sem ganho. Saber quando delegar é a diferença entre automação eficiente e overhead desnecessário.
Fan-out é o padrão onde um orquestrador dispara N subagents simultaneamente, cada um resolvendo uma parte do problema. Os resultados são coletados e integrados ao final.
Fan-out é o padrão mais poderoso de automação com Claude Code. Pesquisas que levariam 1 hora em série completam em minutos quando paralelizadas com 4-8 subagents.
O Claude Code suporta diferentes perfis de subagent: o tipo Explore foca em leitura e análise (sem escrita); o General pode executar qualquer ferramenta. A escolha determina permissões e risco.
Usar o tipo errado de subagent pode criar riscos de segurança (um agente de pesquisa com permissão de escrita) ou limitar funcionalidade (um agente de codificação sem permissão de exec).
O resultado de um subagent retorna ao orquestrador como texto comprimido — um resumo do que foi feito, não o log completo de execução. Isso preserva o contexto do agente principal.
Entender como o resultado retorna ajuda a formular prompts melhores: especificar o formato de saída esperado (JSON, markdown, lista) garante que o orquestrador consuma o resultado sem retrabalho.
Cada subagent consome tokens: o prompt de instrução + a execução + o resultado. Com múltiplos subagents em paralelo o custo pode escalar rapidamente se não houver controle.
Automação mal planejada pode custar mais do que o trabalho manual equivalente. Calcular o ROI antes de implementar subagents é uma prática profissional essencial.
Configure ganchos de eventos para automatizar ações antes e depois de cada ferramenta — lint, segurança e injeção de contexto sem tocar no código do agente.
Hooks são scripts externos executados pelo harness em momentos específicos do ciclo de vida do agente: antes de uma ferramenta (PreToolUse), após (PostToolUse), ao iniciar sessão (SessionStart) ou ao parar (Stop).
Com hooks você adiciona comportamento sem modificar o prompt ou o código do agente. É a forma mais limpa de impor políticas: lint sempre roda, comandos proibidos são bloqueados automaticamente.
Hooks são configurados na chave hooks do arquivo settings.json (global em ~/.claude/ ou local em .claude/). Cada hook é um objeto com evento, matcher de ferramenta e comando shell.
A configuração declarativa no settings.json permite versionar os hooks junto com o projeto. Times inteiros herdam as políticas automaticamente sem onboarding manual.
Um hook PreToolUse pode retornar exit code não-zero para abortar a ferramenta antes de executar. Isso permite criar listas negras de comandos — por exemplo, bloquear git push --force.
Comandos destrutivos como rm -rf ou force push em main podem causar danos irreversíveis. Um hook de bloqueio é a última linha de defesa.
Um hook PostToolUse pode rodar lint ou formatação automaticamente sempre que o agente salvar um arquivo. O output do lint é injetado de volta no contexto, permitindo que o agente corrija os erros na próxima iteração.
Sem lint automático o agente pode gerar código com erros de formatação que só aparecem no CI. Com o hook, cada save já produz código limpo — feedback loop instantâneo.
O hook SessionStart executa quando uma nova sessão começa. Seu output é injetado como mensagem inicial no contexto — ideal para carregar metadados do projeto, branch atual, variáveis de ambiente, ou memórias relevantes.
Ao invés de repetir o estado do projeto em todo novo prompt, o SessionStart injeta automaticamente. O agente começa cada sessão já contextualizado — menos tokens gastos, mais foco no trabalho.
Por padrão, se um hook falha (timeout, erro de script), o harness continua a execução — comportamento "fail-open". Em hooks de segurança críticos você pode configurar fail-closed para parar tudo.
Confiar demais em fail-open pode deixar lacunas de segurança. Entender o modelo de falha dos hooks permite desenhar sistemas mais robustos onde as políticas críticas nunca são ignoradas silenciosamente.
Crie atalhos reutilizáveis e pipelines determinísticos que orquestram múltiplos agentes em sequência ou paralelo com um único comando.
Slash commands são atalhos de texto que expandem para prompts completos. Ao digitar /review no Claude Code, o harness expande para um prompt de revisão de código pré-configurado.
Em vez de reescrever o mesmo prompt longo repetidamente, você digita 3 caracteres e obtém consistência total. Times inteiros usam os mesmos padrões sem memorizar instruções complexas.
Comandos customizados são definidos como arquivos .md dentro da pasta .claude/commands/. O nome do arquivo vira o comando. O conteúdo é o prompt que será expandido.
Cada projeto tem necessidades únicas. Um projeto React pode ter /component, um de dados tem /migrate. Customizar é parte do setup profissional.
Um workflow determinístico é uma sequência pré-definida de steps — cada step pode ser um agente, um comando shell, ou uma transformação de dados. O resultado de um step alimenta o próximo, sem variação aleatória.
Quando o processo precisa ser auditável e reproduzível (CI/CD, releases, revisões obrigatórias), a determinação é mais valiosa que a criatividade. Workflows garantem que cada passo sempre acontece.
Pipeline: steps encadeados onde a saída de A é entrada de B. Parallel: múltiplos agentes rodando ao mesmo tempo sem dependência mútua. Muitos workflows combinam os dois padrões.
Escolher o padrão errado pode duplicar o tempo de execução (quando deveria paralelizar) ou produzir resultados inconsistentes (quando deveria serializar). O design do workflow é tão importante quanto o conteúdo.
Workflows são mais adequados quando a tarefa é repetida frequentemente, envolve múltiplos agentes, ou precisa de auditabilidade. Tarefas únicas e criativas são melhor tratadas com prompts livres.
Over-engeneering workflows para tarefas simples é desperdício. Under-engineering para tarefas críticas é risco. Saber o ponto certo é a habilidade mais valiosa em automação.
Um meta-agente (ou orquestrador de nível superior) pode invocar workflows inteiros como sub-tarefas. Isso cria uma hierarquia: orquestrador → workflow → subagents — cada nível com responsabilidades bem definidas.
Para projetos grandes, um único agente monolítico se perde em complexidade. A hierarquia de orquestradores divide o problema em camadas gerenciáveis — cada camada bem testada e substituível.
Agende agentes para rodar em intervalos definidos — revisões diárias, relatórios automáticos e monitoramento contínuo sem intervenção humana.
Cron permite agendar tarefas para rodarem em horários específicos (diariamente, semanalmente, a cada hora). O Claude Code integra com cron via skill /schedule para criar rotinas de agente.
Tarefas recorrentes são o maior desperdiçador de tempo de desenvolvedores. Code review diário, atualização de deps, relatório de métricas — tudo pode rodar sem intervenção humana.
O comando /loop repete uma tarefa em intervalos definidos enquanto a sessão está ativa. É ideal para polling de status, monitoramento de build, ou observação contínua de um sistema.
/loop é mais simples que cron para tarefas de curta duração. Não requer setup de infraestrutura — roda na sessão atual e para quando você fecha o terminal.
Agentes remotos rodam na infraestrutura do Claude sem precisar de um terminal local aberto. Eles são disparados por eventos (webhook, cron) e executam de forma completamente autônoma.
Agentes remotos são a fronteira entre automação local e automação de produção. Quando você não quer (nem pode) ter um laptop ligado 24h para rodar tarefas, agentes remotos são a solução.
Um agente de review diário roda via cron todo dia às 9h, analisa o código commitado no dia anterior, gera um relatório de qualidade e envia por notificação ou salva em arquivo.
Code review automático não substitui o humano — mas pega os 80% de erros mecânicos antes da revisão humana. O revisor humano foca no que importa: arquitetura e lógica de negócio.
Agentes assíncronos não retornam resultado imediato. O output pode ser coletado via PushNotification (webhook), arquivo gerado, ou polling com Monitor — dependendo do mecanismo de entrega configurado.
Automação sem observabilidade é automação cega. Saber onde e como o resultado chega é fundamental para confiar na automação — e para debugar quando algo dá errado às 3h da manhã.
Agentes recorrentes acumulam custo ao longo do tempo. Idempotência garante que rodar o agente duas vezes produz o mesmo resultado — crucial quando falhas levam a re-execuções.
Uma tarefa cron que falha e é re-executada 5× pode criar 5 PRs idênticos ou cobrar 5× o custo esperado. Idempotência não é detalhe — é requisito de produção.