---
title: "„npm error code ENOTFOUND“ auf dem Mac · Kilobat Anleitungen"
url: "https://kilobat.app/de/guides/npm-enotfound"
description: "npm install auf deinem Mac bricht mit „npm error code ENOTFOUND“ ab. Der Registry-Name wurde nicht aufgelöst. Prüfe DNS, die Registry-Einstellung, ein VPN und einen Proxy."
---

# “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 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 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](https://kilobat.app/de/guides/dns-server-not-found).
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](https://kilobat.app/de/guides/flush-dns-cache-mac).

## 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](https://kilobat.app/de/guides/recipes/why-cant-it-connect).

## Fragen

**Ist ENOTFOUND dasselbe wie EAI_AGAIN?**

Nein. EAI_AGAIN meldet eine vorübergehend fehlgeschlagene Abfrage. Siehe [EAI_AGAIN auf dem Mac](https://kilobat.app/de/guides/eai-again).

**Ist mein Paketname falsch?**

Selten. ENOTFOUND betrifft einen Hostnamen, keinen Paketnamen.

## 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 ETIMEDOUT“ auf dem Mac](https://kilobat.app/de/guides/npm-etimedout): ETIMEDOUT bedeutet, dass die Gegenseite nicht rechtzeitig geantwortet hat.
- [EAI_AGAIN auf dem Mac](https://kilobat.app/de/guides/eai-again): EAI_AGAIN bedeutet, dass ein Name derzeit nicht aufgelöst werden konnte.
- [„curl: (6) Could not resolve host“ auf dem Mac](https://kilobat.app/de/guides/curl-could-not-resolve-host): curl-Exit-Code 6 bedeutet, dass curl keine Adresse für den Hostnamen ermitteln konnte.
