Claude Code: Resposta interrompida no meio do fluxo

As duas mensagens significam que a resposta transmitida pelo modelo parou antes de ser concluída. “A resposta acima pode estar incompleta” é exibida quando parte da resposta chega e depois o fluxo fica parado, cai ou é interrompido; o Claude Code mantém o que chegou, e responder continue retoma o turno. “A resposta em fluxo terminou antes que quaisquer dados completos fossem recebidos” significa que nada utilizável chegou, então o Claude Code repete a mesma solicitação sem streaming — e, quando isso continua acontecendo, a causa geralmente é um proxy ou gateway entre o Claude Code e o provedor do modelo, como a própria mensagem informa.

O erro

printed by Claude Code

API Error: Response stalled mid-stream. The response above may be incomplete.

# the wording in Claude Code's current error reference for the same stall:
API Error: The response stopped arriving. The response above may be incomplete.

# when nothing complete arrived at all:
Streaming response ended before any complete data was received. Retrying without
streaming. If this keeps happening, check any proxy or gateway between Claude Code
and your model provider.

Causas e soluções em resumo

Causa	Solução
A conexão permaneceu aberta, mas parou de entregar dados, e o watchdog de inatividade do streaming do Claude Code a abortou	Responda continue. Se pausas longas forem legítimas na sua conexão, aumente CLAUDE_STREAM_IDLE_TIMEOUT_MS em vez de desativar o watchdog.
A conexão caiu, o computador entrou em suspensão ou o servidor retornou um erro no meio da resposta	Responda continue; a parte concluída da resposta é mantida. Verifique a VPN, as trocas de rede Wi-Fi e as configurações de suspensão se isso se repetir.
Um proxy ou gateway intermediário armazenou em buffer, truncou ou rejeitou o fluxo — por exemplo, uma solicitação cujo corpo excedeu o limite de tamanho	Teste uma vez sem ele. Aumente o limite de tamanho do corpo e o tempo limite de leitura do proxy, e desative o buffering de respostas para a rota da API.
Começou logo após uma atualização do Claude Code	Anote a versão em /status. Um relatório de julho de 2026 mediu a mensagem travada em 0% na versão 2.1.210 e em 3,0–4,4% nas versões 2.1.217–2.1.218 na mesma máquina.

Responda continue primeiro

O Claude Code mantém o texto e as chamadas de ferramentas concluídos antes da falha e acrescenta o aviso. Em uma sessão interativa, leia o que chegou e responda continue: o turno continua a partir dali. Em uma execução não interativa (claude -p), o Claude Code imprime o último bloco de texto concluído seguido do aviso; retome essa sessão e envie continue. Se isso acontecer uma vez, nada mais precisa ser alterado.

Diferencie as mensagens

A referência de erros do Claude Code lista as formulações de respostas incompletas por causa: erro do servidor no meio da resposta, conexão perdida no meio da resposta, o computador entrou em suspensão no meio da resposta, a resposta parou de chegar (o travamento), parte da resposta nunca chegou e o fluxo da resposta estava malformado. Relatórios de julho de 2026 citam uma formulação mais antiga para o travamento: “Response stalled mid-stream”. A mensagem separada “Streaming response ended before any complete data was received” corresponde ao caso em que nenhum dado completo chegou, por isso o Claude Code tenta novamente sem streaming em vez de manter uma resposta parcial.

Ajuste o watchdog, não o desative

O Claude Code executa quatro temporizadores que interrompem um fluxo quando ele deixa de receber dados, para que uma conexão inativa falhe e seja tentada novamente em vez de ficar travada: um prazo limite para o primeiro byte, um monitor de atividade no nível de eventos (300 segundos), um monitor de atividade no nível de bytes (180 segundos na API direta da Anthropic, 300 segundos nos demais casos, inclusive com um ANTHROPIC_BASE_URL personalizado) e, em alguns provedores, um tempo limite de inatividade de cinco minutos para o corpo da resposta. CLAUDE_STREAM_IDLE_TIMEOUT_MS define os dois monitores de atividade; valores inferiores a cinco minutos são aumentados para cinco minutos, e o monitor no nível de bytes é limitado a 30 minutos. Defina essa variável no bloco env de settings.json para que os agentes em segundo plano também a recebam:

