API Error: The response stopped arriving — qué significa y cómo solucionarlo cuando los datos de la respuesta de Claude Code se detienen a mitad

«API Error: The response stopped arriving» indica que, en mitad de una respuesta en streaming, los datos dejaron de llegar aunque la conexión seguía abierta, y que el propio temporizador de vigilancia de Claude Code cortó esa conexión. Todo lo que se completó antes de ese momento sigue en pantalla. En una sesión interactiva, responde continue y Claude seguirá desde el último punto completado.

API Error: The response stopped arriving. The response above may be incomplete.

Antes de la v2.1.227, este mensaje decía Response stalled mid-stream. La referencia oficial de errores deja constancia del cambio de nombre, y lo que ocurre es lo mismo. Si buscas información o informes de errores redactados con el texto antiguo, busca con las dos cadenas.

1. Qué significa el mensaje: silencio, no desconexión

La referencia oficial de errores de Claude Code explica este mensaje así: la conexión siguió abierta pero dejó de entregar datos, de modo que el vigilante de inactividad del streaming (idle watchdog) la cortó. No es el cuerpo de un error devuelto por la API, sino una nota que añade el propio Claude Code mientras recibe la respuesta.

Aunque en todos los casos «se detuvo a medias», Claude Code redacta el mensaje de forma distinta según la causa. La referencia oficial enumera los cuatro siguientes, que terminan igual: «The response above may be incomplete.» (la respuesta anterior puede estar incompleta).

API Error: Server error mid-response. The response above may be incomplete.
API Error: Connection lost mid-response. The response above may be incomplete.
API Error: Your computer went to sleep mid-response. The response above may be incomplete.
API Error: The response stopped arriving. The response above may be incomplete.

La primera línea aparece cuando el servidor devuelve un error de sobrecarga o 5xx a mitad de la respuesta; la segunda, cuando se cae la conexión; la tercera, cuando el equipo entra en suspensión en mitad de la respuesta. Solo la cuarta, la de este artículo, significa que los datos dejaron de llegar sin que hubiera ni un error ni una desconexión.

Quien corta son cuatro temporizadores de vigilancia

Según la documentación oficial de configuración de red, Claude Code tiene cuatro temporizadores que abortan un stream que se ha quedado en silencio, para que una conexión muerta falle en lugar de quedarse colgada indefinidamente. Una vez que la respuesta ha empezado a llegar, actúan los tres primeros de la tabla.

Si te conectas directamente a la API de Anthropic, la referencia es el límite de 180 segundos de la vigilancia a nivel de bytes. Es decir, la pantalla parece congelada durante unos minutos antes de que aparezca este mensaje. Según la referencia oficial, cuando la petición sigue viva pero llevan 20 segundos sin llegar datos, primero aparece el siguiente aviso. Significa «todavía no ha fallado», y la cuenta atrás llega hasta el momento del corte (antes de la v2.1.185 el umbral era de 10 segundos y el texto era otro).

Waiting for API response · will retry in … · check your network

Si los datos vuelven, el aviso desaparece solo. El mensaje de este artículo aparece cuando no desaparece, se llega al corte y parte de la salida ya se había completado.

2. En la v2.1.227 sustituyó a «Response stalled mid-stream»

Justo después de describir los cuatro mensajes, la referencia oficial de errores indica que, antes de la v2.1.227, Connection lost mid-response se mostraba como Connection closed mid-response y The response stopped arriving como Response stalled mid-stream. En esa misma versión también se renombró el mensaje de los atascos anteriores a cualquier salida.

Un caso en el que el antiguo Response stalled mid-stream apareció junto con el modelo repitiendo la misma palabra una y otra vez se analiza en nuestro artículo sobre Response stalled mid-stream y el bucle infinito de «court». Para el mensaje de desconexión, los informes de la época del texto antiguo están en el artículo sobre Connection closed mid-response, y el texto renombrado se explica en el artículo sobre Connection lost mid-response.

3. En qué se diferencia de mensajes parecidos

El mensaje que ves depende de hasta dónde había avanzado la respuesta cuando se detuvo. Si ordenamos la explicación oficial de «Automatic retries» según el avance de la respuesta, queda así.

El motivo por el que ③ no se reintenta también está documentado. Reenviar la petición después de completar un bloque de texto o una llamada a herramienta podría ejecutar dos veces la misma llamada a herramienta. Por eso Claude Code conserva lo completado y añade una nota en lugar de descartar el turno.

La diferencia con Connection lost mid-response: corte o silencio

