---
title: "«curl: (7) Failed to connect» en el Mac · Guías de Kilobat"
url: "https://kilobat.app/es/guides/curl-7-failed-to-connect"
description: "curl en tu Mac se detiene con (7) Failed to connect. Revisa el puerto, el servicio, un firewall, un proxy y la dirección que probó curl."
---

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

## 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](https://kilobat.app/es/guides/curl-could-not-resolve-host).

## Fuentes

- [curl: Códigos de error de libcurl](https://curl.se/libcurl/c/libcurl-errors.html)

Comprobado el 29 de octubre de 2026.

## Guías relacionadas

- [«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.
- [ERR_CONNECTION_REFUSED en Chrome en el Mac](https://kilobat.app/es/guides/err-connection-refused): ERR_CONNECTION_REFUSED es un error de red de Chrome.
- [Homebrew falla con «curl: (28)» en el Mac](https://kilobat.app/es/guides/homebrew-curl-28-timed-out): Homebrew descarga con curl.
- [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.
