Source: https://aiprimetech.io/pt/claude-code/errors/claude-code-hangs/

[Início](/pt/) › [Claude Code](/pt/claude-code/) › [Erros](/pt/claude-code/errors/) › Travamentos / bloqueios

[Visão geral](/pt/claude-code/)[Instalação](/pt/claude-code/install/)[referência da CLI](/pt/claude-code/cli/)[Preços e limites](/pt/claude-code/pricing/)[Agent SDK](/pt/claude-code/sdk/)[Skills e plugins](/pt/claude-code/skills/)[GitHub](/pt/claude-code/github/)[Web, desktop e IDE](/pt/claude-code/web-and-desktop/)[Modelos](/pt/claude-code/models/)[Erros](/pt/claude-code/errors/)[Código aberto?](/pt/claude-code/open-source/)[Tutorial](/pt/claude-code/tutorial/)[Para estudantes](/pt/claude-code/for-students/)[Automação de QA](/pt/claude-code/qa-automation/)[vs Cursor](/pt/claude-code/vs-cursor/)[vs Codex e OpenCode](/pt/claude-code/vs-codex/)[Subagentes](/pt/claude-code/subagents/)[Hooks](/pt/claude-code/hooks/)[MCP](/pt/claude-code/mcp/)[Ecossistema](/pt/claude-code/ecosystem/)[VS Code](/pt/claude-code/vscode/)[OpenRouter](/pt/claude-code/openrouter/)[Limites de requisições](/pt/claude-code/rate-limits/)[Guia em chinês](/claude-code/zh/)

Última atualização: 11 de outubro de 2026

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

Um travamento tem uma localização: o Claude Code está aguardando a API, uma ferramenta que iniciou, um servidor MCP, seu terminal ou a si próprio. A saída é diferente em cada caso, e a linha de status geralmente indica qual deles é antes de você recorrer ao kill.

## TLDR
- Aguardando a API → um indicador de carregamento com uma contagem de tokens ou uma linha *Aguardando resposta da API*; um [problema de conexão](/pt/claude-code/errors/connection-lost/), não um travamento.
- Aguardando uma ferramenta → a linha da ferramenta permanece aberta; Esc a cancela. Um comando de shell aguardando entrada ou um processo descontrolado de grep é a causa mais comum.
- Aguardando você → uma solicitação de aprovação ou uma pergunta oculta fora da área visível; pressione Enter ou role a tela.
- Realmente travado (sem saída, sem reação a Esc, Ctrl+C) → encerre o processo e retome com claude -c; verifique os bugs conhecidos abaixo.

## 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](https://github.com/anthropics/claude-code/issues/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](https://github.com/anthropics/claude-code/issues/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](https://github.com/anthropics/claude-code/issues/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](https://github.com/anthropics/claude-code/issues/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](https://github.com/anthropics/claude-code/issues/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](/pt/claude-code/errors/api-error-400/).
- **Execuções na nuvem / agendadas travadas em *Configurando um contêiner na nuvem*** ([#53691](https://github.com/anthropics/claude-code/issues/53691), [#54528](https://github.com/anthropics/claude-code/issues/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](/pt/claude-code/errors/connection-lost/), 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](/pt/claude-code/errors/process-exited-code-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](/pt/claude-code/errors/overloaded-529/), [limitação de requisições no servidor](/pt/claude-code/errors/usage-limit-reached/) 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.

## Cansado de lidar com esse problema?

Execute o Claude Code pelo gateway da AI Prime Tech: os mesmos modelos Claude nas contas upstream do próprio gateway, duas variáveis de ambiente para fazer a mudança, e novas contas recebem $5 em crédito gratuito para a API com o código FIXIT — sem cartão.

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

[Crie uma conta com o código FIXIT](/register?promo=FIXIT)

## Perguntas frequentes

Por que o Claude Code está travado e não responde?

Ele está esperando por algo: um fluxo da API, uma ferramenta que iniciou, um servidor MCP ou uma solicitação de aprovação fora da área visível. Pressione Esc para cancelar a ferramenta, Ctrl+C duas vezes para interromper; se nada reagir, encerre o processo e retome com claude -c.Como corrigir o travamento do Claude Code em /rewind?

Atualize para uma versão atual; o travamento foi relatado na 2.1.1xx e a Anthropic não conseguiu reproduzi-lo na 2.1.233. Em uma versão antiga, encerre o processo e use claude -c em vez de /rewind.Por que o Claude Code usa tanta memória?

Resultados grandes de ferramentas e históricos de sessão são mantidos integralmente, os subagentes os multiplicam e, nas versões nativas, uma expressão regular do grep com retrocesso é executada dentro de um processo claude com um heap V8 grande. Leia menos, exclua os arquivos gerados pela compilação e reduza a concorrência.O Claude Code trava na inicialização sem mostrar um prompt. O que devo verificar?

A primeira requisição à API não está retornando: variáveis de proxy, VPN, DNS ou um ANTHROPIC_BASE_URL inacessível. Execute um curl para o endpoint, depois claude doctor, e remova os servidores MCP que excedem o tempo limite.

## Execute o Claude Code no gateway

Os mesmos modelos, duas variáveis de ambiente, créditos com 7.69231× o valor nominal — ou um plano ilimitado com preço fixo. Novas contas: $5 em crédito gratuito para a API com o código FIXIT.[Obter uma chave de API](/register?promo=FIXIT) [Ver planos ilimitados](/pt/plans/)

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.

## Mais guias do Claude Code

[Erros do Claude Code e como corrigi-los](/pt/claude-code/errors/)["Erro de API: 500" no Claude Code: o que significa e o que realmente resolve](/pt/claude-code/errors/api-error-500/)[Erro "Sobrecarregado" no Claude (erro 529 de API): o que significa e o que fazer](/pt/claude-code/errors/overloaded-529/)[Erro 400 da API do Claude Code: prompt longo demais, concorrência no uso de ferramentas e os demais](/pt/claude-code/errors/api-error-400/)[Erros de OAuth no Claude Code: tempo limite de 15000ms excedido e código de status 500](/pt/claude-code/errors/oauth-error/)["O processo do Claude Code foi encerrado com o código 1": como encontrar o erro real e corrigi-lo](/pt/claude-code/errors/process-exited-code-1/)["O prompt é longo demais", "A entrada é longa demais para o modelo solicitado" e "Limite de contexto atingido" no Claude: o que preenche a janela e como liberar espaço](/pt/claude-code/errors/prompt-too-long/)[Limite de uso do Claude atingido: limites de sessão, semanais e do Opus, "limites especificados de uso da API", "o saldo de créditos é insuficiente" — e o que fazer](/pt/claude-code/errors/usage-limit-reached/)[Erros 401 e 403 no Claude Code: credenciais de autenticação inválidas, chave de API inválida, "Você não está conectado", host_not_allowed](/pt/claude-code/errors/auth-401-403/)[Erros de conexão no Claude Code: ECONNRESET, conexão perdida durante a resposta, "Aguardando resposta da API", "Não foi possível conectar à API", erros de certificado SSL](/pt/claude-code/errors/connection-lost/)[Claude.ai não funciona: "Algo deu errado", restrições de capacidade, "limite de 5 horas atingido", "erro ao fazer login" e os demais](/pt/claude-code/errors/claude-ai-not-working/)