« npm error code ENOTFOUND » sur Mac

ENOTFOUND signale l’échec d’une résolution DNS. La documentation de Node.js l’appelle « DNS lookup failed », un échec de EAI_NODATA ou de EAI_NONAME.

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 ENOTFOUND » sur Mac. Lis https://kilobat.app/fr/guides/npm-enotfound.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 s’arrête avec npm error code ENOTFOUND.
  • La ligne suivante nomme un hôte, comme registry.npmjs.org.
  • Les navigateurs peuvent fonctionner.

Causes probables

  • Pas de connexion ou de DNS. Le Mac ne peut pas joindre un serveur DNS.
  • Un registre incorrect. Le réglage du registre npm nomme un hôte qui n’existe pas ou qui exige un VPN.
  • Un VPN avec son propre DNS. Les registres d’entreprise ne se résolvent que lorsque le VPN est actif.
  • Un proxy que npm n’utilise pas. Sur les réseaux qui n’autorisent que le proxy, npm a besoin des réglages de proxy.

Comment vérifier

  1. Affichez le registre qu’utilise npm.

    npm config get registry
  2. Résolvez le nom d’hôte via macOS.

    dscacheutil -q host -a name registry.npmjs.org
  3. Interrogez directement le registre.

    npm ping
  4. Affichez les réglages de proxy.

    npm config get https-proxy

Comment corriger

  1. Si la résolution via macOS échoue, réparez le DNS. Voir Le DNS ne résout pas les noms sur Mac.

  2. Corrigez le registre.

    npm config set registry https://registry.npmjs.org/
  3. Connectez le VPN pour un registre d’entreprise.

  4. Videz le cache DNS. Consultez Vider le cache DNS sur un Mac.

Avec Kilobat

  1. Le diagnostic de connexion de Kilobat teste l’adresse couche par couche : réseau, proxy, DNS, règles, IPv4, IPv6, TLS et serveur. Il nomme la couche qui a échoué.

    kilobat why https://registry.npmjs.org/
  2. Ces vérifications Kilobat sont gratuites. Les agents IA les lancent via MCP avec diagnose_connection et diagnose_network. Consultez Trouver pourquoi un site ou une API ne se connecte pas.

Questions

ENOTFOUND est-il identique à EAI_AGAIN ?

Non. EAI_AGAIN signale un échec temporaire de résolution. Voir EAI_AGAIN sur Mac.

Le nom de mon paquet est-il faux ?

Rarement. ENOTFOUND concerne un nom d’hôte, pas un nom de paquet.

Sources

Vérifié le 29 octobre 2026.