«npm error code ENOTFOUND» на Mac

ENOTFOUND сообщает о неудачном поиске DNS. В документации Node.js он назван «DNS lookup failed», сбоем EAI_NODATA или EAI_NONAME.

Решите это с помощью агентаКопирует промпт для Claude Code, Codex или любого агента, который умеет работать с Терминалом.

У моего Mac такая проблема: «npm error code ENOTFOUND» на Mac. Прочитай https://kilobat.app/ru/guides/npm-enotfound.md и разберись с ней вместе со мной. Если Kilobat CLI не установлен, установи его: brew install seifip/kilobat/kilobat. Проверки в Терминале и через kilobat из руководства выполни сам и расскажи, что нашёл. Составь список шагов, которые могу сделать только я. Перед изменением любой настройки спрашивай меня.

Относится к: npm 10 и новее выводит «npm error». Старые версии выводят «npm ERR!». Node.js во всех актуальных версиях macOS.Проверено: 29 октября 2026 г.

Симптомы

  • npm install завершается с npm error code ENOTFOUND.
  • Следующая строка называет хост, например registry.npmjs.org.
  • Браузеры могут работать.

Вероятные причины

  • Нет соединения или DNS. Mac не может связаться с сервером DNS.
  • Неверный реестр. В настройке реестра npm указан хост, которого не существует или которому нужен VPN.
  • VPN со своим DNS. Корпоративные реестры разрешаются только при включённом VPN.
  • Прокси, который npm не использует. В сетях только с прокси npm нужны настройки прокси.

Как проверить

  1. Покажите реестр, который использует npm.

    npm config get registry
  2. Разрешите имя хоста средствами macOS.

    dscacheutil -q host -a name registry.npmjs.org
  3. Спросите реестр напрямую.

    npm ping
  4. Покажите настройки прокси.

    npm config get https-proxy

Как исправить

  1. Если поиск через macOS не удаётся, исправьте DNS. Смотрите DNS не разрешает имена на Mac.

  2. Исправьте реестр.

    npm config set registry https://registry.npmjs.org/
  3. Для корпоративного реестра подключите VPN.

  4. Очистите кэш DNS. См. Очистка кэша DNS на Mac.

С Kilobat

  1. Диагностика подключения в Kilobat проверяет адрес уровень за уровнем: сеть, прокси, DNS, правила, IPv4, IPv6, TLS и сервер. Она называет уровень, на котором произошёл сбой.

    kilobat why https://registry.npmjs.org/
  2. Эти проверки Kilobat бесплатны. ИИ-агенты запускают их через MCP с помощью diagnose_connection и diagnose_network. См. Почему не подключается один сайт или API.

Вопросы

ENOTFOUND — то же, что EAI_AGAIN?

Нет. EAI_AGAIN сообщает о временном сбое поиска. Смотрите EAI_AGAIN на Mac.

Неверно ли имя моего пакета?

Редко. ENOTFOUND касается имени хоста, а не имени пакета.

Источники

Проверено 29 октября 2026 года.