---
title: "„npm error code ECONNREFUSED“ auf dem Mac · Kilobat Anleitungen"
url: "https://kilobat.app/de/guides/npm-econnrefused"
description: "npm install auf deinem Mac bricht mit „npm error code ECONNREFUSED“ ab. Ein Host hat die Verbindung abgelehnt. Prüfe Registry, Proxy und lokale Dienste."
---

# “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 beheben**Kopiert 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](https://kilobat.app/de/guides/npm-econnreset).

**Warum nennt es 127.0.0.1?**

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

## Quellen

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

Geprüft am 29. Oktober 2026.

## Verwandte Anleitungen

- [„npm error code ECONNRESET“ auf dem Mac](https://kilobat.app/de/guides/npm-econnreset): ECONNRESET meldet eine zwangsweise zurückgesetzte Verbindung.
- [“npm error code ENOTFOUND” auf dem Mac](https://kilobat.app/de/guides/npm-enotfound): ENOTFOUND meldet eine fehlgeschlagene DNS-Abfrage.
- [ERR_CONNECTION_REFUSED in Chrome auf dem Mac](https://kilobat.app/de/guides/err-connection-refused): ERR_CONNECTION_REFUSED ist ein Netzwerkfehler von Chrome.
- [Proxy-Einstellungen blockieren App-Verbindungen auf dem Mac](https://kilobat.app/de/guides/proxy-settings-breaking-apps): Eine Proxy-Einstellung leitet den Datenverkehr über einen anderen Server.
