Compactação por ociosidade evita perder o cache de uma sessão parada

A v2.1.299 (14 de outubro) passou a compactar sozinha uma conversa com mais de 200 mil tokens que fica ociosa por cerca de 54 minutos, antes que o cache de prompt de uma hora expire. Configura o limiar com CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENS ou desliga com idleCompaction: false no settings.json; a v2.1.302 acrescentou uma linha própria para isso no /config.

O cache de prompt do Claude Code dura uma hora sem uso. Numa sessão longa que passa de 200 mil tokens e fica parada — por exemplo, enquanto você sai para o almoço no meio de uma tarefa — esse cache expirava sozinho, e o próximo turno pagava o preço cheio de reprocessar todo o contexto. A v2.1.299, de 14 de outubro, resolve isso de forma proativa: detecta a ociosidade antes da expiração do cache (por volta de 54 minutos parada) e compacta a conversa nesse momento, em vez de deixar o cache vencer sem aviso.

O limiar de 200 mil tokens é configurável via CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENS, e o recurso inteiro pode ser desligado com "idleCompaction": false no settings.json. A v2.1.302 (16 de outubro) acrescentou uma linha dedicada a isso no /config, para ligar ou desligar sem editar arquivo.

Por que importa

Para quem deixa uma sessão de terminal aberta entre uma tarefa e outra, o ganho é direto: menos chance de pagar reprocessamento caro de contexto por ter deixado o Claude Code parado passando de uma hora. Vale testar se o ponto de compactação (por volta dos 54 minutos) funciona bem com o seu fluxo, ou se compensa ajustar CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENS para um limiar mais alto em tarefa onde perder nuance do contexto intermediário importa mais do que economizar tokens de cache.