Los dos aparecen después de que haya salido parte de la respuesta, y en ambos se conserva la salida y se puede retomar con continue. Lo que cambia es la forma de detenerse. Lost significa que se determinó que la conexión se perdió, así que conviene sospechar de un microcorte en tu propia red, de una VPN que se reconecta o de un equipo intermedio que corta la conexión. Stopped arriving significa que la conexión sigue ahí pero no fluye nada por ella, y el corte llega solo después de agotar el tiempo del temporizador de vigilancia. Por eso los ajustes de temporizador de la sección 6 solo pueden ayudar en el caso de stopped arriving.

La diferencia con Streaming response ended…: se detuvo o terminó vacía

Según la referencia oficial, Streaming response ended before any complete data was received es un aviso que aparece cuando una respuesta terminó sin entregar ningún dato utilizable. Claude Code deja de usar streaming, reenvía la misma petición y continúa el turno. El aviso se muestra solo una vez por sesión interactiva (antes de la v2.1.239 el reenvío era silencioso). La referencia oficial señala que una causa habitual es un proxy o gateway en la ruta que consume o transforma el cuerpo de la respuesta. Stopped arriving, en cambio, es una respuesta que llegó en parte y luego se detuvo, y no se reenvía automáticamente.

4. Qué pasa con el trabajo hecho hasta ese momento

Según la explicación oficial, Claude Code conserva todos los bloques completados y descarta al final del turno el último bloque, el que estaba a medias. Por eso pueden faltar las últimas frases de la pantalla o la última llamada a herramienta. Las llamadas a herramientas que se habían completado se ejecutan, y el turno continúa a partir de sus resultados. Lo que ocurre después depende del entorno de ejecución.

Qué muestra -p cuando se detiene y cómo continuar

Con la salida de texto predeterminada del modo no interactivo, Claude Code imprime el último bloque de texto completado de ese turno y, a continuación, este mensaje (antes de la v2.1.219 solo mostraba el mensaje y la respuesta se descartaba). Sin embargo, si no queda ningún texto completado, por ejemplo porque la conversación se compactó en mitad del turno y ese texto desapareció, solo se muestra el mensaje (añadido tras comprobarlo en la referencia oficial de errores el 26 de septiembre de 2026). Con --output-format json o stream-json, el mensaje va en el campo result. El procedimiento oficial es esperar a que la conexión se estabilice, reanudar la sesión y enviar continue.

# Continuar la conversación más reciente
claude -p "continue" --continue

# Continuar una sesión concreta por su ID
claude -p "continue" --resume "$session_id"

Sobre la reanudación automática mediante hooks, el autor de la issue #87972 escribe que, en la época del texto antiguo, el hook Stop se disparaba y permitía continuar automáticamente, pero que dejó de funcionar más o menos cuando se cambió el nombre. Es una observación del autor, y la documentación oficial no dice si el comportamiento anterior era intencionado. Según la documentación oficial actual, un hook puede registrar o notificar, pero no puede reanudar el turno.

5. Causas: lo que está documentado y lo que se ha informado

Este mensaje solo comunica el resultado («dejaron de llegar datos») y no dice por qué se detuvo. A continuación, la información ordenada según su grado de certeza.

La referencia oficial sitúa este mensaje en su apartado «Server errors». Ese apartado empieza diciendo que la mayoría proceden del lado del proveedor de inferencia, como el servicio de Anthropic, pero para este texto concreto la explicación oficial no va más allá del mecanismo descrito arriba. La documentación oficial no determina si se detuvo en tu propia red, en un equipo intermedio o en el servidor.

#88900 y #90005 dicen que se detuvo aunque su propia red no tenía ningún problema. Sin embargo, eso por sí solo no demuestra que la causa esté en el servidor. Como señala también el autor de #90005, las pruebas de conexiones cortas no reproducen una conexión que permanece abierta varios minutos y se queda en silencio a mitad de camino.

6. Qué hacer cuando se detiene

Los pasos van ordenados de menor esfuerzo y mayor efecto a mayor esfuerzo. Si solo ha pasado una vez, basta con llegar al paso 2.

Ejemplo para ~/.claude/settings.json (vigilancia a nivel de bytes a 10 minutos):

{
  "env": {
    "CLAUDE_BYTE_STREAM_IDLE_TIMEOUT_MS": "600000"
  }
}

7. Cómo comprobar que está resuelto

No lo des por resuelto solo porque no haya aparecido una vez. Lanza una tarea de tamaño similar y revisa estos cuatro puntos.

# Comprobar la versión
claude --version

# Arrancar con registro de depuración
claude --debug

# Contar los archivos de conversación que contienen este texto (macOS, Linux)
grep -rl "The response stopped arriving" ~/.claude/projects/ | wc -l

# Igualmente, contar las líneas que contienen este texto (PowerShell)
Get-ChildItem "$HOME\.claude\projects" -Recurse -Filter *.jsonl | Select-String -SimpleMatch "The response stopped arriving" | Measure-Object

