«curl: (7) Failed to connect» en el Mac

El código de salida 7 de curl indica un paso fallido. La documentación de curl dice: «Failed to connect() to host or proxy.»

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

Mi Mac tiene este problema: «curl: (7) Failed to connect» en el Mac. Lee https://kilobat.app/es/guides/curl-7-failed-to-connect.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: el curl que incluye macOS y el curl de Homebrew, en todas las versiones actuales de macOS.Revisado: 29 de octubre de 2026

Síntomas

  • Terminal muestra curl: (7) Failed to connect to host port 443.
  • El texto suele añadir «Couldn't connect to server» o «Connection refused».
  • Los scripts y los instaladores se detienen con el código de salida 7.

Causas probables

  • Nada escucha en el puerto. El servicio está caído o usa otro puerto.
  • Un firewall o un proxy. Un firewall puede rechazar la conexión. curl también falla cuando hay un proxy configurado y no se puede alcanzar.
  • Una dirección incorrecta. El host o el puerto de la URL son incorrectos. Una variable de un script puede estar vacía.
  • Una ruta IPv6 o de VPN. curl puede probar una dirección que la red no alcanza.

Cómo comprobarlo

  1. Imprime la URL exacta. Revisa el host y el puerto.

  2. Ejecuta curl con detalles. Las primeras líneas muestran la dirección que falló.

    curl -v https://example.com
  3. Prueba el puerto.

    nc -vz example.com 443
  4. Muestra las variables de proxy.

    env | grep -i proxy

Cómo solucionarlo

  1. Inicia el servicio si es tuyo. Usa el puerto que imprime.

  2. Fuerza IPv4 para probar un fallo de IPv6.

    curl -4 -v https://example.com
  3. Quita un proxy incorrecto.

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

Con Kilobat

  1. El doctor de conexión de Kilobat prueba la dirección capa por capa: red, proxy, DNS, reglas, IPv4, IPv6, TLS y servidor. Indica la capa que falló.

    kilobat why https://example.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

¿El código de salida 7 significa que el host está caído?

No siempre. curl no pudo conectar con el host ni con el proxy. Averigua cuál con curl -v.

¿En qué se diferencia de (6)?

El código de salida 6 significa que el nombre del host no se resolvió. El código 7 significa que falló la conexión. Consulta «curl: (6) Could not resolve host» en el Mac.

Fuentes

Comprobado el 29 de octubre de 2026.