«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.

Arréglalo con tu agenteCopia un prompt para Claude Code, Codex o cualquier agente que pueda usar Terminal.

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.

Se aplica a: Claude Code en un terminal, en todas las versiones actuales de macOS.Revisado: 29 de octubre de 2026

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_PROXY antes 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

  1. Prueba el host de la API desde el mismo shell.

    curl -I https://api.anthropic.com
  2. Muestra las variables de proxy.

    env | grep -i proxy
  3. Ejecuta las comprobaciones dentro de Claude Code.

    /doctor
  4. Prueba el nombre del host a través de macOS.

    dscacheutil -q host -a name api.anthropic.com

Cómo solucionarlo

  1. Si falla el DNS, arréglalo. Consulta El DNS no resuelve en un Mac.

  2. Detrás de un proxy corporativo, configúralo antes de iniciar.

    export HTTPS_PROXY=http://proxy.example.com:8080
  3. Si usas una pasarela, define ANTHROPIC_BASE_URL con su dirección.

  4. Desactiva la VPN para una prueba breve. Vuelve a activarla después.

Con Kilobat

  1. 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.com
  2. Estas comprobaciones de Kilobat son gratuitas. Los agentes de IA las ejecutan por MCP con diagnose_connection y diagnose_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.