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が名前解決されないをご覧ください。

  2. レジストリを修正します。

    npm config set registry https://registry.npmjs.org/
  3. 社内のレジストリには、VPNを接続します。

  4. DNSキャッシュを消去します。MacでDNSキャッシュを消去するを参照してください。

Kilobatを使う場合

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

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

よくある質問

ENOTFOUNDはEAI_AGAINと同じですか?

いいえ。EAI_AGAINは、一時的な名前検索の失敗を示します。MacのEAI_AGAINをご覧ください。

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

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

出典

2026年10月29日に確認。