---
title: "« npm error code ENOTFOUND » sur Mac · Guides Kilobat"
url: "https://kilobat.app/fr/guides/npm-enotfound"
description: "npm install s’arrête sur votre Mac avec npm error code ENOTFOUND. Le nom du registre ne s’est pas résolu. Vérifiez le DNS, le réglage du registre, un VPN et un proxy."
---

# « 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 agent**Copie 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](https://kilobat.app/fr/guides/dns-server-not-found).
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](https://kilobat.app/fr/guides/flush-dns-cache-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](https://kilobat.app/fr/guides/recipes/why-cant-it-connect).

## Questions

**ENOTFOUND est-il identique à EAI_AGAIN ?**

Non. EAI_AGAIN signale un échec temporaire de résolution. Voir [EAI_AGAIN sur Mac](https://kilobat.app/fr/guides/eai-again).

**Le nom de mon paquet est-il faux ?**

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

## Sources

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

Vérifié le 29 octobre 2026.

## Guides associés

- [« npm error code ECONNRESET » sur Mac](https://kilobat.app/fr/guides/npm-econnreset): ECONNRESET indique qu’une connexion a été réinitialisée de force.
- [« npm error code ETIMEDOUT » sur Mac](https://kilobat.app/fr/guides/npm-etimedout): ETIMEDOUT signifie que l’autre côté n’a pas répondu à temps.
- [EAI_AGAIN sur Mac](https://kilobat.app/fr/guides/eai-again): EAI_AGAIN indique qu’un nom n’a pas pu être résolu à cet instant.
- [« curl: (6) Could not resolve host » sur Mac](https://kilobat.app/fr/guides/curl-could-not-resolve-host): Le code de sortie 6 de curl signifie que curl n’a pas pu obtenir d’adresse pour le nom d’hôte.
