Claude Code CLI: Programação com IA · Capítulo 11 de 23 · 17 min
Revisar o plano antes de agir e ligar suas ferramentas
Planejar antes de editar e voltar atrás sem medo são os recursos que separam o uso básico do profissional.
Este capítulo faz parte do curso gratuito Claude Code CLI: Programação com IA.
Com o prompt (o pedido bem escrito), a leitura de arquivos e o CLAUDE.md resolvidos, faltam os mecanismos que a trilha de escritório da Parte 4 usa o tempo todo. São eles que separam quem usa a ferramenta no básico de quem a usa como profissional: planejar antes de editar, voltar atrás sem medo, empacotar tarefas recorrentes, conectar ferramentas externas e delegar trabalho para sub-agentes.
Antes de deixar o Claude editar arquivos, você pode pedir que ele apenas leia o código e proponha um plano. O atalho Shift+Tab alterna os modos de permissão da sessão; no modo de plano, o Claude analisa o projeto, descreve o que pretende fazer e espera sua aprovação antes de escrever qualquer linha. Compensa em toda mudança grande, porque você revisa a estratégia enquanto ela ainda é barata de corrigir. Uma mudança de agosto de 2026 pesa aqui: a partir de 14/08, sessões novas nos planos Pro, Max e Team começam no modo automático (auto mode) por padrão. Se você prefere aprovar passo a passo, use Shift+Tab para voltar ao modo manual logo ao abrir a sessão.
O plan mode brilha quando o erro sai caro: reorganizar de uma vez as pastas e os compromissos da semana. Suponha uma loja de roupas cujo dono quer arrumar num só pedido as pastas de fornecedores e a agenda de visitas: um passo errado mistura pedidos de coleções diferentes. Peça o plano completo antes de mover qualquer coisa e aprove com calma.
Pontos de restauração e /rewind. Durante a sessão, o Claude Code mantém pontos de restauração aos quais você pode voltar. O comando /rewind (ou pressionar Esc duas vezes) restaura o código, a conversa ou ambos a um estado anterior, sem depender do Git. É a rede de segurança que deixa você experimentar com liberdade: se uma refatoração não convenceu, um comando desfaz tudo.
Skills: sua biblioteca de tarefas recorrentes. Uma skill é uma pasta com um arquivo SKILL.md que descreve uma tarefa ou um conhecimento reutilizável, como uma receita guardada na gaveta. O Claude Code carrega a skill sob demanda, quando ela é relevante, sem inflar o contexto o tempo todo. Os antigos comandos personalizados, os slash commands que ficavam em .claude/commands/, foram unificados nas skills: hoje você empacota como skill aquilo que antes seria um comando próprio.
# Estrutura de uma skill:
.claude/skills/geo-audit/SKILL.md
# Dentro do SKILL.md, um cabeçalho descreve a skill e o corpo
# traz as instruções que o Claude segue quando ela é invocada:
---
name: geo-audit
description: Roda a auditoria GEO-16 da pagina atual
---
Quando invocada, leia a URL informada, valide o JSON-LD,
confira a densidade de entidades e gere um relatorio em PT-BR.MCP: conectar ferramentas externas. O Model Context Protocol (MCP) é o padrão que liga o Claude Code a sistemas fora do seu computador, como uma tomada universal: bancos de dados, APIs, o navegador Chrome, serviços como Google Drive. Com um servidor MCP configurado, o Claude passa a ler uma planilha, consultar um banco ou navegar uma página como parte da mesma conversa. O comando /mcp gerencia essas conexões.
Sub-agentes: delegar em paralelo. Um sub-agente é um Claude auxiliar, com contexto próprio, que recebe uma sub-tarefa e devolve apenas o resultado ao agente principal (o Claude que conduz a conversa com você). Serve para dividir trabalho pesado, como revisar segurança de um lado enquanto outro explora o código, sem poluir a conversa principal. Desde o fim de junho de 2026, os sub-agentes rodam em segundo plano por padrão: você dispara a sub-tarefa e segue trabalhando enquanto ela corre. Na Brasil GEO, o uso é concreto: sub-agentes em paralelo redigem vários artigos ao mesmo tempo, cada um com o seu material de origem.
Abra uma sessão numa pasta de teste, pressione Shift+Tab até aparecer o modo de plano e peça uma reorganização qualquer. Se o Claude devolver o plano e esperar o seu ok antes de mexer em um arquivo, você já tem a rede de segurança que a Parte 4 pressupõe.
O Claude Code roda em várias superfícies: terminal, app desktop (Windows e macOS: o sistema dos computadores da Apple), navegador em claude.ai/code, celular e extensões para VS Code e JetBrains (programas de escrever código). Todas compartilham o mesmo CLAUDE.md, as mesmas skills e as mesmas conexões MCP, então você começa uma tarefa no terminal e acompanha do celular. O Claude in Chrome, que abre e opera páginas no navegador, está disponível para todos os planos diretos da Anthropic desde o fim de junho de 2026, e o app de desktop ganhou um navegador embutido, além de o Claude Desktop ter entrado em beta no Linux (Ubuntu e Debian). Para aprender, comece pelo terminal: é a superfície que dá mais controle. As outras vêm naturalmente depois.
Não tente ativar tudo de uma vez. Comece usando o plan mode nas mudanças maiores e o /rewind quando algo der errado. Skills, MCP e sub-agentes entram quando você identificar uma tarefa que se repete ou uma ferramenta externa que precisa acessar.
Entre em uma pasta, pressione Shift+Tab e peça um plano antes de qualquer edição: a tela deve mostrar o modo de plano e a proposta, sem nenhum arquivo alterado. Depois, faça uma edição pequena e desfaça com /rewind. Se o arquivo voltar ao estado anterior, você tem a rede de segurança que skills, MCP e sub-agentes pressupõem.
Plan mode, /rewind, skills, MCP e sub-agentes formam o básico profissional. Em setembro de 2026, a documentação oficial acrescenta sete recursos com comando próprio, e cada um resolve um incômodo de quem já usa a ferramenta todo dia.
Sete recursos para depois do básico
| Recurso | O que é | Como começar | Quando compensa |
|---|---|---|---|
| Plugin | Um pacote que junta skills, sub-agentes, hooks e conexões MCP, como um aplicativo baixado da loja | /plugin install github@claude-plugins-official | Levar o mesmo jeito de trabalhar para o time inteiro |
| Marketplace | O catálogo de onde vêm os plugins; o oficial da Anthropic entra sozinho na primeira sessão | /plugin abre o menu | Procurar pronto antes de construir |
| Hook | Um comando que dispara sozinho num momento do trabalho, como o alarme que toca quando a porta abre | /hooks mostra o que está configurado | Avisar, formatar ou bloquear sem depender da memória de ninguém |
| Worktree | Uma cópia de trabalho separada do mesmo projeto, como duas mesas com a mesma pasta de arquivos | claude --worktree nome-da-tarefa | Duas tarefas no mesmo repositório sem uma pisar na outra |
| Sessão em segundo plano | A conversa continua rodando sem o terminal aberto | /background (ou /bg) e claude agents | Trabalho longo que não precisa de você a cada passo |
| Sessão na nuvem | O Claude Code rodando na infraestrutura da Anthropic, acompanhado pelo navegador ou pelo celular | claude.ai/code ou claude --cloud | Seguir com o notebook fechado |
| Artifact | Uma página interativa publicada no claude.ai a partir da sessão, privada até você compartilhar | Peça ao Claude um painel ou uma página | Mostrar o resultado a quem não abre terminal |
O agent view, a tela aberta por claude agents, está em versão de pesquisa. Sessões na nuvem e Artifacts valem para Pro, Max, Team e Enterprise, com as condições de assento de cada plano.
Para quem não programa, o hook mais útil é o aviso de que o Claude parou esperando você. Ele usa o evento Notification, que o Claude Code dispara quando aguarda uma resposta ou uma permissão, e roda um comando que mostra uma janela de aviso. Você troca de tela, cuida de outra coisa e só volta quando é chamado.
- Etapa 1 de 4: O Claude precisa de você
Pede uma permissão ou espera uma resposta
- Etapa 2 de 4: O Claude Code dispara o evento Notification
Sinal de que a sessão está parada
- Etapa 3 de 4: O hook roda o comando configurado
Escrito uma vez no settings.json
- Etapa 4 de 4: O aviso aparece na tela
Você volta ao terminal só quando é chamado
{
"hooks": {
"Notification": [
{
"matcher": "",
"hooks": [
{
"type": "command",
"command": "powershell.exe -Command \"[System.Reflection.Assembly]::LoadWithPartialName('System.Windows.Forms'); [System.Windows.Forms.MessageBox]::Show('O Claude Code precisa de você', 'Claude Code')\""
}
]
}
]
}
}No Windows, o trecho acima vai no arquivo ~/.claude/settings.json; no Mac, a página de hooks traz a versão com osascript. Sub-agente e worktree resolvem problemas diferentes. O sub-agente divide o trabalho dentro de uma sessão e devolve só o resumo. O worktree isola os arquivos: cada sessão edita a própria cópia, numa pasta dentro de .claude/worktrees/, com um ramo próprio no Git (uma linha paralela de alterações, como um rascunho ao lado do original). Na loja de roupas do exemplo do plan mode, um worktree arruma a página da coleção de verão enquanto outro corrige o cadastro de fornecedores, e uma mudança não atropela a outra. Cada mesa guarda o próprio trabalho.
Instale o hook de aviso, passe a sessão para o modo manual com Shift+Tab e peça algo que exija permissão. Acertou quando, com outra janela na frente, o aviso aparecer sem você voltar ao terminal para conferir.
A documentação de setembro organiza as extensões do Claude Code numa arquitetura só, e três detalhes mudam o uso. A busca de ferramentas do MCP vem ligada por padrão: o Claude carrega só o nome de cada ferramenta no início e puxa a descrição completa quando vai usá-la, então conector parado quase não ocupa contexto. Um sub-agente pode receber a própria cópia de trabalho (worktree) e editar em paralelo sem conflito. E os workflows dinâmicos são scripts que o próprio Claude escreve para rodar muitos sub-agentes em segundo plano e devolver um resultado consolidado.
Qual peça usar para cada necessidade
| Peça | O que é, em uma linha | Quando entra em ação | Use quando |
|---|---|---|---|
| CLAUDE.md | O contexto fixo da operação | Em toda sessão, inteiro | A regra vale sempre |
| Skill | Receita guardada, chamada por /nome ou pelo próprio Claude | Só quando é usada; com disable-model-invocation, só quando você chama | O procedimento tem vários passos |
| Sub-agente | Assistente com contexto próprio, que devolve só o resumo | Quando o Claude delega | A tarefa lateral poluiria a conversa principal |
| Hook | Script, chamada HTTP, ferramenta MCP, prompt ou sub-agente disparado num evento | Sempre, no evento configurado | A regra não pode depender da memória do modelo |
| MCP | A tomada para sistemas externos | Nome no início da sessão, detalhes sob demanda | O dado mora fora da sua máquina |
| Plugin | Pacote versionado com skills, sub-agentes, hooks e conexões MCP | Na instalação | O time inteiro precisa do mesmo conjunto |
| Workflow dinâmico | Script que coordena muitos sub-agentes | Quando o trabalho passa de um punhado de sub-agentes | Auditoria de uma base inteira, com verificação cruzada |
| Rotina | Sessão salva que roda na nuvem da Anthropic | Por agenda, chamada de API ou evento do GitHub | O trabalho precisa rodar com o notebook fechado |
Quando a mesma peça existe em mais de um nível, o CLAUDE.md soma todos os níveis, os hooks disparam todos, e skills, sub-agentes e servidores MCP valem pelo nome no nível de maior precedência.
Regra que não pode falhar: onde escrever
Só no CLAUDE.md
instrução
- Depende de o modelo ler, interpretar e lembrar
- Perde força numa sessão longa, com a janela cheia
- Serve para tom, formato e preferência
Num hook
garantia
- Dispara sempre no evento, como o alarme que toca quando a porta abre
- Não gasta contexto, a menos que devolva texto
- Serve para bloquear, formatar ou avisar sem exceção
Pense numa corretora de seguros de seis pessoas que proíbe mandar a planilha de clientes para fora da empresa. Escrita só no CLAUDE.md, a regra depende da atenção do modelo; num hook do evento PreToolUse (o instante antes de uma ferramenta rodar), ela barra a ação toda vez. O app Claude Desktop, para macOS, Windows e Linux em beta, divide com o terminal as configurações, as skills, os servidores MCP e as permissões, então o mesmo hook vale nas duas telas. Liste as três regras da sua operação que nunca podem falhar. Acertou quando cada uma morar num hook ou numa regra de bloqueio do /permissions, além do CLAUDE.md.
Na equipe de conteúdo, a regra que não pode falhar costuma ser esta: nada vai ao ar sem checagem de fatos e de marca. Escrita no CLAUDE.md, ela depende da atenção do modelo. Num hook do evento PreToolUse, ela confere cada tentativa de publicar e devolve o motivo ao Claude quando falta a checagem. A documentação garante que um hook com bloqueio vale em qualquer modo de permissão, inclusive no automático, que desde 14 de agosto de 2026 é o padrão das sessões novas nos planos Pro, Max e Team.
Montar o hook que bloqueia publicação sem checagem
O cenário: o blog da empresa vive num repositório, cada post é um arquivo Markdown na pasta posts/ e publicar é dar git push. A checagem aprovada é marcada com a linha checagem: ok no cabeçalho do post.
Passo 1: Combine a marca de checagem com quem revisa
A revisora acrescenta a linha checagem: ok no cabeçalho do post depois de conferir fatos, links e voz da marca.
Deu certo quando: os posts revisados do mês passado têm a linha, e os rascunhos não têm.
Erro comum: deixar o próprio Claude escrever a linha; a marca só vale se vier de uma pessoa.
Passo 2: Salve o script .claude/hooks/checar-publicacao.sh
Ele lê o comando que o Claude vai rodar, ignora tudo que não é git push e lista os posts novos ou alterados sem a linha de checagem.
Deu certo quando: o arquivo está na pasta .claude/hooks/ do projeto, com o conteúdo do bloco abaixo.
Erro comum: no Mac e no Linux, esquecer o chmod +x; o hook não roda sem permissão de execução.
Passo 3: Registre o hook no .claude/settings.json do projeto
Evento PreToolUse, com o filtro Bash|PowerShell, para cobrir também o Windows sem Git Bash.
Deu certo quando: o /hooks lista o hook no evento PreToolUse.
Erro comum: gravar no settings.local.json, que fica fora do repositório e não chega ao resto do time.
Passo 4: Teste com um rascunho sem checagem
Peça ao Claude: publique o post novo sobre a campanha de Black Friday.
Deu certo quando: o Claude para, mostra Publicação bloqueada com o nome do arquivo e oferece mandar o post para revisão.
Erro comum: testar com um post já aprovado e concluir que o hook funciona sem tê-lo visto bloquear.
Passo 5: Some uma regra de bloqueio para o push direto
No /permissions, a regra Bash(git push --force *) na lista de bloqueio fecha o atalho de quem tenta sobrescrever o histórico.
Deu certo quando: a regra aparece na lista de bloqueio do /permissions.
Erro comum: confiar só no filtro do hook; a documentação descreve a leitura do comando como de melhor esforço.
No fim você tem: um repositório de conteúdo em que o Claude escreve, edita e prepara a publicação, mas o post só sai com a checagem de uma pessoa.
#!/bin/bash
# .claude/hooks/checar-publicacao.sh
# Bloqueia o git push quando um post novo ou alterado não tem "checagem: ok".
CMD=$(jq -r '.tool_input.command // empty')
case "$CMD" in
*"git push"*) ;;
*) exit 0 ;;
esac
PENDENTES=$(git diff --name-only --diff-filter=AM origin/main...HEAD -- posts \
| while read -r f; do grep -qx 'checagem: ok' "$f" || echo "$f"; done)
if [ -n "$PENDENTES" ]; then
echo "Publicação bloqueada. Falta a checagem em: $PENDENTES" >&2
exit 2
fi
exit 0{
"hooks": {
"PreToolUse": [
{
"matcher": "Bash|PowerShell",
"hooks": [
{
"type": "command",
"command": "\"$CLAUDE_PROJECT_DIR\"/.claude/hooks/checar-publicacao.sh"
}
]
}
]
}
}O código de saída 2 é o que bloqueia: o Claude Code cancela o comando e entrega ao Claude a mensagem escrita no erro, e ele ajusta o plano em vez de insistir. O script usa o jq para ler o pedido, e no Windows o comando do hook roda pelo Git Bash quando ele está instalado.
Se o time publica por um conector MCP do gerenciador de conteúdo, troque o filtro pelo nome da ferramenta de publicar, no formato mcp__servidor__ferramenta. Acertou quando o rascunho sem checagem for barrado e o post aprovado subir sem nenhuma pergunta extra.
Perguntas frequentes deste capítulo
O que é o plan mode e em que momento devo usá-lo?
Cometi um erro e quero desfazer sem mexer no Git. Dá para voltar?
Quando uma tarefa minha deveria virar uma skill?
Preciso entender de MCP para começar a usar o Claude Code?
Se eu disparar um sub-agente, meu trabalho principal fica travado esperando?
Ligar vários conectores MCP deixa o Claude Code mais lento ou mais caro?
Qual a diferença entre uma skill e um hook?
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
- CursoSetup Completo: do zero ao Claude Code
- Veja o que o Claude Code faz antes de instalarsugerido pelo grafoApresenta o conceito “Claude Code”, usado em “Revisar o plano antes de agir e ligar suas ferramentas”.
- Usar o mapa do curso e o glossário mínimosugerido pelo grafoApresenta o conceito “MCP”, usado em “Revisar o plano antes de agir e ligar suas ferramentas”.
- CursoSaúde Mental para Autistas em IAsugerido pelo grafoO curso de saúde mental termina com o plano pessoal para sustentar hiperfoco, pausas e limites enquanto se trabalha com assistentes de código, e a página de conclusão já encaminha para o curso de Claude Code. A ordem declara esse caminho quando as 21 aulas ganharam página própria (Etapa 4, wave 3), para que mostrem o que estudar depois.
Conceitos deste capítulo
O mesmo assunto em outros cursos
- Setup Completo: do zero ao Claude CodeVeja o que o Claude Code faz antes de instalarExaminar conexões de Veja o que o Claude Code faz antes de instalar
- Vídeo com IA: Claude Code, Codex e ElevenLabsEstruturar o projeto de vídeo para o Claude Code operar sem improvisarExaminar conexões de Estruturar o projeto de vídeo para o Claude Code operar sem improvisar
- VS Code: Do Zero ao Editor ProfissionalClaude Code: o que um líder faz sem programarExaminar conexões de Claude Code: o que um líder faz sem programar
- Setup de Vibecoding no MacUsar Claude Code dentro do VS CodeExaminar conexões de Usar Claude Code dentro do VS Code
Voltar ao capítulo anterior: Escrever o CLAUDE.md, o manual que o Claude sempre lê
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.
Capítulos vizinhos em Claude Code CLI: Programação com IA
- 09Ler, comparar e editar documentos com IA
- 10Escrever o CLAUDE.md, o manual que o Claude sempre lê
- 11Revisar o plano antes de agir e ligar suas ferramentas
- 12Usar o agente do Claude no escritório, sem abrir o terminal
- 13Ligar o Claude ao e-mail, à agenda e aos seus sistemas