Usa el recuento como orientación. El autor de #90005 escribe que en un tramo de 85 minutos se detuvo 15 veces en pantalla, pero en los registros de conversación solo quedó 1 anotación. Aunque los registros marquen 0, lo más fiable es llevar tu propia cuenta de las veces que se detiene en pantalla.

8. Qué información guardar al informar del error

La referencia oficial de errores indica estos cuatro canales para cuando el problema no se resuelve.

• Ejecutar /feedback dentro de Claude Code. Envía a Anthropic la transcripción de la conversación y tu descripción, y también permite abrir una issue de GitHub ya rellenada. Con proveedores como Bedrock o Vertex, se guarda localmente en lugar de enviarse
• Ejecutar claude doctor en la shell para ver un diagnóstico de solo lectura de la instalación
• Consultar incidencias en status.claude.com
• Buscar entre las issues existentes de GitHub, con el texto antiguo y con el nuevo

9. Qué está confirmado y qué no

10. Resumen

«API Error: The response stopped arriving» indica que, después de que parte de la respuesta ya hubiera llegado, los datos se detuvieron con la conexión abierta y el temporizador de vigilancia de Claude Code la cortó. Es lo mismo que Response stalled mid-stream antes de la v2.1.227, y la salida completada se conserva. Comprueba primero el estado de tu trabajo y luego responde continue.

Si se repite, prueba en este orden: actualizar la versión, aislar la VPN, el proxy o el gateway, y acortar cada respuesta. Solo en entornos donde la ruta se queda en silencio mucho tiempo tiene sentido alargar la vigilancia a nivel de bytes. Connection lost mid-response, en el que se cae la propia conexión, apunta a otros lugares donde investigar, así que compara primero el texto del mensaje. Los demás errores están reunidos en nuestra recopilación de errores habituales de Claude Code y sus soluciones.

Preguntas frecuentes

P. ¿Qué significa «API Error: The response stopped arriving»?
R. Significa que, en mitad de una respuesta en streaming, los datos dejaron de llegar con la conexión todavía abierta y el temporizador de vigilancia de Claude Code cortó esa conexión. Es el mensaje de una detención ocurrida después de completar un bloque de texto o una llamada a herramienta, y la salida hasta ese punto se conserva.

P. ¿Es un error distinto de «Response stalled mid-stream»?
R. Es el mismo. La referencia oficial de errores indica que, antes de la v2.1.227, este mensaje era Response stalled mid-stream. Solo ha cambiado el texto; no significa que haya empezado un tipo de fallo nuevo.

P. ¿Qué respondo para retomar donde se quedó?
R. Responde continue. Seguirá desde el último bloque completado. Si se detuvo en mitad de una operación con archivos o de un comando, es más seguro comprobar antes el estado real con git status o similar.

P. ¿Desaparecerá si subo el número de reintentos?
R. No. En esta situación, Claude Code está diseñado para no reenviar nada, de modo que la misma llamada a herramienta no se ejecute dos veces. CLAUDE_CODE_MAX_RETRIES se aplica a los fallos anteriores al inicio de la salida.

P. ¿En qué se diferencia de «Connection lost mid-response»?
R. Lost significa que se cayó la propia conexión; stopped arriving, que la conexión siguió abierta pero los datos dejaron de llegar. En ambos casos se conserva la salida completada y puedes retomar con continue, pero ajustar el tiempo de vigilancia solo puede ayudar en el caso de stopped arriving.

Fuentes primarias

• Claude Code — Error reference (documentación oficial): los cuatro mensajes de «The response above may be incomplete» y el cambio de nombre de la v2.1.227, las falsas alarmas anteriores a la v2.1.222, Automatic retries, el aviso de espera, No response from API, Streaming response ended before any complete data was received, Report an error
• Claude Code — Enterprise network configuration (documentación oficial): los cuatro temporizadores de vigilancia y sus tiempos predeterminados, las variables de entorno para configurarlos, los registros de depuración y cómo pasar ajustes a los agentes en segundo plano
• Claude Code — Environment variables (documentación oficial): descripción de CLAUDE_STREAM_IDLE_TIMEOUT_MS, CLAUDE_BYTE_STREAM_IDLE_TIMEOUT_MS y API_FORCE_IDLE_TIMEOUT
• Claude Code — Hooks reference (documentación oficial): StopFailure en los turnos que terminan en un error de la API
• Claude Code — Run Claude Code programmatically (documentación oficial): reanudación con --continue y --resume
• anthropics/claude-code — CHANGELOG (oficial): las entradas de las versiones v2.1.222, v2.1.227, v2.1.229, v2.1.232, v2.1.246 y v2.1.257
• Issues de GitHub: #88900, #90005, #89027, #87246, #87972 (todas son informes de usuarios; consultadas el 22 de septiembre de 2026)