« 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 agentCopie 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.

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

Vérifié le 29 octobre 2026.