Claude Code · Solución de problemas

Error de conexión de API de Claude Code: tiempos de espera y soluciones

Un error de conexión significa que Claude Code nunca recibió una respuesta de la API: la solicitud no llegó, o la respuesta tardó demasiado. A diferencia de los errores 4xx y 5xx, la causa suele ser la ruta de red o la dirección del endpoint.

Última comprobación

El texto del error

Claude Code
API Error (Connection error.) · Unable to connect to API (ECONNREFUSED) · Request timed out

Solución paso a paso

  1. 1. Revisa la dirección

    Ejecuta /status. El endpoint debe ser api.aicodewith.ai sobre https, sin /v1 ni errores tipográficos.

    ~/.claude/settings.json
    {
      "env": {
        "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
        "ANTHROPIC_API_KEY": "",
        "ANTHROPIC_BASE_URL": "https://api.aicodewith.ai"
      }
    }
  2. 2. Prueba la red

    Ejecuta curl -I https://api.aicodewith.ai en la misma terminal. Si se queda colgado o falla, el problema es la red, no Claude Code.

  3. 3. Proxy y firewall

    Si usas un proxy, exporta HTTPS_PROXY en esa terminal (o añádelo al bloque env). Los firewalls corporativos pueden necesitar que se permita api.aicodewith.ai.

  4. 4. Aumenta el tiempo de espera

    En solicitudes lentas o largas, añade "API_TIMEOUT_MS": "600000" al bloque env y reinicia.

Causas comunes

SíntomaCausa probable
ECONNREFUSED o ENOTFOUNDHost incorrecto, o DNS/proxy lo bloquea
Falla solo en VPN o red de oficinaReglas de firewall o proxy
Se agota el tiempo solo en respuestas largasTiempo de espera demasiado corto para la red
Funciona con curl, falla en Claude CodeConfiguración de proxy diferente entre shells o el IDE

¿Se cobran las solicitudes fallidas?

Las solicitudes fallidas (4xx/5xx, tiempos de espera, conexiones interrumpidas) no se cobran — solo se facturan las solicitudes que se completan correctamente. Si un fallo del proveedor se reintenta automáticamente y tiene éxito, se cobra una vez.

¿Sigues teniendo problemas?

  • Revisa la página del modelo en aicodewith: muestra el estado reciente de cada canal.
  • Busca la solicitud en los registros de uso de tu panel para ver su modelo, estado y costo.
  • Envía un correo a support@aicodewith.com con la hora del error, el modelo y el texto del error (nunca tu clave de API completa).

Estado y precios del modeloContactar con soporteDocumentación

FAQ

¿Qué significa "API Error (Connection error)" en Claude Code?

Claude Code no pudo alcanzar la API o no obtuvo respuesta a tiempo. Revisa la URL base y luego la red, el proxy y el firewall.

¿Cómo configuro un proxy para Claude Code?

Exporta HTTPS_PROXY en la terminal desde la que inicias Claude Code, o añádelo al bloque env en ~/.claude/settings.json.

¿Cómo aumento el tiempo de espera de Claude Code?

Configura API_TIMEOUT_MS (en milisegundos) en el bloque env de settings.json y reinicia Claude Code.

¿Un error de conexión es culpa de mi clave?

No. Los problemas de clave devuelven 401. Un error de conexión significa que no llegó ninguna respuesta HTTP.

¿Por qué funciona con curl pero no en mi IDE?

Puede que el IDE no herede la configuración de proxy de tu shell. Pon HTTPS_PROXY en el bloque env de settings.json para que todos los clientes de Claude Code lo usen.

¿Se me cobra por solicitudes fallidas?

Las solicitudes fallidas (4xx/5xx, tiempos de espera, conexiones interrumpidas) no se cobran — solo se facturan las solicitudes que se completan correctamente. Si un fallo del proveedor se reintenta automáticamente y tiene éxito, se cobra una vez.

¿Listo para probarlo?

El cobro es por token desde un saldo prepago. Se aplican límites de velocidad y concurrencia, y puedes establecer topes de gasto diarios, mensuales o totales en cada clave de API.

Relacionado

Fuentes

Claude y Claude Code son marcas registradas de Anthropic PBC. aicodewith es una plataforma independiente y no está afiliada ni respaldada por Anthropic. Los formatos de error se citan de Claude Code y pueden cambiar. Revisado el 2026-10-10.