Devo rodar o /compact do Claude Code em intervalos fixos? Definindo o momento certo pela documentação oficial
Muita gente aperta o /compact do Claude Code seguindo uma regra do tipo "a cada 30 minutos" ou "quando o contexto passar de 70%", mas o que a documentação oficial recomenda não é nem relógio nem porcentagem: é uma pausa no trabalho. Rode o /compact em um ponto de corte natural, por exemplo entre tarefas, em vez de esperar o auto-compact disparar no meio de uma tarefa. Este artigo toma a documentação do Claude Code em 8 de agosto de 2026 (versão mais recente v2.1.226) como fonte primária e resolve a questão da compactação manual a partir da especificação. Ele começa pela maquinaria: a compactação roda em três estágios, a saber, o descarte de saídas antigas de ferramentas, o auto-compact e o /compact manual que você aperta. O segundo e o terceiro são o mesmo processamento, então apertá-lo você mesmo compra exatamente duas coisas, escolher o momento e especificar o que manter. Apertar com mais frequência não economiza contexto extra. Em seguida vem uma tabela do que sobrevive. O CLAUDE.md da raiz do projeto e a sua memória automática são reinjetados do disco, enquanto regras com paths: e arquivos CLAUDE.md aninhados em subdiretórios são perdidos até que um arquivo correspondente seja lido de novo, e os corpos das skills que você invocou são reinjetados sob um teto de 5.000 tokens por skill e 25.000 no total, descartando os mais antigos primeiro. Sobre custo, o preço de uma compactação é definido não pelo tamanho do contexto, e sim pelo cache de prompt estar quente ou não. Aperte no meio da sessão e o prefixo é lido do cache, o que sai barato; aperte depois de uma pausa mais longa que a vida útil do cache (uma hora em assinatura, cinco minutos por padrão via chave de API) e todo o histórico é reprocessado sem cache, o que é o mais caro que esse comando chega a ser. Daí em diante o artigo cobre como escolher entre /compact, /clear, /rewind, /recap e /context, como o /autocompact a partir da v2.1.221 move o ponto de disparo automático de 100K a 1M tokens e qual a precedência dos quatro lugares de onde a configuração pode vir, a armadilha de só a variável de ambiente aceitar um inteiro simples, e o significado e os passos de recuperação das duas mensagens "Not enough messages to compact." e "Autocompact is thrashing: the context refilled to the limit...".