“npm error code ECONNREFUSED” auf dem Mac

ECONNREFUSED meldet eine abgelehnte Verbindung. Die Node.js-Dokumentation sagt: “No connection could be made because the target machine actively refused it.”

Mit deinem Agenten behebenKopiert einen Prompt für Claude Code, Codex oder jeden Agenten, der das Terminal nutzen kann.

Mein Mac hat dieses Problem: „npm error code ECONNREFUSED“ auf dem Mac. Lies https://kilobat.app/de/guides/npm-econnrefused.md und geh es mit mir durch. Installiere die Kilobat-CLI, falls sie fehlt: brew install seifip/kilobat/kilobat. Führe die Terminal- und kilobat-Checks aus der Anleitung selbst aus und sag mir, was du findest. Liste die Schritte auf, die nur ich erledigen kann. Frag nach, bevor du eine Einstellung änderst.

Gilt für: npm 10 und neuer gibt „npm error“ aus. Ältere Versionen geben „npm ERR!“ aus. Node.js unter allen aktuellen macOS-Versionen.Geprüft: 29. Oktober 2026

Symptome

  • npm install oder ein Skript bricht mit npm error code ECONNREFUSED ab.
  • Die nächste Zeile nennt eine Adresse und einen Port, etwa 127.0.0.1:8080.
  • Es folgt oft auf eine Proxy- oder Registry-Einstellung.

Mögliche Ursachen

  • Eine Proxy-Einstellung, die ins Leere zeigt. Ein Proxy auf 127.0.0.1 oder einem anderen Host ist gesetzt, aber dort läuft kein Proxy.
  • Eine lokale Registry, die aus ist. Ein lokaler Mirror oder Cache ist ausgefallen.
  • Ein inaktiver Dienst. Die Node.js-Dokumentation sagt, dass das meist von einem Dienst kommt, der auf dem entfernten Host inaktiv ist.
  • Ein Skript, das einen lokalen Server aufruft. Ein Test- oder Build-Schritt kann einen Server aufrufen, der nicht gestartet ist.

So prüfst du es

  1. Lies Adresse und Port im Fehler.

  2. Zeige Proxy und Registry von npm an.

    npm config get proxy
    npm config get https-proxy
    npm config get registry
  3. Teste diesen Port.

    nc -vz 127.0.0.1 8080
  4. Zeige die Proxy-Variablen an.

    env | grep -i proxy

So behebst du es

  1. Lösche eine Proxy-Einstellung, die du nicht brauchst.

    npm config delete proxy
    npm config delete https-proxy
  2. Starte die lokale Registry oder den Server, den die Adresse nennt.

  3. Entferne falsche Proxy-Variablen.

    unset https_proxy http_proxy
  4. Wiederhole die Installation.

Fragen

Ist ECONNREFUSED dasselbe wie ECONNRESET?

Nein. ECONNREFUSED ist eine Ablehnung gleich am Anfang. ECONNRESET schließt eine offene Verbindung. Siehe “npm error code ECONNRESET” auf dem Mac.

Warum nennt es 127.0.0.1?

npm hat eine lokale Adresse versucht, meist wegen einer Proxy- oder Registry-Einstellung.

Quellen

Geprüft am 29. Oktober 2026.