[CC] travado e sem resposta por 15 minutos: como destravar
Voltar para o Blog
Artigotroubleshootingclaude codedev toolsprodutividadeanthropic

[CC] travado e sem resposta por 15 minutos: como destravar

Mafra18 de novembro de 20264 min de leitura

O spinner continua girando, o contador de tokens não sobe e nenhuma mensagem de erro aparece. Passam cinco minutos, quinze, às vezes mais de vinte. Você aperta Esc, manda a mesma coisa de novo e a resposta chega em segundos.

Esse é o sintoma da issue #26224 do repositório oficial do CLI, aberta em fevereiro de 2026 e ainda ativa em novembro, com relatos de travamentos de 5 a 20 minutos em prompts seguidos. Não é o modelo pensando, não é a sua conta e não é o seu prompt: é uma conexão que morreu sem avisar e nenhum watchdog percebeu.

O que está acontecendo quando o CLI trava sem erro?

A conexão morreu em silêncio. Sem FIN, sem RST, sem resposta HTTP de erro. O processo continua esperando bytes que nunca vão chegar, e o único relógio que pode interromper essa espera é o API_TIMEOUT_MS, que vale 600 segundos por padrão no cliente.

Esse número não é boato de fórum. Ele está no código do cliente que roda no seu terminal, no intervalo entre o pedido e a desistência: timeout: parseInt(process.env.API_TIMEOUT_MS || String(600 * 1000), 10). Se a conexão morre antes de os cabeçalhos chegarem, nada dispara antes disso.

Onde travouO que deveria te avisarO que realmente acontece
Antes dos cabeçalhosum watchdog de primeiro bytenenhum está armado, sobrou só o API_TIMEOUT_MS
No meio do streamo watchdog de idle do streamo stall ainda espera o mesmo backstop
Depois de um api_errorretry imediatoo retry acontece, mas só depois do tempo esgotado

Aumentei CLAUDE_SLOW_FIRST_BYTE_MS e nada mudou. Por quê?

Porque essa variável não aborta nada. Segundo o relato consolidado na issue #88178 do mesmo repositório, CLAUDE_SLOW_FIRST_BYTE_MS vale 30 segundos e serve apenas para registrar no log e emitir telemetria. Ela não corta a requisição, não dispara retry e não avisa o usuário.

É a diferença entre um alarme que toca e um alarme que só grava num arquivo. Quem vê a variável no log e sobe o valor continua olhando para o mesmo spinner.

VariávelO que controlaValor padrão
API_TIMEOUT_MSquanto tempo o cliente espera por uma resposta600000 (10 minutos)
CLAUDE_SLOW_FIRST_BYTE_MSlimiar em que um stall lento é registrado30000 (30 segundos), sem abortar

Por que trava 15 minutos e não 10?

Porque no app desktop o valor injetado é maior. O autor da #88178 mediu com ps eww na cadeia de processos: o aplicativo inicia o CLI com API_TIMEOUT_MS=900000 no ambiente, e variável de ambiente de processo tem precedência sobre o bloco env do arquivo de settings.

Novecentos segundos são exatamente 15 minutos, e os stalls medidos no relato batem nesse número: 900s, 939s e 753s, todos terminando em api_error Request timed out, todos seguidos de um retry que respondeu em segundos. Some dois stalls na mesma sessão e você tem os 20 minutos do título da #26224.

Consequência prática: se você usa o app desktop e colocou API_TIMEOUT_MS no settings, o ajuste pode estar sendo ignorado. Confira com ps eww no processo do CLI antes de culpar a configuração.

Como sair do travamento em segundos?

A saída manual é a mesma nos dois relatos e é a mais rápida: interromper e reenviar. O que se perde é o turno que estava sendo gerado, não a sessão.

  1. Aperte Esc para interromper o turno travado.
  2. Reenvie a mesma instrução, ou mande qualquer mensagem curta que force uma nova requisição. Na #26224, um follow-up simples costuma destravar o prompt pendente.
  3. Se voltar a travar no mesmo ponto, o problema está no caminho da rede ou no provedor, não no seu prompt. Aí vale trocar de rota em vez de insistir.

O passo 3 é o mais importante. Um travamento que volta sempre no mesmo trecho, com o relógio batendo perto de um número redondo, é sinal de conexão morta, e reenviar não vai consertar a causa.

Como reduzir a chance de travar de novo?

  • Baixe o API_TIMEOUT_MS para algo entre 90 e 120 segundos no ambiente do CLI. Você troca uma espera longa por um erro rápido que já vem com retry.
  • Divida turnos longos. Quanto mais tempo a conexão precisa ficar aberta, maior a exposição a um stall silencioso.
  • Rode /compact antes de tarefas grandes, para o turno seguinte carregar menos contexto.
  • Abra sessões longas com --debug-file e procure a linha do stall. Sem o log, o sintoma fica invisível.
  • Mantenha um segundo caminho configurado. Quando a primeira rota trava e você descobre isso aos 15 minutos, ter para onde ir muda o dia.

A Verboo Code existe justamente para ser esse segundo caminho: mesmo fluxo de terminal, comando e MCP, com tokens ilimitados por assinatura. Se a conexão do seu provider travar, você troca de motor com /model sem trocar de ferramenta nem perder a sessão.

Gostou deste artigo?
Compartilhe conhecimento com sua rede.
// Leia também

Artigos relacionados