Claude Code ECONNRESET, «Conexión perdida», «Esperando la respuesta de la API · Comprueba tu red», «No se puede conectar a la API» y errores de certificados

Los mensajes

API Error: Connection dropped (ECONNRESET)
API Error: Connection lost mid-response
API Error: fetch failed
Unable to connect to API (ConnectionRefused)
Retrying in 0s · attempt 1/10
Waiting for API response · will retry in 2m 35s · check your network
API Error: Socket is closed
SSL certificate verification failed: unable to get local issuer certificate
Error: certificate has expired (CERT_HAS_EXPIRED)

¿El problema está en tu lado o en el suyo? Una comprobación de dos minutos

curl -sS -o /dev/null -w "%{http_code} %{time_total}s\n" https://api.anthropic.com/v1/models -H "x-api-key: x" -H "anthropic-version: 2023-06-01"
# 401 in under a second = network path is fine, the problem is upstream or in Claude Code
# timeout / SSL error / 000 = the problem is on your side of the wire
env | grep -i -E "proxy|anthropic|node_extra|ssl"
claude --debug     # per-request timing and retry reasons in the log

Si curl obtiene rápidamente un 401 y no hay variables de proxy, casi con toda seguridad se trata de una incidencia del proveedor. Ese es el grupo descrito en #87424 (abierta: ECONNRESET intermitente en la aplicación de escritorio y la CLI, sin VPN ni proxy, desde agosto de 13, confirmado por varias personas hasta agosto de 21) y #86473 (ECONNRESET persistente en todas las interfaces mientras HTTP directamente a la API funciona). Ningún cambio local lo soluciona; los reintentos y el tiempo sí. Consulta status.claude.com y, si varias personas notifican el problema a la misma hora en el registro de incidencias, deja de depurar.

«Esperando la respuesta de la API · comprueba tu red»

El mensaje culpa a tu red y, a menudo, se equivoca. #82155 (abierta, 15 reacciones): bloqueos de varios minutos durante todo el día, con la espera entre reintentos superando los dos minutos en una red que funcionaba correctamente de forma demostrable. #76555 (abierta): la espera se produce en cada respuesta, con distintos modelos. #72059 y #70534: el mismo bloqueo, específicamente cuando se consulta al modelo asesor, seguido de una respuesta normal al terminar el temporizador. La espera entre reintentos es exponencial, así que el perjuicio visible es la espera, no el fallo; las variables siguientes la acortan.

Variables de reintento y tiempo de espera

export CLAUDE_CODE_MAX_RETRIES=15               # default 10, capped at 15
export CLAUDE_CODE_RETRY_WATCHDOG=1              # keep retrying instead of giving up (unattended runs)
export API_TIMEOUT_MS=600000                     # per-request timeout, default 10 minutes
export CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS=60000 # give up on a silent stream sooner and retry
export CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY=2    # fewer parallel streams on a flaky link

Reducir el tiempo de espera del primer byte es lo que cambia la experiencia con una conexión inestable: en lugar de esperar los diez minutos completos en un flujo que nunca responderá, el cliente lo abandona y reintenta. Reducir la concurrencia del uso de herramientas ayuda en conexiones que se cortan cuando se ejecutan varios flujos a la vez (puntos de acceso móviles, algunas VPN).

Proxies, VPN y redes corporativas

