«npm error code ECONNREFUSED» en el Mac

ECONNREFUSED indica una conexión rechazada. La documentación de Node.js dice: «No connection could be made because the target machine actively refused it.»

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

Mi Mac tiene este problema: «npm error code ECONNREFUSED» en el Mac. Lee https://kilobat.app/es/guides/npm-econnrefused.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: npm 10 y posteriores muestran «npm error». Las versiones anteriores muestran «npm ERR!». Node.js en todas las versiones actuales de macOS.Revisado: 29 de octubre de 2026

Síntomas

  • npm install o un script se detiene con npm error code ECONNREFUSED.
  • La línea siguiente nombra una dirección y un puerto, como 127.0.0.1:8080.
  • A menudo sigue a un ajuste de proxy o de registro.

Causas probables

  • Un ajuste de proxy que apunta a la nada. Hay un proxy configurado en 127.0.0.1 u otro host, pero allí no se ejecuta ningún proxy.
  • Un registro local apagado. Un espejo o una caché local está caído.
  • Un servicio inactivo. La documentación de Node.js dice que esto suele deberse a un servicio inactivo en el host remoto.
  • Un script que llama a un servidor local. Un paso de prueba o de compilación puede llamar a un servidor que no se ha iniciado.

Cómo comprobarlo

  1. Lee la dirección y el puerto del error.

  2. Muestra el proxy y el registro de npm.

    npm config get proxy
    npm config get https-proxy
    npm config get registry
  3. Prueba ese puerto.

    nc -vz 127.0.0.1 8080
  4. Muestra las variables de proxy.

    env | grep -i proxy

Cómo solucionarlo

  1. Elimina un ajuste de proxy que no necesites.

    npm config delete proxy
    npm config delete https-proxy
  2. Inicia el registro o el servidor local que nombra la dirección.

  3. Quita las variables de proxy incorrectas.

    unset https_proxy http_proxy
  4. Repite la instalación.

Preguntas

¿ECONNREFUSED es lo mismo que ECONNRESET?

No. ECONNREFUSED es un rechazo al principio. ECONNRESET cierra una conexión abierta. Consulta «npm error code ECONNRESET» en el Mac.

¿Por qué nombra 127.0.0.1?

npm probó una dirección local, normalmente por un ajuste de proxy o de registro.

Fuentes

Comprobado el 29 de octubre de 2026.