---
title: "« npm error code ECONNREFUSED » sur Mac · Guides Kilobat"
url: "https://kilobat.app/fr/guides/npm-econnrefused"
description: "npm install s’arrête sur votre Mac avec npm error code ECONNREFUSED. Un hôte a refusé la connexion. Vérifiez le registre, le proxy et les services locaux."
---

# « npm error code ECONNREFUSED » sur Mac

ECONNREFUSED signale une connexion refusée. La documentation de Node.js dit : « No connection could be made because the target machine actively refused it. »

**Réglez-le avec votre agent**Copie un prompt pour Claude Code, Codex ou tout agent capable d’utiliser Terminal.

Mon Mac a ce problème : « npm error code ECONNREFUSED » sur Mac. Lis https://kilobat.app/fr/guides/npm-econnrefused.md et résous-le avec moi. Installe la CLI Kilobat si elle manque : brew install seifip/kilobat/kilobat. Lance toi-même les vérifications Terminal et kilobat du guide et dis-moi ce que tu trouves. Liste les étapes que moi seul peux faire. Demande-moi avant de modifier un réglage.

S’applique à : npm 10 et versions ultérieures affichent « npm error ». Les anciennes versions affichent « npm ERR! ». Node.js sur toutes les versions actuelles de macOS. · Vérifié le 29 octobre 2026

## Symptômes

- `npm install` ou un script s’arrête avec `npm error code ECONNREFUSED`.
- La ligne suivante nomme une adresse et un port, comme `127.0.0.1:8080`.
- Cela suit souvent un réglage de proxy ou de registre.

## Causes probables

- **Un réglage de proxy qui ne pointe sur rien.** Un proxy sur `127.0.0.1` ou un autre hôte est défini, mais aucun proxy n’y tourne.
- **Un registre local éteint.** Un miroir ou un cache local est en panne.
- **Un service inactif.** La documentation de Node.js indique que cela résulte généralement d’un service inactif sur l’hôte distant.
- **Un script qui appelle un serveur local.** Une étape de test ou de compilation peut appeler un serveur qui n’a pas démarré.

## Comment vérifier

1. Lisez l’adresse et le port dans l’erreur.
2. Affichez le proxy et le registre de npm.

   ```
   npm config get proxy
   npm config get https-proxy
   npm config get registry
   ```
3. Testez ce port.

   ```
   nc -vz 127.0.0.1 8080
   ```
4. Affichez les variables de proxy.

   ```
   env | grep -i proxy
   ```

## Comment corriger

1. Supprimez un réglage de proxy dont vous n’avez pas besoin.

   ```
   npm config delete proxy
   npm config delete https-proxy
   ```
2. Démarrez le registre ou le serveur local que l’adresse désigne.
3. Supprimez les variables de proxy incorrectes.

   ```
   unset https_proxy http_proxy
   ```
4. Relancez l’installation.

## Questions

**ECONNREFUSED est-il identique à ECONNRESET ?**

Non. ECONNREFUSED est un refus au départ. ECONNRESET ferme une connexion ouverte. Voir [« npm error code ECONNRESET » sur Mac](https://kilobat.app/fr/guides/npm-econnreset).

**Pourquoi nomme-t-il 127.0.0.1 ?**

npm a essayé une adresse locale, généralement à cause d’un réglage de proxy ou de registre.

## Sources

- [Documentation Node.js : Common system errors](https://nodejs.org/api/errors.html#common-system-errors)
- [Documentation npm : erreurs courantes](https://docs.npmjs.com/common-errors)

Vérifié le 29 octobre 2026.

## Guides associés

- [« npm error code ECONNRESET » sur Mac](https://kilobat.app/fr/guides/npm-econnreset): ECONNRESET indique qu’une connexion a été réinitialisée de force.
- [« npm error code ENOTFOUND » sur Mac](https://kilobat.app/fr/guides/npm-enotfound): ENOTFOUND signale l’échec d’une résolution DNS.
- [ERR_CONNECTION_REFUSED dans Chrome sur Mac](https://kilobat.app/fr/guides/err-connection-refused): ERR_CONNECTION_REFUSED est une erreur réseau de Chrome.
- [Des réglages de proxy empêchent les apps de se connecter sur un Mac](https://kilobat.app/fr/guides/proxy-settings-breaking-apps): Un réglage de proxy fait passer le trafic par un autre serveur.