Configura las variables de proxy que lee Claude Code: HTTPS_PROXY (y HTTP_PROXY, NO_PROXY). Un proxy que solo existe en el navegador o en la configuración de npm es invisible para la CLI.
Proxies que inspeccionan TLS sustituyen el certificado de Anthropic por el suyo: eso es unable to get local issuer certificate. Exporta la CA raíz corporativa a un archivo PEM y configura NODE_EXTRA_CA_CERTS=/path/to/corp-root.pem. No desactives la verificación.
`CERT_HAS_EXPIRED` en la versión nativa (#71727, 2.1.19x): el almacén de confianza incluido, no tu reloj. claude update; si sigues atascado, la versión de npm utiliza el almacén del sistema.
`ConnectionRefused` en macOS después de una reinstalación (#75897) — un proxy local o un cliente VPN que está desactivado, pero sigue configurado en el entorno; borra las variables de proxy y la configuración de proxy del sistema y vuelve a intentarlo.
Cambios de salida de la VPN durante la sesión restablecen todos los flujos abiertos: cabe esperar un ECONNRESET por cada reconexión.

A través de una puerta de enlace

Configura Claude Code para que use una pasarela (ANTHROPIC_BASE_URL=https://aiprimetech.io) y la ruta de red cambia: el cliente se comunica con la pasarela, y esta mantiene las conexiones con el servicio de origen y reintenta en otra cuenta cuando una está saturada. Esto no hace que una red local averiada funcione, pero para los casos de *restablecimiento de la conexión en el servicio de origen* descritos arriba elimina la dependencia de una sola cuenta, y la misma clave sigue funcionando durante una incidencia de la suscripción. Ejecuta la comprobación con curl contra el host de la pasarela para confirmar la ruta antes de cambiar.

export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_gateway_key
claude

¿Te has cansado de lidiar con este error?

Ejecuta Claude Code a través del gateway de AI Prime Tech: los mismos modelos Claude en las cuentas de origen propias del gateway, dos variables de entorno para cambiar, y las cuentas nuevas reciben $5 de crédito gratuito para la API con el código FIXIT — sin tarjeta.

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

Crea una cuenta con el código FIXIT

Preguntas frecuentes

¿Cómo soluciono «Error de API: se ha interrumpido la conexión (ECONNRESET)» en Claude Code?

Ejecuta curl contra la API: si responde rápidamente y no tienes un proxy, el restablecimiento se produce en el servicio de origen; deja que se ejecuten los reintentos y consulta status.claude.com. Si curl también falla, corrige las variables del proxy, la VPN o el certificado de CA.

¿Qué significa «Esperando respuesta de la API · se reintentará en … · comprueba tu red»?

Claude Code no recibió ninguna respuesta de la API dentro del tiempo de espera y está esperando antes de reintentar. A pesar del mensaje, a menudo el problema no es tu red; reduce CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS para que el cliente abandone antes los flujos que no envían datos.

¿Cómo soluciono «No se puede obtener el certificado del emisor local» en Claude Code?

Un proxy está volviendo a firmar TLS. Exporta el certificado raíz corporativo en formato PEM y configura NODE_EXTRA_CA_CERTS para que apunte a ese archivo. Nunca desactives la verificación de certificados.

¿Qué significa «Reintentando en 0 s · intento 1/10»?

Una solicitud ha fallado y Claude Code está reintentando; el valor predeterminado es de 10 intentos con esperas cada vez mayores, CLAUDE_CODE_MAX_RETRIES lo aumenta a 15 y CLAUDE_CODE_RETRY_WATCHDOG=1 mantiene los reintentos en ejecuciones desatendidas.

Ejecuta Claude Code con la pasarela

Los mismos modelos, dos variables de entorno y créditos por 7.69231× su valor nominal, o un plan ilimitado de tarifa plana. Cuentas nuevas: $5 de crédito gratuito para la API con el código FIXIT.

Obtener una clave de API Ver planes ilimitados

AI Prime Tech es una pasarela API independiente y no está afiliada a Anthropic, ni cuenta con su respaldo o patrocinio. «Claude» y «Claude Code» son marcas comerciales de Anthropic. Las funciones de Claude Code descritas aquí se basan en la documentación pública de Anthropic en el momento de la redacción y cambian con frecuencia; los precios y las listas de modelos de esta página se obtienen de la configuración actual de esta pasarela.

Errores de conexión de Claude Code: ECONNRESET, conexión perdida durante la respuesta, «Esperando respuesta de la API», «No se puede conectar con la API», errores de certificados SSL

TLDR