Como Usar Claude Code para Automação: Slash Commands, Hooks, Skills e Sub-agents na Prática

Aprender como usar Claude Code para automação virou o caminho mais rápido para transformar processo manual em pipeline rodando — não só “geração de código”. Claude Code (CLI da Anthropic, fev/2025) tem 5 recursos que a maioria ignora: slash commands customizados, hooks que disparam em eventos, skills reutilizáveis, MCP servers para integrar com sistemas externos e sub-agents para paralelismo. Aqui o que faz cada um, código real do pipeline editorial que roda este blog e quando NÃO usar.

Resposta rápida (Featured Snippet): Os 5 recursos de automação do Claude Code são:

1. Slash commands — arquivos .md em .claude/commands/ viram /comando reutilizáveis.

2. Hooks — scripts shell em settings.json rodam em eventos (PreToolUse, PostToolUse, Stop).

3. Skills — pacotes reutilizáveis com instruções + scripts + arquivos.

4. MCP servers — conectam Claude Code com sistemas externos (Linear, Slack, BD, browsers).

5. Sub-agents — Agent tool spawn agentes especializados em sessão isolada.

O que é o Claude Code (e por que não é só um IDE assistant)

Claude Code é a CLI agentic da Anthropic, lançada em fevereiro de 2025. Diferente de Cursor e GitHub Copilot, não é IDE: roda no terminal e executa tarefas inteiras sozinha. Para escolher entre os três, veja o comparativo Claude Code vs Cursor vs GitHub Copilot.

O que faz dele uma plataforma de automação séria (e não só “completion de código”):

Cada chat é um agente com acesso a ferramentas (Read, Write, Edit, Bash, etc).
Você pode customizar quais ferramentas estão disponíveis, como o agente se comporta, e em que momentos ele dispara ações.
Os arquivos de configuração ficam versionados no Git junto com seu projeto.

Resultado: Claude Code roda no seu repo, mas a “função” dele é executar pipelines — não só ajudar a digitar código.

Pré-requisitos

Conta Anthropic com plano Pro (US$ 20/mês ≈ R$ 108) no mínimo. Para automação intensa, Max ($100–200/mês ≈ R$ 540–R$ 1.080).
Claude Code instalado: npm install -g @anthropic-ai/claude-code.
Repo Git (todo trabalho com Claude Code beneficia de versionar).
Conhecimento básico de YAML/JSON/Markdown.

Cotação: US$ 1 = R$ 5,40 (junho/2026).

Os 5 recursos de automação do Claude Code

1. Slash commands customizados

Slash commands são arquivos .md em .claude/commands/[nome].md que viram /nome no chat. Cada um define um agente especializado.

Estrutura mínima:

---
description: Pesquisa profunda sobre um tema e devolve briefing
---

Você é o Agente de Briefing. Receba um tema, faça pesquisa de SERP, GEO e concorrentes, e entregue briefing no formato YAML.

Tema recebido: $ARGUMENTS

[instruções detalhadas...]

Salva em .claude/commands/briefing.md. Pronto. No próximo chat, digita /briefing como criar agente de ia e dispara.

Eu uso 9 slash commands no CortexIA: /briefing, /arquiteto, /c1, /c2, /c3, /seo, /interlinker, /monitoramento, /atualizacao. Cada um é um agente com instruções específicas.

2. Hooks (PreToolUse, PostToolUse, Stop, UserPromptSubmit)

Hooks são scripts shell que rodam automaticamente em eventos. Configurados em .claude/settings.json:

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Write|Edit",
        "hooks": [
          {"type": "command", "command": "prettier --write $CLAUDE_TOOL_INPUT_FILE_PATH"}
        ]
      }
    ],
    "Stop": [
      {
        "hooks": [
          {"type": "command", "command": "git add -A && git commit -m 'wip: claude code session'"}
        ]
      }
    ]
  }
}

O primeiro hook formata todo arquivo escrito/editado com Prettier. O segundo cria commit ao fim da sessão. Você não precisa pedir — acontece sozinho.

Eventos disponíveis:

UserPromptSubmit — antes de enviar prompt (validação, contexto extra)
PreToolUse — antes de executar tool (validação)
PostToolUse — depois de executar tool (lint, format, log)
Stop — fim da sessão (commit, deploy, notification)

