O Claude Code trava, fica preso ou para de responder: como descobrir onde travou e sair dessa situação

Onde ele está preso? Examine a tela e, depois, o processo

# in the session
Esc            # cancel the current tool or turn
Ctrl+C (twice) # abort the turn / exit
# from another terminal
ps aux | grep -E "claude|node" | grep -v grep     # child processes still running?
top -o cpu       # is claude spinning or idle?
claude --debug   # next time: timestamps for every request and tool call
claude -c        # resume the last session after a kill

CPU ociosa com um prompt congelado significa que ele está aguardando algo externo: um fluxo de rede, um servidor MCP, um processo filho ou uma solicitação que você não consegue ver. CPU no máximo significa que ele está trabalhando em algo interno: analisando um resultado enorme de ferramenta, fazendo retrocesso em uma expressão regular ou carregando uma sessão grande. Memória aumentando continuamente significa que um resultado de ferramenta ou arquivo de sessão está sendo carregado por inteiro.

Causas conhecidas no rastreador de problemas

• `/rewind` trava, `Ctrl+C` é ignorado, `kill -9` é necessário (#53011, 21 reações, em sessões de qualquer tamanho nas versões 2.1.1xx). Um engenheiro da Anthropic não conseguiu reproduzir o problema na 2.1.233, então atualize primeiro; em uma versão antiga, encerre o processo e retome com claude -c em vez de retroceder.
• As sessões de Remote Control congelam durante a execução e apenas um `Esc` local as reativa (#51267, aberto). Qualquer ferramenta ou subprocesso que bloqueie congela toda a sessão remota, sem possibilidade de cancelamento remoto; mantenha essas sessões curtas e evite ferramentas que possam solicitar uma entrada.
• A solicitação de autenticação do MCP trava em `Enter` (#42707, aberto). Autentique o servidor por meio de um comando claude mcp separado ou pelo navegador e reinicie a sessão.
• `grep` com o mecanismo de correspondência integrado consome toda a memória (#54394): nas versões nativas, cada comando de shell grep é executado dentro de um claude processo com seu próprio heap V8; uma expressão regular com retrocesso aplicada a uma linha longa e minificada cresce até consumir gigabytes, e o OOM killer encerra a sessão junto com o processo, tanto no WSL2 quanto no Linux. Evite expressões regulares sem limites em arquivos minificados, exclua os arquivos gerados pela compilação e node_modules, ou instale a versão do sistema de ripgrep e invoque-a explicitamente.
• Loop de novas tentativas travado em `400 thinking blocks cannot be modified` (#63231) — o histórico da conversa é inválido e todas as novas tentativas falham da mesma forma. /rewind até antes do turno, ou /clear; consulte o guia de 400.
• **Execuções na nuvem / agendadas travadas em *Configurando um contêiner na nuvem*** (#53691, #54528) — problema no serviço; nenhuma ação local resolve, cancele e consulte status.claude.com.
• Retomar uma sessão grande leva minutos — o histórico é reproduzido na inicialização. Retome a sessão específica de que você precisa (claude -r) em vez da maior, e deixe a compactação reduzir as sessões gigantes.

Travamentos na inicialização

Uma tela em branco logo após claude sem nenhum prompt geralmente indica que a primeira chamada à API não está retornando: uma variável de proxy apontando para um proxy inativo, uma VPN, DNS ou um ANTHROPIC_BASE_URLinacessível. Execute a verificação com curl do guia de erros de conexão, depois claude doctor. Inicializações lentas em que o prompt acaba aparecendo indicam que servidores MCP estão sendo iniciados; claude mcp list e remova os que excedem o tempo limite.

Processos filhos que nunca terminam

Uma ferramenta de shell que abre um editor, aguarda uma senha, acompanha um log ou inicia um servidor de desenvolvimento nunca retorna, e o turno fica esperando por ela. Diga ao agente para executar servidores em segundo plano e adicionar --no-pager, -y ou < /dev/null quando um comando puder solicitar uma entrada. Se isso já aconteceu, Esc cancela a ferramenta; se o processo filho ignorar o cancelamento, encerre-o pelo PID em outro terminal, e o turno continuará com o erro.

Alto uso de memória e CPU

• Os resultados das ferramentas são mantidos na memória e em disco durante a sessão; ler um arquivo de 200 MB resulta em uma sessão de 200 MB. Leia apenas as partes de que precisa.
• Muitos subagentes em paralelo multiplicam tudo; CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY=2 em máquinas com poucos recursos.
• Emuladores de terminal com renderização lenta (alguns consoles do Windows, tmux remoto em uma conexão de baixa largura de banda) fazem a saída em streaming parecer congelada; claude --debug mostra se os tokens ainda estão chegando.
• Se o uso de memória aumentar enquanto estiver ocioso, procure processos claude remanescentes de sessões do IDE que falharam e encerre-os (o processo terminou com o código 1 aborda o caso de processos órfãos no Windows).

Quando o problema é a API, e não o cliente

Uma sessão que trava em todos os turnos no mesmo ponto, com um pequeno indicador de carregamento e, depois de algum tempo, uma linha de nova tentativa, indica um caminho até a API lento ou com interrupções, em vez de um bug no cliente: 529 sobrecarregado, limitação de requisições no servidor ou uma conexão reiniciada. Por meio de um gateway (ANTHROPIC_BASE_URL=https://aiprimetech.io), uma conta saturada no provedor é substituída por outra, o que reduz exatamente essas esperas.

export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_key

Perguntas frequentes

A AI Prime Tech é um gateway de API independente e não é afiliada, endossada nem patrocinada pela Anthropic. “Claude” e “Claude Code” são marcas comerciais da Anthropic. Os recursos do Claude Code descritos aqui seguem a documentação pública da Anthropic no momento da redação e mudam com frequência; os preços e as listas de modelos nesta página são obtidos das configurações atuais deste gateway.