💡Dica prática: pare de usar /compact no Claude Code
Santiago, engenheiro e criador de conteúdo sobre IA, compartilhou uma dica que vale ouro pra quem usa Claude Code no dia a dia. Resumo: pare de usar o comando /compact quando o contexto encher. --- O /compact pega toda a conversa e comprime num resumo. Parece eficiente, mas você perde até 70% dos detalhes importantes. E o contexto resumido morre quando a sessão fecha. A alternativa é melhor: (1) salve toda a conversa num arquivo markdown, (2) use /clear pra limpar o contexto, (3) comece o próximo prompt apontando pro arquivo. Assim você não perde nada, controla o que está ali e o contexto sobrevive entre sessões. Faça handoff, não cleanup.
I'm spending so much time managing context, and I hate it. Here is a tip for you: don't use /compact any more in Claude Code. There's a much better option. /compact takes your entire conversation history in memory and compresses it into a summary. This frees up tokens, but you'll lose a ton of important details (sometimes up to 70% of what matters!). On top of that, the summarized context is still tied to the current session and won't persist beyond it. Here is what you should do instead: 1. Dump the entire conversation history to a markdown file 2. Call /clear to clear the context 3. Start your next prompt by pointing to the markdown file There are several advantages to doing this: 1. You don't lose any valuable information 2. You control what's in the file 3. The context persists beyond the current session In summary, when you hit a context limit, do a *handoff*, not a *cleanup*.
— @svpino View on X
Quem usa Claude Code intensivamente para desenvolvimento já enfrentou o aviso de limite de contexto. A tentação imediata é rodar o comando /compact para liberar tokens e continuar a conversa. Mas essa prática compromete a qualidade do trabalho: você perde até 70% dos detalhes relevantes da conversa e mantém o gargalo de sessão. A solução é abandonar a compressão automática e adotar uma estratégia de handoff manual com arquivos markdown.
O custo oculto da compressão
O comando /compact foi desenhado como atalho para gerenciar a janela de contexto da LLM. Ele resume todo o histórico da conversa em um parágrafo sintético, liberando espaço para novos tokens. O problema é que a compactação é lossy: nuances de decisões técnicas, alternativas descartadas e explicações detalhadas de bugs desaparecem no processo. Além disso, o resumo gerado está preso à sessão atual. Fechou o terminal? Perdeu o contexto.
Para projetos complexos — especialmente aqueles com múltiplos arquivos, refatorações ou debugging longo — perder metade da conversa significa reconstruir raciocínios ou repetir comandos. É tempo desperdiçado e, em ambientes de produção, risco de inconsistência.
Como fazer o handoff corretamente
A alternativa exige três passos simples, mas que preservam 100% da informação:
- Exporte o histórico completo para um arquivo markdown usando o comando de dump do Claude Code
- Execute /clear para zerar o contexto atual e resetar o contador de tokens
- Inicie a nova sessão referenciando o arquivo salvo no primeiro prompt
Essa abordagem transforma o contexto volátil em documentação persistente. Você edita o markdown antes de reintroduzir, removendo tentativas falhas ou logs irrelevantes. O arquivo pode ser versionado no Git, consultado em outras ferramentas ou compartilhado com o time.
Impacto na produtividade de devs brasileiros
Para desenvolvedores brasileiros trabalhando com Claude Code, a gestão eficiente de contexto é crítica. Sessões longas são comuns em sprints apertadas ou manutenção de legacy code, onde o histórico de interações contém regras de negócio complexas. Manter esse histórico em arquivos markdown locais também reduz dependência de infraestrutura externa e facilita conformidade com políticas de dados que exigem auditoria de prompts.
O handoff manual exige disciplina, mas elimina a surpresa de ver a LLM "esquecer" constraints importantes que foram compactadas. Em termos de engenharia de prompts, você mantém o controle semântico total sobre o que entra na janela de contexto — algo que /compact nunca ofereceu.