3. Skills reutilizáveis

Skills são pacotes com instruções + scripts + arquivos que você invoca via Skill tool. Diferente de slash commands (que vivem no projeto), skills podem viver no projeto OU globalmente.

Estrutura típica:

.claude/skills/
└── publicar-artigo/
    ├── SKILL.md         (instruções)
    ├── publicar.py      (script de upload)
    └── template.html    (template WordPress)

SKILL.md declara nome, descrição e quando usar:

---
name: publicar-artigo
description: Converte artigo markdown em HTML formatado e publica no WordPress via API
---

[instruções]

Quando o agente principal precisa publicar, chama via Skill tool. Reuso garantido.

4. MCP servers (Model Context Protocol)

MCP é o protocolo aberto da Anthropic para extender Claude Code com ferramentas externas. Cada servidor MCP expõe tools/resources que o agente pode chamar.

Catálogo crescendo rápido em 2026:

Linear MCP: criar issue, mover ticket, comentar.
Slack MCP: enviar mensagem, ler canal, criar canal.
Postgres MCP: rodar query, descrever schema.
Browser MCP (Claude in Chrome): navegar, clicar, ler página.
Filesystem MCP: acesso controlado a pastas específicas.

Para conectar, adiciona em .claude/settings.json:

{
  "mcpServers": {
    "linear": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-linear"],
      "env": {"LINEAR_API_KEY": "lin_api_..."}
    }
  }
}

Reinicia Claude Code, as tools mcp__linear__* ficam disponíveis no chat.

5. Sub-agents (Agent tool)

Quando você precisa de paralelismo ou de proteger o contexto principal, spawn um sub-agente via Agent tool. Tipos prontos:

Explore: read-only, busca código.
Plan: desenha plano de implementação sem editar.
general-purpose: delega tarefa complexa em sessão isolada.

Caso típico: “explore esse repo grande e me diga onde está a lógica de autenticação”. Em vez de consumir seu contexto, spawn um Explore agent — ele faz dezenas de greps/reads e devolve resumo de 5 linhas.

Você também pode criar agentes customizados em .claude/agents/[nome].md com modelo, tools permitidas e prompt próprio.

Caso real: pipeline editorial do CortexIA

Esse blog usa Claude Code para tudo do pipeline editorial. Estrutura real do .claude/:

.claude/
├── commands/
│   ├── briefing.md      (/briefing keyword)
│   ├── arquiteto.md     (/arquiteto pillar)
│   ├── c1.md            (/c1 briefing/[arquivo].md)
│   ├── c2.md            (/c2 briefing/[arquivo].md)
│   ├── c3.md            (/c3 briefing/[arquivo].md)
│   ├── seo.md           (/seo artigos/[arquivo].md)
│   ├── interlinker.md   (/interlinker artigos/[arquivo].md)
│   ├── monitoramento.md
│   └── atualizacao.md
├── settings.json        (hooks + permissions)
└── skills/
    └── publicar/        (em construção)

Como cada comando chama o próximo

Cada comando termina instruindo o próximo:

/briefing salva em briefings/[slug].md e termina com “Próximo passo: /c3“.
/c3 lê o briefing, escreve artigo em artigos/[slug].md, termina com “Próximo: /revisor“.
/revisor avalia E-E-A-T. Se aprovado, dispara /seo. Se reprovado, devolve para /c3 com notas.
/seo audita e termina com “Próximo: /interlinker“.
/interlinker insere links internos, cria [slug]-final.md, marca pronto para publicação.

Resultado: comando 1 inicia, os 4 seguintes encadeiam sozinhos. Vitor revisa só o final.

Como rodo em produção

Atualmente rodo no terminal local. Para os 18 artigos do Cluster 3, o pipeline leva ~5 minutos por artigo (briefing → c3 → revisor → seo → interlinker), consumindo ~30k tokens cada. Custo total dos 18: ≈US$ 8 (R$ 43) no plano Max.

Próximo passo: empacotar o pipeline como skill publicável via Claude Code Hub para outros blogs reusarem.

Custo real mensal

Item	Custo
Plano Anthropic Max (uso intenso)	US$ 100 → R$ 540
Plano Pro (uso moderado)	US$ 20 → R$ 108
MCP servers (open source)	R$ 0
Hospedagem de scripts/skills	R$ 0 (local)

