---
title: "«Unable to connect to API» en Claude Code en el Mac · Guías de Kilobat"
url: "https://kilobat.app/es/guides/claude-code-unable-to-connect-to-api"
description: "Claude Code en tu Mac muestra «Unable to connect to API». Revisa tu conexión, una VPN que bloquee el host de la API y un proxy que debas configurar."
---

# «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 agente**Copia 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](https://kilobat.app/es/guides/dns-server-not-found).
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](https://kilobat.app/es/guides/recipes/why-cant-it-connect).

## 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

- [Claude Code: referencia de errores](https://code.claude.com/docs/en/errors.md)
- [Claude Code: configuración de red empresarial](https://code.claude.com/docs/en/network-config.md)

Comprobado el 29 de octubre de 2026.

## Guías relacionadas

- [«Request timed out» en Claude Code en el Mac](https://kilobat.app/es/guides/claude-code-request-timed-out): Claude Code muestra Request timed out cuando la API no responde antes del límite de la conexión.
- [«Unable to connect to API: SSL certificate verification failed» en el Mac](https://kilobat.app/es/guides/claude-code-ssl-certificate-verification-failed): Claude Code muestra esto cuando un certificado procede de una autoridad en la que no confía.
- [«curl: (6) Could not resolve host» en el Mac](https://kilobat.app/es/guides/curl-could-not-resolve-host): El código de salida 6 de curl significa que curl no pudo obtener una dirección para el nombre de host.
- [Los ajustes de proxy impiden que las apps se conecten en un Mac](https://kilobat.app/es/guides/proxy-settings-breaking-apps): Un ajuste de proxy envía el tráfico a través de otro servidor.
