«curl: (56) Failure when receiving data» en el Mac

El código de salida 56 de curl indica un paso fallido. La documentación de curl dice: «Failure with receiving network data.»

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

Mi Mac tiene este problema: «curl: (56) Failure when receiving data» en el Mac. Lee https://kilobat.app/es/guides/curl-56-failure-receiving-data.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: (56) Failure when receiving data from the peer o una línea parecida.
  • Una descarga empieza y luego se detiene.
  • El texto puede añadir «Connection reset by peer».

Causas probables

  • Una conexión restablecida. Un servidor, un proxy o un firewall cerró la conexión mientras fluían datos.
  • Una VPN o un cambio de red. Una reconexión de la VPN o un cambio de Wi-Fi interrumpe la transferencia.
  • Un proxy que bloquea el contenido. Un filtro puede cortar una respuesta que no permite.
  • Un fallo del servidor. El servidor puede fallar durante una respuesta larga.

Cómo comprobarlo

  1. Ejecuta curl con detalles. Anota cuándo empieza el fallo.

    curl -v https://example.com
  2. Repite en otra red, como un punto de acceso del teléfono.

  3. Muestra las variables de proxy.

    env | grep -i proxy
  4. Revisa el enlace Wi-Fi mientras se ejecuta la transferencia.

    kilobat wifi

Cómo solucionarlo

  1. Repite la transferencia. Añade reintentos a los scripts.

    curl --retry 3 -O https://example.com/file.zip
  2. Desactiva la VPN, el proxy o la app de seguridad para una prueba breve. Vuelve a activarlos después.

  3. Reanuda una descarga con -C -.

    curl -C - -O https://example.com/file.zip
  4. Si falla solo en una red, pregunta a su administrador por el filtrado.

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

¿(56) es lo mismo que ECONNRESET?

Una conexión restablecida es una causa posible. Consulta «npm error code ECONNRESET» en el Mac.

¿Demuestra que el servidor falla?

No. Un dispositivo del trayecto también puede cerrar la conexión.

Fuentes

Comprobado el 29 de octubre de 2026.