“npm error code ENOTFOUND” auf dem Mac

ENOTFOUND meldet eine fehlgeschlagene DNS-Abfrage. Die Node.js-Dokumentation nennt sie „DNS lookup failed“, einen Fehler von EAI_NODATA oder EAI_NONAME.

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 ENOTFOUND“ auf dem Mac. Lies https://kilobat.app/de/guides/npm-enotfound.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 bricht mit npm error code ENOTFOUND ab.
  • Die nächste Zeile nennt einen Host, etwa registry.npmjs.org.
  • Browser funktionieren möglicherweise.

Mögliche Ursachen

  • Keine Verbindung oder kein DNS. Der Mac erreicht keinen DNS-Server.
  • Eine falsche Registry. Die npm-Registry-Einstellung nennt einen Host, der nicht existiert oder ein VPN braucht.
  • Ein VPN mit eigenem DNS. Firmen-Registries werden nur aufgelöst, solange das VPN an ist.
  • Ein Proxy, den npm nicht nutzt. In Netzwerken nur mit Proxy braucht npm die Proxy-Einstellungen.

So prüfst du es

  1. Zeige die Registry an, die npm verwendet.

    npm config get registry
  2. Löse den Hostnamen über macOS auf.

    dscacheutil -q host -a name registry.npmjs.org
  3. Frage die Registry direkt ab.

    npm ping
  4. Zeige die Proxy-Einstellungen an.

    npm config get https-proxy

So behebst du es

  1. Wenn die Abfrage über macOS scheitert, behebe DNS. Siehe DNS löst auf dem Mac nicht auf.

  2. Korrigiere die Registry.

    npm config set registry https://registry.npmjs.org/
  3. Verbinde das VPN für eine Firmen-Registry.

  4. Leere den DNS-Cache. Siehe DNS-Cache auf dem Mac leeren.

Mit Kilobat

  1. Der Verbindungsdoktor von Kilobat testet die Adresse Schicht für Schicht: Netzwerk, Proxy, DNS, Regeln, IPv4, IPv6, TLS und Server. Er nennt die Schicht, die fehlgeschlagen ist.

    kilobat why https://registry.npmjs.org/
  2. Diese Kilobat-Prüfungen sind kostenlos. KI-Agenten führen sie über MCP mit diagnose_connection und diagnose_network aus. Siehe Herausfinden, warum eine Website oder API keine Verbindung bekommt.

Fragen

Ist ENOTFOUND dasselbe wie EAI_AGAIN?

Nein. EAI_AGAIN meldet eine vorübergehend fehlgeschlagene Abfrage. Siehe EAI_AGAIN auf dem Mac.

Ist mein Paketname falsch?

Selten. ENOTFOUND betrifft einen Hostnamen, keinen Paketnamen.

Quellen

Geprüft am 29. Oktober 2026.