---
title: "Macの“npm error code ENOTFOUND” · Kilobatガイド"
url: "https://kilobat.app/ja/guides/npm-enotfound"
description: "Macのnpm installが、npm error code ENOTFOUNDで止まります。レジストリ名が解決されませんでした。DNS、レジストリの設定、VPN、プロキシを確認してください。"
---

# Macの“npm error code ENOTFOUND”

ENOTFOUNDは、DNSの名前解決の失敗を示します。Node.jsのドキュメントでは、“DNS lookup failed”と呼ばれ、EAI_NODATAまたはEAI_NONAMEのいずれかの失敗です。

**エージェントで解決する**Claude Code、Codex、またはターミナルを使えるエージェント向けのプロンプトをコピーします。

私のMacでこの問題が起きています：Macの“npm error code ENOTFOUND”。https://kilobat.app/ja/guides/npm-enotfound.mdを読んで、一緒に進めてください。Kilobat CLIがなければインストールしてください：brew install seifip/kilobat/kilobat。ガイドにあるターミナルとkilobatのチェックはあなた自身で実行し、わかったことを教えてください。私にしかできない手順は一覧にしてください。設定を変更する前に必ず確認してください。

対象：npm 10以降は“npm error”と出力します。古いバージョンは“npm ERR!”と出力します。現在のすべてのmacOS上のNode.js。 · 確認日：2026年10月29日

## 症状

- `npm install`が`npm error code ENOTFOUND`で止まる。
- 次の行に、`registry.npmjs.org`のようなホストが表示されます。
- ブラウザでは動くことがあります。

## 考えられる原因

- **接続またはDNSがない。**MacがDNSサーバに到達できません。
- **レジストリの誤り。**npmのレジストリ設定が、存在しないホスト、またはVPNが必要なホストを指しています。
- **独自のDNSを持つVPN。**社内のレジストリは、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を修正します。[MacでDNSが名前解決されない](https://kilobat.app/ja/guides/dns-server-not-found)をご覧ください。
2. レジストリを修正します。

   ```
   npm config set registry https://registry.npmjs.org/
   ```
3. 社内のレジストリには、VPNを接続します。
4. DNSキャッシュを消去します。[MacでDNSキャッシュを消去する](https://kilobat.app/ja/guides/flush-dns-cache-mac)を参照してください。

## Kilobatを使う場合

1. Kilobatの接続ドクターは、アドレスを層ごとにテストします。ネットワーク、プロキシ、DNS、ルール、IPv4、IPv6、TLS、サーバの順です。失敗した層を示します。

   ```
   kilobat why https://registry.npmjs.org/
   ```
2. これらのKilobatのチェックは無料です。AIエージェントはMCPを通じて`diagnose_connection`と`diagnose_network`で実行します。[1つのサイトやAPIに接続できない原因を見つける](https://kilobat.app/ja/guides/recipes/why-cant-it-connect)を参照してください。

## よくある質問

**ENOTFOUNDはEAI_AGAINと同じですか？**

いいえ。EAI_AGAINは、一時的な名前検索の失敗を示します。[MacのEAI_AGAIN](https://kilobat.app/ja/guides/eai-again)をご覧ください。

**パッケージ名が間違っているのですか？**

まれです。ENOTFOUNDはホスト名に関するもので、パッケージ名ではありません。

## 出典

- [Node.jsドキュメント：一般的なシステムエラー](https://nodejs.org/api/errors.html#common-system-errors)
- [npm Docs: Common errors](https://docs.npmjs.com/common-errors)

2026年10月29日に確認。

## 関連ガイド

- [Macで「npm error code ECONNRESET」と表示される](https://kilobat.app/ja/guides/npm-econnreset): ECONNRESETは接続が強制的にリセットされたことを示します。
- [Macで「npm error code ETIMEDOUT」と表示される](https://kilobat.app/ja/guides/npm-etimedout): ETIMEDOUTは、相手側が時間内に応答しなかったことを示します。
- [MacでEAI_AGAINが表示される](https://kilobat.app/ja/guides/eai-again): EAI_AGAINは現時点で名前を解決できなかったことを示します。
- [Macで「curl: (6) Could not resolve host」と表示される](https://kilobat.app/ja/guides/curl-could-not-resolve-host): curlの終了コード6は、curlがホスト名のアドレスを取得できなかったことを示します。
