«Unable to connect to API» en Claude Code en el Mac
Claude Code muestra «Unable to connect to API» cuando una solicitud no llega a api.anthropic.com. La documentación de Claude Code señala como causas habituales no tener acceso a internet, una VPN que bloquea el host o un proxy corporativo sin configurar.
Mi Mac tiene este problema: «Unable to connect to API» en Claude Code en el Mac. Lee https://kilobat.app/es/guides/claude-code-unable-to-connect-to-api.md y resuélvelo conmigo. Instala la CLI de Kilobat si falta: brew install seifip/kilobat/kilobat. Ejecuta tú mismo las comprobaciones de Terminal y de kilobat de la guía y dime qué encuentras. Enumera los pasos que solo yo puedo hacer. Pregunta antes de cambiar cualquier ajuste.
Síntomas
- Claude Code muestra
Unable to connect to API. Check your internet connection. - El mensaje puede terminar con un código, como ENOTFOUND, EHOSTUNREACH o ECONNRESET.
- Las solicitudes fallan, pero otras apps pueden funcionar.
Causas probables
- Sin acceso a internet. El Mac está sin conexión o no tiene DNS.
- Una VPN que bloquea el host de la API. La documentación de Claude Code la lista como causa habitual.
- Un proxy sin configurar. Un proxy corporativo obligatorio necesita
HTTPS_PROXYantes de iniciar. - Un proxy que rechaza el túnel. ERR_PROXY_TUNNEL significa que el proxy rechazó el túnel. Comprueba sus credenciales y que permita este host.
Cómo comprobarlo
Prueba el host de la API desde el mismo shell.
curl -I https://api.anthropic.comMuestra las variables de proxy.
env | grep -i proxyEjecuta las comprobaciones dentro de Claude Code.
/doctorPrueba el nombre del host a través de macOS.
dscacheutil -q host -a name api.anthropic.com
Cómo solucionarlo
Si falla el DNS, arréglalo. Consulta El DNS no resuelve en un Mac.
Detrás de un proxy corporativo, configúralo antes de iniciar.
export HTTPS_PROXY=http://proxy.example.com:8080Si usas una pasarela, define
ANTHROPIC_BASE_URLcon su dirección.Desactiva la VPN para una prueba breve. Vuelve a activarla después.
Con Kilobat
El doctor de conexión de Kilobat prueba el host de la API capa por capa: red, proxy, DNS, reglas, IPv4, IPv6, TLS y servidor.
kilobat why https://api.anthropic.comEstas comprobaciones de Kilobat son gratuitas. Los agentes de IA las ejecutan por MCP con
diagnose_connectionydiagnose_network. Consulta Averiguar por qué no conecta un sitio o una API.
Preguntas
¿Es importante el código entre paréntesis?
Sí. ENOTFOUND apunta al DNS, EHOSTUNREACH a una ruta, ECONNRESET a un restablecimiento y ERR_PROXY_TUNNEL a un proxy.
¿Reinicio Claude Code después de definir una variable?
Sí. La página de configuración de red indica que una sesión en curso no recoge cambios posteriores del shell.
Fuentes
Comprobado el 29 de octubre de 2026.