Claude Code Auto Compact: /autocompact, limite e soluções
O que o auto compact faz quando sua janela de contexto enche, como funciona a janela do /autocompact (agora salva por modelo), quando compactar ou limpar, e o que fazer quando o “Compacting conversation…” fica lento.
Resumão
- O auto compact resume o histórico antigo quando a conversa se aproxima do limite de contexto. Desde a v2.1.288, o modo auto compacta conversas longas em vez de falhar a cada chamada de ferramenta.
- /autocompact 500k define a janela de disparo (100K–1M tokens) e — desde a v2.1.288 — é salva por modelo. /autocompact auto volta ao padrão ajustado do seu modelo.
- O /context mostra o que está gastando espaço e o Autocompact buffer reservado. Compacte se está continuando a mesma feature; /clear se vai começar algo novo.
- Compactar lê a conversa inteira, então sessão longa demora. Se travar, atualize o Claude Code primeiro — a 2.1.288 corrigiu conversas que morriam com “Prompt is too long” em vez de compactar.
Context Management in Claude Code
Canal: Anthropic · Claude3:31
Claude Code release notes — v2.1.288
Notas de versão: github.com/anthropics/claude-code
Set the auto-compact window — official documentation
Documentação: code.claude.com/docs
Os fatos desta página foram cruzados com a documentação oficial do Claude Code e o changelog da v2.1.288; as capturas vêm do vídeo acima. O comportamento descrito corresponde ao Claude Code v2.1.288 (setembro de 2026).
As capturas são frames do vídeo “Context Management in Claude Code” da Anthropic, usados com atribuição e com link para o minuto exato do original em cada passo.
Auto compact, passo a passo
Entender o que enche seu contexto
- 1
Listar o que está carregado no contexto
Rode o /context e desça pelo detalhamento. Ferramentas MCP carregam sob demanda, mas as definições, agentes customizados e skills reservam tokens antes de você mandar o primeiro prompt. Desligar os servidores MCP que o projeto não usa é o espaço mais barato que você vai liberar na vida.
O detalhamento do /context mostra ferramentas MCP, agentes customizados e skills com o custo em tokens antes de qualquer trabalho começar.Ver em 0:10 - 2
Ler o espaço livre e o buffer de autocompact
O topo do /context mostra a janela do modelo e quanto você já gastou — claude-opus-4-6 com 21k/200k tokens (11%) nesta demo. A última linha, Autocompact buffer, é a folga que o Claude Code reserva para o auto compact rodar antes de a janela encher de verdade.
A linha Autocompact buffer do /context é o espaço reservado para a compactação — aqui, 33k tokens (16,5%).Ver em 2:38 - 3
Reconhecer uma sessão que está enchendo
Sessões longas crescem por resultado de ferramenta: cada leitura de arquivo, cada achado do code review e cada correção empurra mensagens para a janela. A sessão da demo rodou um code review, listou achados como validação de entrada ausente e um secret JWT hardcoded e pediu para corrigir — exatamente o tipo de trabalho que termina esbarrando no limite.
Um code review com achados e correções é trabalho típico de sessão longa, empurrando a janela de contexto rumo ao limite.Ver em 0:24 - 4
Deixe o recap mostrar o que sobrevive
Quando a conversa fica longa, o próprio resumo do Claude Code — ranking de prioridades, todas as mensagens do usuário, tarefas pendentes — mostra o que um summary precisa preservar. O auto compact pensa igual: suas solicitações e trechos-chave de código sobrevivem; os resultados antigos de ferramenta são os primeiros a sair.
Ranking de prioridades, mensagens do usuário e tarefas pendentes: o estado que um resumo compactado precisa carregar.Ver em 0:50
Compactar de propósito
- 5
Escolher o /compact no menu de comandos
Digite / e leia as descrições: /clear “Clear conversation history and free up context”, /compact “Clear conversation history but keep a summary in context”. Uma linha resume tudo — compact troca um resumo por continuidade, clear compra o máximo de espaço. O /compact ainda aceita uma instrução de foco, tipo /compact Focus on the API changes.
O menu de comandos entrega a diferença: /compact mantém um resumo no contexto, /clear libera tudo.Ver em 0:09 - 6
Entender o spinner de Compacting conversation
Ao rodar o /compact aparece “Compacting conversation…” enquanto o modelo lê e resume tudo o que veio até agora. O auto compact dispara a mesma rotina sozinho perto do limite — e a v2.1.288 fez o modo auto compactar conversas longas em vez de falhar chamada por chamada, então a tarefa não fica mais travada no meio.
Compacting conversation… é o spinner que você vê, seja a compactação manual ou automática.Ver em 0:46 - 7
Ler o resumo do compact
A saída começa com “This session is being continued from a previous conversation that ran out of context” e carrega Primary Request and Intent, Key Technical Concepts e Files and Code Sections para a nova janela. Você segue trabalhando com o resumo no lugar do histórico completo.
Um resumo compactado abre admitindo que a sessão ficou sem contexto e lista o que foi preservado.Ver em 0:48 - 8
Recuperar detalhes pela transcrição completa
Se o resumo deixar cair algo de que você precisa, as notas da compactação dizem onde procurar: “read the full transcript at” um caminho .jsonl, além das seções Current Work e Optional Next Step. O aviso da documentação segue de pé — instruções detalhadas do começo da conversa podem se perder, então regras duradouras vão para o CLAUDE.md.
Current Work, Optional Next Step e o caminho da transcrição são seus pontos de recuperação depois da compactação.Ver em 0:52
Limpar, delegar, recuperar
- 9
Usar /clear quando a tarefa acaba
Vai começar uma feature nova? O /clear apaga a conversa na hora — a documentação destaca que não custa nada, enquanto compactar um contexto grande é, ele mesmo, uma requisição grande. Rode /rename antes para a sessão encerrada continuar achável pelo /resume, e deixe no CLAUDE.md o que as próximas sessões precisam saber.
/clear recomeça do zero, sem resumo — renomeie a sessão antes para o /resume ainda a encontrar.Ver em 3:14 - 10
Delegar leituras pesadas a um subagente
Subagentes rodam na própria janela de contexto e devolvem só um resumo para a sessão principal. Disparar o subagente code-reviewer, como na demo, mantém a saída do review inteira fora da sua janela — a resposta da documentação para perguntas do tipo “onde fica X?”, que precisam da resposta, não do caminho.
Disparar um subagente code-reviewer: o trabalho acontece fora da sua janela de contexto principal.Ver em 2:50 - 11
Deixe o subagente trabalhar, fique com a resposta
Enquanto o subagente resume refactors e atualiza tarefas, sua janela principal recebe só o resultado. Menos saída de ferramenta no fio principal significa que o auto compact demora mais para disparar — ou nunca dispara. É o jeito mais barato de um projeto longo nunca encostar no buffer.
O subagente reporta o refactor resumido — a sessão principal nunca guardou a saída intermediária.Ver em 2:53
Auto compact vs /compact vs /clear vs /rewind
Quatro comandos ocupam o mesmo canto do Claude Code — todos reiniciam ou remodelam a conversa — mas respondem a perguntas diferentes. Aqui vai quando cada um é a resposta certa.
- 1Auto compact (automático) dispara quando a conversa atinge o limite de contexto — ou a janela do /autocompact que você definiu. Ele resume o histórico antigo para a sessão simplesmente seguir; desde a v2.1.288, até o modo auto compacta em vez de falhar chamadas em conversas muito longas.
- 2/compact (manual, mantém resumo) roda a mesma sumarização sob demanda — “Clear conversation history but keep a summary in context”, como diz o menu. Use quando passou do limite mas segue na mesma feature; com foco, tipo /compact Focus on the test output.
- 3/clear (começar do zero) apaga tudo sem resumo e não custa nada — compactar um contexto grande é, ele mesmo, uma requisição grande. Use quando o plano acabou e o próximo trabalho não tem relação. /rename antes, para o /resume poder trazer a sessão antiga de volta.
- 4/rewind (desfazer) é outra categoria: dois Esc abrem o menu de rewind para restaurar código e conversa de um checkpoint anterior. Use quando quiser desfazer mudanças recentes, não quando quiser continuar trabalhando além do limite de contexto.
- 5A regra de bolso do próprio passo a passo da Anthropic: compacte quando estourar a janela mas precisar de continuidade na mesma feature; limpe quando for começar algo novo; e o que as próximas sessões precisam lembrar vai no CLAUDE.md, que sobrevive aos dois.
Mais uma distinção que vale saber: a compactação é lossy por design. Suas solicitações e trechos-chave de código são preservados, mas instruções detalhadas do começo da conversa podem se perder — esse é o preço do espaço liberado, e o motivo de regras duradouras morarem no CLAUDE.md em vez do histórico do chat.
Compacting conversation lento ou travado? Primeiros socorros
A compactação lê a conversa inteira, então uma sessão grande leva um tempo visível para ser resumida — isso sozinho não é bug. Aqui vão os casos em que algo realmente está errado, e o que fazer.
- 1“Prompt is too long” em vez de compactar — atualize o Claude Code primeiro. A v2.1.288 corrigiu conversas longas que falhavam com esse erro em vez de compactar quando a última resposta reportava zero token. Versões antigas param exatamente aí.
- 2A compactação termina e o contexto reenche na hora (thrashing). Uma leitura de arquivo ou saída de ferramenta gigante pode reencher a janela logo após cada resumo; o Claude Code para de compactar sozinho após algumas tentativas e mostra erro em vez de entrar em loop. /clear, divida a tarefa ou mande a leitura pesada para um subagente.
- 3Um gateway ou proxy recusa requisições grandes. Se seu endpoint rejeita qualquer coisa acima de 200K tokens, defina CLAUDE_CODE_AUTO_COMPACT_WINDOW=200000 para a compactação disparar antes, em vez de deixar as sessões crescerem além do que o gateway aceita.
- 4O /autocompact diz que salvou mas não aplica. Algum escopo de prioridade maior — managed settings, por exemplo — está sobrescrevendo; o próprio comando avisa quando isso acontece. A variável CLAUDE_CODE_AUTO_COMPACT_WINDOW ganha de tudo, inclusive do /autocompact.
- 5É que realmente é lento. Resumir uma janela quase cheia é uma requisição grande; dê um minuto antes de rodar o /compact de novo — e se você não precisa do resumo, o /clear é instantâneo e grátis. Deixar os servidores MCP irrelevantes desligados encurta também toda compactação futura.
Se a compactação segue falhando na mesma sessão, a rota de fuga é manual: /rename na sessão, /clear e /resume depois — ou continue do resumo compact que a última passada produziu. Nada em disco se perde; a compactação só reorganiza a memória da conversa.