MÓDULO 2.3

🧹 /clear, /rewind, /compact — Reset Cedo

Três comandos oficiais, três momentos diferentes. Use o menos drástico que resolva. E resete cedo — antes do contexto apodrecer.

6
Tópicos
35
Minutos
Básico
Nível
Prática
Tipo
1

🆑 /clear — começar do zero

Comando oficial do Claude Code que zera a sessão atual e abre uma nova, vazia. É o mais drástico dos três — e também o mais econômico. Zera input acumulado, revive cache do zero, corta context rot pela raiz.

/clear

Reset total da sessão

Começa sessão vazia. CLAUDE.md é re-injetado automaticamente. Arquivos no disco permanecem inalterados.

alias: /reset alias: /new

O que /clear faz

🗑️
Apaga histórico da conversa atual
🗑️
Apaga arquivos lidos cacheados em sessão
♻️
Recarrega CLAUDE.md (automaticamente)
💾
Preserva arquivos no disco e a sessão anterior em /resume

🔍A sessão não é perdida: /resume

/clear não deleta a sessão anterior. Ela fica acessível via /resume, onde você vê a lista e pode reentrar se precisar.

/resume
→ lista sessões anteriores por data
→ selecione e retome de onde parou

🎯Quando /clear é a resposta

  • Contexto "infectado" — muitas idas e vindas, correções em cascata
  • Terminou uma feature, vai começar outra
  • Sessão já passou dos ~40 turnos
  • Detectou qualquer sintoma de context rot
2

/rewind — volta conversa E arquivos

/rewind é o "undo" real do Claude Code. Diferente do git, ele volta tanto a conversa quanto os arquivos editados. É cirúrgico: volta o necessário, mantém o resto.

/rewind

Undo combinado: conversa + arquivos

Retorna para um ponto anterior da sessão, revertendo também as mudanças feitas nos arquivos. Perfeito para "uma tentativa deu ruim, quero o estado de antes".

alias: /checkpoint alias: /undo

Comparação: /rewind vs git reset

Aspecto /rewind git reset
Volta arquivos
Volta conversa
Precisa de commitsnãosim
Granularidadepor turnopor commit
Escoposessão Clauderepo

Exemplo de uso

turno 8
você: "passo 2 concluído, segue para 3"
turnos 9-12
tentativa do passo 3 — deu ruim, solução tortuosa
turno 13
você: "/rewind" → volta para o estado após turno 8
turno 14
você: "vamos tentar o passo 3 de outro jeito — use abordagem X"

Passos 1 e 2 preservados. Apenas a tentativa ruim foi descartada.

🎯Quando /rewind é a resposta

  • Erro pontual numa sessão que no geral está boa
  • Claude tomou um caminho errado, quer voltar e reexplicar
  • Edit errado que contaminou arquivos
  • Quer experimentar abordagem B sem perder o que veio antes
3

🗜️ /compact [instruções]

/compact é o meio-termo: mantém a sessão viva, mas condensa o histórico em um resumo estruturado. Útil quando o trabalho está bom, o rumo está certo, mas o contexto ficou grande.

/compact

Resume mantendo sessão

Condensa o histórico em síntese, libera espaço, preserva continuidade. Aceita instruções opcionais para focar o resumo.

/compact [foco opcional]

Exemplos de uso (com foco)

/compact

Compactação genérica — Claude resume o que achar mais relevante.

/compact foco em decisões de arquitetura

Preserva as escolhas técnicas principais, corta explicações paralelas.

/compact manter apenas o estado atual dos arquivos editados

Síntese mínima — útil quando quer baixar o máximo de tokens.

/compact incluir todos os erros que apareceram e como foram resolvidos

Preserva lições — útil antes de tarefas similares na mesma sessão.

Antes do compact

Histórico~80k tokens
30 turnossaturando
Statuslento, caro

Depois do compact

Resumo~8k tokens
Contextocontinua
Statusrápido, barato

🔁/compact não é /clear

Compact mantém a sessão ativa e a memória do que foi discutido (em forma resumida). Clear começa zero. Use compact quando quer continuidade; clear quando quer ruptura.

🎯Quando /compact é a resposta

  • Sessão longa mas produtiva — quer continuar, não recomeçar
  • Trabalho exploratório com muitas idas e vindas
  • Passou de 20–30 turnos e quer seguir sem reset
  • Vai fazer uma pausa e não quer perder rumo
4

🕐 Fluxograma: quando cada um

Três perguntas em sequência. Decisão em menos de 5 segundos. Sem dúvida de qual comando usar.

Árvore de decisão

PERGUNTA 1
A última tentativa deu errado e o resto da sessão está ok?
SIM →
/rewind

