---
title: "«npm error code ENOTFOUND» на Mac · Руководства Kilobat"
url: "https://kilobat.app/ru/guides/npm-enotfound"
description: "npm install на вашем Mac останавливается с npm error code ENOTFOUND. Имя реестра не разрешилось. Проверьте DNS, настройку реестра, VPN и прокси."
---

# «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](https://kilobat.app/ru/guides/dns-server-not-found).
2. Исправьте реестр.

   ```
   npm config set registry https://registry.npmjs.org/
   ```
3. Для корпоративного реестра подключите VPN.
4. Очистите кэш DNS. См. [Очистка кэша DNS на Mac](https://kilobat.app/ru/guides/flush-dns-cache-mac).

## С Kilobat

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

   ```
   kilobat why https://registry.npmjs.org/
   ```
2. Эти проверки Kilobat бесплатны. ИИ-агенты запускают их через MCP с помощью `diagnose_connection` и `diagnose_network`. См. [Почему не подключается один сайт или API](https://kilobat.app/ru/guides/recipes/why-cant-it-connect).

## Вопросы

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

Нет. EAI_AGAIN сообщает о временном сбое поиска. Смотрите [EAI_AGAIN на Mac](https://kilobat.app/ru/guides/eai-again).

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

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

## Источники

- [Документация Node.js: Common system errors](https://nodejs.org/api/errors.html#common-system-errors)
- [Документация npm: Common errors](https://docs.npmjs.com/common-errors)

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

## Похожие руководства

- [«npm error code ECONNRESET» на Mac](https://kilobat.app/ru/guides/npm-econnreset): ECONNRESET сообщает о принудительном сбросе соединения.
- [«npm error code ETIMEDOUT» на Mac](https://kilobat.app/ru/guides/npm-etimedout): ETIMEDOUT означает, что другая сторона не ответила вовремя.
- [EAI_AGAIN на Mac](https://kilobat.app/ru/guides/eai-again): EAI_AGAIN указывает, что имя сейчас не удалось разрешить.
- [“curl: (6) Could not resolve host” на Mac](https://kilobat.app/ru/guides/curl-could-not-resolve-host): Код выхода curl 6 означает, что curl не смог получить адрес для имени хоста.
