MODULO 1.4

💀 Compactacao: o momento em que a memoria morre

Compactacao nao e opcional — e o mecanismo que deixa Claude funcionar em sessoes longas. O problema e o que ela custa.

6
Topicos
30
Minutos
Medio
Nivel
Teoria
Tipo
1

🌀 O que e compactacao

Quando a sessao se aproxima do limite da janela de contexto, Claude Code resume o historico para caber em menos tokens e continuar.

{' GATILHO DE COMPACTACAO \n \n Sessao cresce ──────────────► limite da janela \n ~170k tokens ~200k tokens \n \n Sem compactacao: \n sessao quebra (context overflow) \n \n Com compactacao: \n resume ────► sessao reduzida ────► continua \n'}
2

🧠 Como Claude decide o que manter

A heuristica de resumo nao e documentada publicamente, mas o padrao observado prioriza: recencia, marcos e decisoes explicitas.

📊 Hierarquia de sobrevivencia

  1. System prompt + CLAUDE.md (100% preservado)
  2. Ultimas 5-10 mensagens (100% preservado)
  3. Marcos anunciados ("vou fazer X", "decidimos Y") — frequentemente preservado
  4. Tool calls e resultados antigos — resumido em 1-2 linhas
  5. Detalhes de exploracao que nao viraram acao — frequentemente descartado
3

🫥 O efeito "amnesia pos-cirurgia"

Apos compactacao, Claude "sabe" que voces trabalharam em X, mas perdeu como. Resultado: sugere abordagens ja descartadas.

🚨 Sintoma tipico

Voce: "vamos continuar no bug da autenticacao"

Claude: "Otimo! Ja checou se o token esta sendo enviado no header?"

Voce: "Sim, debatemos isso ha duas horas. Foi outra coisa."

4

🎞️ Anatomia de uma sessao 500k

Exemplo real de compactacao em sessao de debugging longa.

1

Pre-compactacao (0-170k tokens)

20 mensagens detalhadas com investigacao, hipoteses, tool calls, logs lidos.

2

Compactacao (trigger automatico)

Claude Code gera resumo de ~3 paragrafos e mantem as ultimas 2 mensagens integrais.

3

Pos-compactacao (20k tokens)

Detalhes de investigacao perdidos: ~80%. Hipoteses descartadas: mencionadas como "foi tentado X e Y" sem o porque.

5

🛟 O que sobrevive

Zonas de sobrevivencia sao lugares no prompt que sempre sao preservados.

Zonas garantidas

  • ✓System prompt: preservado sempre
  • ✓CLAUDE.md: re-injetado apos resumo
  • ✓additionalContext de hook: injetado novamente via PreCompact
  • ✓Ultimas N mensagens: mantidas integras
6

🪝 PreCompact: a saida

O hook PreCompact dispara antes do resumo. Nele voce re-injeta seu contexto critico para garantir sobrevivencia.

{' TIMELINE DO PRECOMPACT \n \n Sessao ~170k tokens \n │ \n ▼ (PreCompact hook dispara aqui) \n [seu script injeta context.md] \n │ \n ▼ \n Claude Code compacta — context.md ja esta no prompt \n │ \n ▼ \n Sessao continua com contexto critico preservado \n'}

💡 Dica

Trilha 4, modulo 4.3 e 4.4 ensinam o setup completo. Voce vai ter o seu PreCompact rodando em menos de 30 minutos.

📝 Resumo do Modulo

✓
Compactacao e inevitavel em sessoes longas — e mecanismo de sobrevivencia.
✓
~80% de detalhes somem — especialmente raciocinio e hipoteses descartadas.
✓
PreCompact e o antidoto — injeta contexto critico antes do resumo.

Proximo Modulo:

1.5 — Fingerprint cognitivo: nao existe one-size-fits-all

← Modulo anteriorProximo Modulo →