🗺 Mapa da trilha
⚙ Claude Code: o motor
8 tópicos: claude.md, plan mode, subagentes, worktrees, MCP
🚀 Movimentos de alto impacto
8 tópicos: /compact, auto mode, verificação, slash commands, /insights
🚀 Cheat Code: parar de babar Claude
6 tópicos: identificar, transformar em automação, sinais do N5
🎯 Cases reais de Claude Code
claude.md em 4 atualizações, plan mode evita 1 dia de refactor, 3 worktrees paralelas
🎬 Walkthrough: bug sexta 23h → PR segunda 8h
Mariana, 2h13 trabalhadas, domingo intocado. Plan mode + subagentes + verification loop + slash command
📚 Conteúdo detalhado
⚙ Claude Code: o motor
Os 8 elementos centrais de quem trabalha com Claude Code todos os dias.
Claude Code roda como CLI no terminal ou como aba Code no Claude Desktop. Mesmo engine, interface diferente. Terminal é mais rápido depois que acostuma.
Não precisa ser dev terminal-fluente — comece pela aba Code, evolua quando quiser velocidade.
CLI · Desktop · Mesmo modelo · Mesmas features · Curva de aprendizado opcional.
Markdown na raiz do projeto. Claude lê em toda conversa: stack, convenções, papel, regras. Regra de ouro: ≤200 linhas. Use @arquivo pra detalhes só quando precisar.
É o que separa N4 de N3. Sem isso, Claude reinventa convenções a cada sessão.
Stack · Convenções · Papel · Regras · @ pra detalhes · Atualize quando errar.
Quando Claude erra, diga "atualize o claude.md pra não fazer isso de novo". A própria Anthropic faz isso. Em semanas, o arquivo treina Claude no seu jeito.
É o loop que separa N4 médio de N4 dominante.
Erro = oportunidade · Regra escrita > regra falada · Versão controlada · Compartilhe no time.
Shift+Tab 2x ativa plan mode: Claude lê o código, apresenta plano, espera sua aprovação. Opus Plan: Opus planeja, Sonnet executa. Custo metade, qualidade igual.
Aprovar plano explícito reduz refactors. Opus Plan é o atalho de custo mais subestimado.
Plano antes do código · Aprovação humana · Opus pra planejar · Sonnet pra executar.
Claudes especializados pra trabalhos específicos: um pra testes, um pra segurança, um pra docs. Cada um roda em contexto próprio — ruído de um não polui o outro.
Você monta um "time de engenharia" com especialistas. Múltiplos em paralelo.
Context isolado · Especialista por papel · Comunicação via main session · Não conversam diretamente.
claude-worktree feature-name cria workspace git isolado por branch. Abre outro terminal e roda outro. 3-4 sessões paralelas sem conflito de arquivos.
É como Boris Cherny (criador do Claude Code) trabalha: 5 sessões mínimo todo dia.
Isolated git workspace · Branch própria · Sem conflito · Sweet spot 3-4.
Model Context Protocol conecta ferramentas externas. Mas a regra (da própria Anthropic) é: CLI primeiro, endpoints REST depois, skills em seguida, MCP só quando nada mais cabe. CLI gasta 60-70% menos tokens.
Quem ignora essa hierarquia paga 3x mais em tokens e perde contexto rápido.
CLI tools (gh, aws, gcloud) · APIs REST · Skills · MCP último.
Feature de Janeiro/2026: quando MCP passa de 10% do contexto, Claude defere carregamento de tools até precisar. Reduz overhead em 85%, zero config.
Quem usa MCP precisa entender isso — é a feature que torna MCP viável em sessões longas.
10% trigger · Tool search automático · Carregamento sob demanda · Mais MCP sem pagar contexto.
🚀 Movimentos de alto impacto
Os 8 hábitos que distinguem usuário casual de power-user.
/compact resume o histórico antigo em um sumário tight (rode proativamente, não espere o warning). /context mostra onde seus tokens estão indo. Combinado com prompt caching: -60-90% de custo em sessões longas.
Janela de 1M no Opus 4.7 ainda fica sloppy depois de 50%. Quem controla, paga menos e mantém qualidade.
/compact proativo · /context pra debug · Prompt caching automático · 50% é o gatilho.
Shift+Tab cicla pro auto mode: comandos seguros passam por classifier em vez de pedir aprovação. /focus oculta intermediários, mostra só resultado final.
Parar de apertar "yes" 30x por sessão libera você pra rodar paralelo de verdade.
Auto mode · Classifier de segurança · /focus · Switch entre sessões.
Boris Cherny diz que esse é o hábito mais importante do N4: dê a Claude jeito de checar o próprio trabalho (extensão Chrome pra abrir browser, screenshot, rodar testes) e itere até PASS.
Boris diz que dobra ou triplica a qualidade do output.
Self-test · Chrome extension · Screenshots · Não me chame antes de PASS.
Se você digitou o mesmo prompt duas vezes, transforme em slash command. Boris usa /commit-push-pr dezenas de vezes por dia. Vivem em .claude/commands/.
Cada slash é uma macro pessoal. Multiplique por 20 — sua produtividade explode.
.claude/commands/ · Compartilhável com time · Versionado em git · /commit-push-pr clássico.
/rewind (ou Esc Esc) descarta tentativa falha sem poluir contexto. /btw deixa você fazer pergunta paralela sem quebrar o fluxo. /branch (antigo /fork) bifurca a conversa pra testar caminhos diferentes.
São "controle de versão" do raciocínio. Pareia perfeitamente com worktrees.
Rewind = limpar fracasso · BTW = dúvida lateral · Branch = experimento.
Lê seu último mês de uso e gera relatório: padrões repetitivos, gastos de tokens, prompts candidatos a virar skill, regras pra adicionar no claude.md.
Maioria não tem dado do próprio uso. Roda 1x/mês, vira mapa de melhoria.
Audit pessoal · Padrões · Candidatos a skill · Regras de claude.md emergem.
/output style new troca a "personalidade" do Claude Code. Built-ins: default, explanatory, learning. Custom: code reviewer mode, no-fluff, documentation writer.
Mesma ferramenta cobre 10 papeis diferentes sem misturar.
Built-in vs custom · Por projeto · Style trocável a quente.
PRs N4 trazem: contexto do problema, plano executado, arquivos alterados com motivo, evidência de testes/checks, riscos conhecidos. Padrão de PR é parte do claude.md.
PR bom é diferença entre cliente que paga R$ 25k e cliente que vira recorrente.
Template de PR no claude.md · Evidência de teste · Riscos listados · Revisão por subagente.
🚀 Cheat Code: parar de babar Claude
A passagem do N4 pro N5 é mental, não técnica.
A maioria no N4 vira babá: dispara sessões e fica olhando cada uma. Identifique 3 tarefas que você faz manualmente embora poderiam ser slash command, skill ou hook.
Babá é o gargalo. Sai do gargalo = sobe pro N5.
Auditar 1 semana · 3 tarefas-babá · Cada uma vira automação.
Tarefa repetitiva: slash command. Workflow complexo: skill. Validação automática em momento específico: hook (pré-N5). Cada uma das 3 tarefas-babá vira um desses.
Escolher a abstração certa = manutenção fácil.
Slash = atalho · Skill = workflow · Hook = trigger automático.
Gerenciar paralelo na unha · não usar plan mode · pular verificação · claude.md gigante · ignorar /insights · MCP-first em vez de CLI-first.
Cada erro é um teto invisível. Cair em 2-3 deles = você ficou 1 ano sem evoluir.
Gerenciamento ≠ babá · Plan mode default · Verificação obrigatória · CLI antes de MCP.
Você sente "isso podia rodar todo dia 8h sem eu precisar abrir o laptop". É o teto do N4 — entra o N5 (rotinas em nuvem).
Reconhecer evita "espremer N4" e demorar pra subir.
Rotina vs sessão · Sem máquina · 24/7 · Sleep-friendly.
N4 entrega sistemas reais — não automação isolada. Cobre por valor: o cliente paga R$ 50k porque a feature destrava R$ 500k/ano em receita ou poupa 2000h de equipe.
É onde freelance vira agência sustentável.
ROI explícito · Escopo fechado · Manutenção mensal · Cliente que entende valor.
Antes de habilitar N5: escolha 1 rotina baixíssimo risco (resumo diário que só vem pra você). Roda manual 5x. Se passar nas 5, agenda. Confiança se constrói, não se assume.
Pular essa etapa = automação que destrói confiança no 1º bug.
Baixo risco primeiro · Manual antes de cron · 5 rodadas mínimo · Só você como destinatário.
🎯 Cases reais de Claude Code
3 cases técnicos: claude.md mal feito vs após 4 atualizações reais, custo de pular plan mode (1 dia perdido), coordenação de 3 worktrees paralelas.
📜 Case 1 — claude.md: evolução em 4 atualizações
Lucas, tech lead. De 180 linhas (v1) inchadas a 87 linhas (v4) focadas + @docs/claude/. -65% tokens baseline, 4 → 0 erros recorrentes/semana.
📋 Case 2 — Pular plan mode custou 1 dia
Patrícia perdeu 1 dia em rebase porque sua feature conflitou com PR em vôo. Plan mode de 8min na segunda tentativa salvou tudo + identificou conflito automaticamente.
🌳 Case 3 — 3 worktrees paralelas, dia inteiro em 3h22
Igor: feature de tags + bug timezone + docs API em paralelo. 9h sequencial → 3h22 paralelo. Plan mode só onde paga, /focus, slash commands.
🧠 Padrão N4 — 5 ingredientes
claude.md reage a erros, plan mode obrigatório em >3 arquivos, worktrees+focus+slash = paralelo sem babá, Claude pergunta quando ambíguo, você é quem mergeia.
🎬 Bug sexta 23h12 → PR mergeado segunda 8h
Mariana, plantão. Cliente enterprise reportou P1. Você acompanha 2h13 de trabalho no sábado de manhã — sem queimar o fim de semana.