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
API Error (Connection error.) · Unable to connect to API (ECONNREFUSED) · Request timed outSolución paso a paso
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. 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. 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. Aumenta el tiempo de espera
En solicitudes lentas o largas, añade "API_TIMEOUT_MS": "600000" al bloque env y reinicia.
Causas comunes
| Síntoma | Causa probable |
|---|---|
| ECONNREFUSED o ENOTFOUND | Host incorrecto, o DNS/proxy lo bloquea |
| Falla solo en VPN o red de oficina | Reglas de firewall o proxy |
| Se agota el tiempo solo en respuestas largas | Tiempo de espera demasiado corto para la red |
| Funciona con curl, falla en Claude Code | Configuració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
- Documentación de Claude Code: errores
- Documentación de Claude Code: configuración
- Documentación de la API de Anthropic: errores
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.