Claude Code travado ou congelado? O guia de resgate completo

Travado em «Compacting conversation…»

O auto-compact dispara quando a janela de contexto enche: o Claude Code resume a conversa até ali e a substitui. Numa sessão genuinamente enorme, essa passada de resumo pode levar minutos — e as versões v2.1.282 e v2.1.284 corrigiram falhas reais: a compactação quebrava quando o pedido de resumo era recusado, ou sobrava um erro «Prompt is too long» depois de compactar. Se uma sessão de tamanho normal rala por mais de dois ou três minutos, ela está travada, não trabalhando.

1. 1Se a sessão é legitimamente gigantesca, dê primeiro uns minutos — a v2.1.283 refez o spinner de compactação: o cronômetro dele só começa quando a compactação realmente começa.
2. 2Depois disso, aperte Esc e então Ctrl+C para cancelar a compactação. A documentação oficial confirma que o Ctrl+C cancela a operação em curso sem descartar sua sessão.
3. 3Compacte então à mão com um foco para o resumo largar as saídas volumosas de ferramentas, por exemplo: /compact keep only the plan and the diff.
4. 4Se o histórico antigo é descartável, rode /clear e comece limpo — e atualize para a v2.1.284 ou mais nova para ter as retentativas de compactação corrigidas.

/compact keep only the plan and the diff/clear

Travado em «Almost done thinking…»

Contra-intuitivo, mas esse rótulo do spinner não é relatório de progresso: os mantenedores confirmaram na issue #63387 que as frases rotativas não correspondem ao estado real de raciocínio do modelo. Por isso o «almost done» pode ficar na tela por muitos minutos, e a issue #55328 documenta turnos em que nem Esc nem Ctrl+C faziam nada enquanto o extended thinking se alongava.

1. 1Aperte Esc uma vez e espere alguns segundos; se o spinner continuar, aperte Ctrl+C.
2. 2Se a entrada seguir morta, feche a aba do terminal, abra outra e rode claude --resume no mesmo diretório para retomar a sessão.
3. 3Se todo turno longo trava do mesmo jeito, atualize o Claude Code e desconfie de um servidor MCP ou hook parado — por fora é idêntico a um pensamento travado, e o /mcp mostra qual servidor está agindo mal.

claude --resume

«Not responding — try stopping»

Esse banner laranja é o cão de guarda do Claude Code: uma chamada de ferramenta — normalmente um comando bash longo — ficou tempo suficiente em silêncio para a interface oferecer um botão de parada. É um aviso, não um veredito: nas demos do próprio Anthropic o processo seguiu trabalhando normalmente por baixo, e Boris Cherny, responsável pelo Claude Code, pediu publicamente gravações desse estado — a equipe está ciente e investigando.

1. 1Verifique se o comando por baixo ainda produz saída — um build compilando em silêncio não precisa de interrupção.
2. 2Se de verdade está empacado, aperte Esc ou o botão laranja de parada para interromper o turno.
3. 3Diga ao Claude que parou manualmente — depois de uma parada manual o modelo pode acreditar erradamente que a ferramenta foi recusada e sair pedindo desculpas em vez de continuar.
4. 4Rode a operação longa em segundo plano ou em pedaços menores para que o guarda de primeiro plano não dispare de novo.

claude --resume

Aresta conhecida: numa demo do próprio Anthropic com esse mesmo banner, o botão de parar apareceu com o comando ainda são — verifique antes de parar.

Travado em «Resuming container…» (sessões na nuvem)

As sessões web e móveis do Claude Code rodam num contêiner na nuvem. Reabrir uma sessão antiga significa subir esse contêiner de novo e transmitir a transcrição — honestamente lento com históricos grandes. A v2.1.286 corrigiu um bug em que sessões com históricos muito grandes chegavam a nunca acordar: o contêiner parou enquanto a transcrição ainda carregava.

1. 1Espere primeiro alguns minutos — a retomada a frio de um contêiner é mais lenta que uma sessão nova, e não há barra de progresso dizendo que algo se move.
2. 2Atualize a CLI para a v2.1.286 ou mais nova — claude update, ou npm install -g @anthropic-ai/claude-code — essa versão corrige o bug do «nunca acorda» com históricos de nuvem muito grandes.
3. 3Ainda congelada depois de atualizar? Recarregue a sessão web; se persistir, abra uma sessão nova e continue o trabalho por lá.

claude updatenpm install -g @anthropic-ai/claude-code

Solução da comunidade, resposta oficial pendente: vários usuários relatam o contêiner acordando em cerca de cinco minutos — só declare morte depois disso.

Congelando na inicialização

Travar antes do prompt é quase sempre local: um servidor MCP, plugin ou hook que quebra, um estado corrompido ou um problema da extensão. A v2.1.284 consertou as abas do VS Code que paravam de responder após Restart Extensions, e a v2.1.286 o spinner infinito «Teleporting session…» quando a extensão para de responder. Como o /doctor embutido precisa de uma sessão viva, começa-se pelo shell.

1. 1Rode claude doctor do seu terminal — é exatamente o que a documentação recomenda para o caso de não abrir; ele confere a instalação e propõe correções.
2. 2Abra com claude --safe-mode, que desativa para a sessão todos os plugins, servidores MCP e hooks — se abrir, o culpado é uma dessas personalizações.
3. 3Reative suas personalizações uma a uma — ou, já dentro, passe um /mcp — para achar o culpado, e depois atualize-o ou remova-o.
4. 4No VS Code, atualize também a extensão — os dois consertos 2.1.28x acima só existem nas versões atuais.

claude doctorclaude --safe-mode

Congelado no terminal

O congelamento clássico de janela inteira — entrada morta, spinner parado, Ctrl+C ignorado — tem um roteiro documentado. A sequência do guia oficial: tentar cancelar, reiniciar o terminal se precisar, retomar; de todo jeito nada se perde. Saída embaralhada ou pela metade no terminal integrado do editor é outro problema — a aceleração GPU — com conserto de um comando só.

1. 1Aperte Ctrl+C para tentar cancelar a operação em curso.
2. 2Se a janela seguir sem resposta, feche o terminal por completo e abra um novo.
3. 3No terminal novo, rode claude --resume no mesmo diretório do projeto — a documentação promete que a conversa não se perde.
4. 4Saída embaralhada no terminal integrado do VS Code? Rode /terminal-setup — ele desliga a aceleração GPU do terminal e limpa a distorção.

claude --resume/terminal-setup