Volta ao último estado bom, tenta de outro jeito.

NÃO →

Continue para pergunta 2 ↓

PERGUNTA 2
A sessão está longa, mas o trabalho e o rumo estão bons?
SIM →
/compact

Resume, libera espaço, continua.

NÃO →

Continue para pergunta 3 ↓

PERGUNTA 3
Contexto confuso, context rot, ou vai começar algo novo?
SIM →
/clear + handoff

Reset total. Comece limpo (Trilha 3 ensina o handoff).

Cheat sheet — um olhar, uma decisão

Situação Comando Drasticidade
Último edit estragou tudo/rewindbaixa
Sessão longa, rumo bom/compactmédia
Quer pausa com resumo/compactmédia
Context rot visível/clearalta
Terminou uma feature/clearalta
Tudo bem, mas passou dos 30 turnos/compactmédia
Regra única

Use o menos drástico que resolva.

Rewind < Compact < Clear. Comece pelo mais leve.

5

📏 Regra dos 20–30 turns

Não espere desastre. A cada 20–30 turns, considere um reset preventivo — mesmo que nada pareça errado. É a faixa onde context rot começa a aparecer silenciosamente.

Zonas de saúde da sessão (em turns)

0–15
Zona verde
Sessão fresca. Cache funcionando bem. Qualidade no pico.
15–25
Zona azul — atenção
Ainda ok, mas monitore. Considere /compact se vai pausar.
25–35
Zona amarela — aja
/compact preventivo recomendado. Rot silencioso pode aparecer.
35+
Zona vermelha — reset
Qualquer decisão exceto reset é desperdício. /clear + handoff.

✓ Reset preventivo (turno ~25)

Custo do compact~US$ 0,08
Qualidade apósalta
Retrabalho evitado~0

✗ Reset tardio (turno 50+)

Tokens desperdiçados~300k
Qualidade antesbaixa
Retrabalho acumuladoalto

Ritual: "a cada 25, reflita"

Quando perceber que a sessão passou de 25 turns (rápido de contar olhando a UI), pergunte a si mesmo: "o rumo está bom? o contexto está limpo?". Se sim, /compact. Se não, /clear. Quase nunca "continuar como está".

6

🔁 Não empurrar quando der errado

Quando uma tentativa dá ruim, a reação natural é "tenta de novo". É a pior coisa que você pode fazer. Empurrar adiciona ruído ao contexto sem resolver a causa. Reorganize em vez de insistir.

Padrão errado — "força bruta contextual"

turno N
claude: [solução errada]
turno N+1
você: "não é isso, tenta de novo"
turno N+2
claude: [outra solução errada, variação da primeira]
turno N+3
você: "ainda não, tá próximo mas..."
...
ciclo continua, contexto satura, qualidade despenca

Padrão correto — reorganize

Escolha um dos três caminhos, dependendo do diagnóstico:

/rewind→ Volte antes do erro

Se a tentativa foi recente, volte ao ponto bom e tente outro caminho.

💬→ Reexplique com mais contexto

Se foi mal-entendido, forneça restrições explícitas antes de pedir de novo. "não é bcrypt, é argon2, e o salt vem do env".

/clear→ Reset + handoff

Se o contexto virou caos, recomece. Handoff estruturado preserva o essencial (Trilha 3).

🧠Analogia

"Tenta de novo" para o Claude é como dizer "pensa de novo" para um humano exausto. Ele não vai pensar melhor — vai pensar na mesma coisa, só mais cansado.

Reset = descansar e recomeçar com cabeça fresca. /rewind = voltar ao ponto onde ainda estava bem. Reexplicar = dar mais luz. Qualquer um > insistir.

Gatilhos: pare de empurrar quando...

🔁
Você disse "não é isso" 2+ vezes seguidas
😤
Sua frustração está crescendo
🌀
Claude está dando variações da mesma coisa
📏
Os turnos estão crescendo sem progresso
Regra de ouro

Quando der errado, reorganize. Nunca empurre.

Reset/rewind custa pouco. Empurrar custa muito mais.

📋Resumo do Módulo

/clear — reset total — aliases /reset, /new, sessão fica em /resume
/rewind — undo real — volta conversa E arquivos, aliases /checkpoint, /undo
/compact [foco] — resume mantendo sessão, aceita foco opcional
Fluxograma de 3 perguntas — decisão em 5 segundos
Regra dos 20–30 turns — reset preventivo antes de rot aparecer
Nunca empurre quando der errado — reorganize: rewind, reexplique, ou reset

Próxima trilha:

T3 — 🔗 Handoff Estruturado

Como resetar sem perder contexto: formato de handoff, CLAUDE.md, resumos entre sessões.