~/.claude/settings.json

{
  "env": {
    "CLAUDE_STREAM_IDLE_TIMEOUT_MS": "600000"
  }
}

Atrás de um proxy ou gateway, teste sem ele

Quando a mensagem de nova tentativa sem streaming se repetir, remova esse salto uma vez: desconfigure HTTPS_PROXY para uma única sessão ou defina NO_PROXY="*" e execute a mesma tarefa. Se parar, o salto é a causa. Os culpados habituais são um limite de tamanho do corpo da requisição que sessões longas ultrapassam, buffering de respostas que transforma um fluxo ativo em um longo silêncio e um tempo limite de leitura menor que as pausas de raciocínio do modelo. Observe que o prazo para o primeiro byte não é executado quando ANTHROPIC_BASE_URL aponta para um gateway, mas o watchdog em nível de byte é.

Se você estiver chamando pela Kunavo

O Kunavo é um dos gateways aos quais essa mensagem se refere, então é isso que ele faz em /v1/messages, o endpoint chamado pelo Claude Code. O fluxo upstream é retido até produzir seu primeiro evento de conteúdo; um erro upstream ou um fluxo vazio antes desse ponto faz a tentativa falhar, e ela é repetida em outro canal quando o modelo dispõe de um, ou retornada como erro HTTP — nunca como um fluxo 200 que termina sem conteúdo. Um travamento após o início do conteúdo não é algo que um gateway possa repetir, e o watchdog e o continue do Claude Code são as ferramentas corretas para isso. Como os fluxos terminam no lado compatível com OpenAI e como distinguir uma resposta completa de uma cortada está em Erros de streaming de APIs de LLM.

Perguntas frequentes

O que significa “The response above may be incomplete” no Claude Code?

A resposta transmitida parou depois que parte dela chegou — por um travamento, uma conexão perdida, um erro do servidor ou o computador entrar em suspensão. O Claude Code mantém o texto e as chamadas de ferramentas concluídos e acrescenta o aviso. Responda continue e o turno continuará a partir do que chegou.

“Response stalled mid-stream” é o mesmo que “The response stopped arriving”?

Eles descrevem o mesmo caso: a conexão permaneceu aberta, mas parou de entregar dados até que um watchdog de streaming a abortasse. A referência atual de erros do Claude Code usa “The response stopped arriving”; relatórios registrados em julho de 2026 citam “Response stalled mid-stream”.

Por que o Claude Code diz “Retrying without streaming”?

Porque o fluxo terminou antes que qualquer dado completo fosse recebido, então não havia nada a preservar. O Claude Code envia a mesma solicitação novamente sem streaming. Se a mensagem continuar aparecendo, verifique o proxy ou gateway entre o Claude Code e o provedor — limites de tamanho do corpo, buffering e tempos limite de leitura são as causas habituais.

Devo desativar o watchdog de streaming?

Não. Os watchdogs existem para que uma conexão inativa falhe e seja repetida em vez de manter a sessão travada indefinidamente. Se sua conexão realmente ficar silenciosa por longos períodos, aumente CLAUDE_STREAM_IDLE_TIMEOUT_MS (valores inferiores a cinco minutos são elevados para cinco minutos) em vez de definir CLAUDE_ENABLE_STREAM_WATCHDOG ou CLAUDE_ENABLE_BYTE_WATCHDOG como 0.

Usar um gateway com ANTHROPIC_BASE_URL torna isso mais provável?

Cada salto entre o Claude Code e o provedor é mais um lugar onde um fluxo pode ser armazenado em buffer, interrompido ou atingir o tempo limite; portanto, teste sem ele quando as mensagens se repetirem. O watchdog em nível de byte também é executado em conexões de gateway; o prazo para o primeiro byte não é executado quando ANTHROPIC_BASE_URL roteia por um gateway.

Guias relacionados

Mais detalhes sobre o significado dos erros estão em referência de erros; obter uma chave leva um minuto por meio de cadastro e da guia de autenticação.