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 travou | O que deveria te avisar | O que realmente acontece |
|---|---|---|
| Antes dos cabeçalhos | um watchdog de primeiro byte | nenhum está armado, sobrou só o API_TIMEOUT_MS |
| No meio do stream | o watchdog de idle do stream | o stall ainda espera o mesmo backstop |
Depois de um api_error | retry imediato | o 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ável | O que controla | Valor padrão |
|---|---|---|
API_TIMEOUT_MS | quanto tempo o cliente espera por uma resposta | 600000 (10 minutos) |
CLAUDE_SLOW_FIRST_BYTE_MS | limiar em que um stall lento é registrado | 30000 (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.
- Aperte
Escpara interromper o turno travado. - 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.
- 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_MSpara 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
/compactantes de tarefas grandes, para o turno seguinte carregar menos contexto. - Abra sessões longas com
--debug-filee 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.
![[CC] travado e sem resposta por 15 minutos: como destravar](/_next/image?url=https%3A%2F%2Fstorage.googleapis.com%2Fverboo-landing-page%2Fblog-uploads%2F1783232445352-verboo-code-cover.png&w=3840&q=75)