Para automação editorial intensa (10+ artigos/mês), plano Max compensa. Para automação ocasional (script aqui, refatoração ali), Pro é suficiente.

Erros comuns

1. Slash command não aparece no chat. Arquivo não está em .claude/commands/ ou tem erro de YAML no frontmatter. Verifica indentação.

2. Hook não dispara. Matcher pode estar errado. "Write|Edit" casa só Write e Edit. Para todos, deixe vazio ("").

3. MCP server não conecta. Variável de ambiente faltando ou versão do node antiga. node --version precisa ser 20+.

4. Sub-agent retorna informação que você já tem. Sub-agent começa do zero, sem contexto. Brief detalhado é obrigatório no prompt — não delegue com “veja o que tem aqui”.

5. Pipeline encadeado quebra no meio. Cada slash command precisa terminar instruindo o próximo. Sem isso, o pipeline para.

Quando NÃO usar Claude Code para automação

Honestidade técnica:

Pipeline com gatilho externo (webhook, schedule, evento): use n8n. Claude Code é interativo (você digita).
Time não-técnico vai operar: use n8n ou Make. Claude Code exige terminal.
Necessidade de UI visual: Claude Code é CLI. Para canvas, vai de Cursor + Composer.
Volume gigante de execuções automatizadas (10k+/dia): caro. Migra para Claude API direta + script.

A regra: Claude Code é ótimo para automação que você dispara, não para automação que precisa rodar 24/7 sem você. Para esse caso, n8n self-hostado é caminho.

Veredicto do V. Santos

Construí o pipeline editorial inteiro do CortexIA em Claude Code antes mesmo de pensar em hospedagem — porque sabia que ia mudar o pipeline 10 vezes no primeiro mês. Slash commands me deram velocidade de iteração que nenhum n8n daria: edito o arquivo .md, rodo de novo, ajusto. Em uma tarde reescrevi o agente revisor 3 vezes baseado no que aprendi com os primeiros artigos.

Depois que o pipeline estabilizou, considerei migrar tudo para n8n. Decisão final: deixei em Claude Code porque a criação de conteúdo continua sendo um processo interativo — eu disparo, reviso, ajusto, publico. Não preciso que rode às 3h da manhã sozinho.

Hooks tem sido o recurso mais subestimado. Configurei um hook PostToolUse que roda prettier em todo .md editado — economia de 30 segundos por artigo, ~9 min em 18 artigos. Pequeno, mas multiplica.

FAQ

O que é Claude Code? CLI agentic da Anthropic (fev/2025) que roda no terminal e executa tarefas inteiras em loop. Usa Claude Sonnet 4 ou Opus 4 por baixo. Pro US$ 20/mês, Max US$ 100-200/mês.

Como criar slash command no Claude Code? Crie arquivo .claude/commands/nome.md com frontmatter description: e instruções abaixo. Vira automaticamente /nome no chat.

Claude Code tem hooks? Sim. Configurados em .claude/settings.json. Eventos: UserPromptSubmit, PreToolUse, PostToolUse, Stop. Executam comandos shell.

O que são skills no Claude Code? Pacotes reutilizáveis (instruções + scripts + arquivos) que o agente pode invocar via Skill tool. Vivem em .claude/skills/.

Claude Code substitui CI/CD? Não. CI/CD roda em servidor sem você. Claude Code é interativo — você dispara. Para CI/CD use GitHub Actions ou similar.

Como rodar Claude Code em produção? Para automação ocasional disparada por você: local mesmo. Para 24/7 com triggers externos, migre o agente para n8n + Claude API.

Posso versionar a configuração Claude Code? Sim. Tudo em .claude/ (commands, settings.json, skills, agents) é texto e versionável no Git. É recomendado.

Próximo passo: instala Claude Code com npm install -g @anthropic-ai/claude-code. Cria um arquivo .claude/commands/teste.md com 2 linhas de instrução. Roda /teste no chat e vê funcionar em 5 minutos. Depois disso, vale ler o comparativo com Cursor e Copilot para decidir se Claude Code também substitui seu IDE assistant. Para mover automação para 24/7 sem você presente, o caminho é n8n com IA passo a passo.

Status: Entregue. Próximo: /revisor.