---
title: "«npm error code ECONNREFUSED» en el Mac · Guías de Kilobat"
url: "https://kilobat.app/es/guides/npm-econnrefused"
description: "npm install en tu Mac se detiene con «npm error code ECONNREFUSED». Un host rechazó la conexión. Revisa el registro, el proxy y los servicios locales."
---

# «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 agente**Copia 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](https://kilobat.app/es/guides/npm-econnreset).

**¿Por qué nombra 127.0.0.1?**

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

## Fuentes

- [Documentación de Node.js: Common system errors](https://nodejs.org/api/errors.html#common-system-errors)
- [Documentación de npm: Errores comunes](https://docs.npmjs.com/common-errors)

Comprobado el 29 de octubre de 2026.

## Guías relacionadas

- [«npm error code ECONNRESET» en el Mac](https://kilobat.app/es/guides/npm-econnreset): ECONNRESET indica que una conexión se reinició de forma forzada.
- [«npm error code ENOTFOUND» en el Mac](https://kilobat.app/es/guides/npm-enotfound): ENOTFOUND indica una búsqueda DNS fallida.
- [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.
- [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.
