Macの“npm error code ECONNREFUSED”

ECONNREFUSEDは、接続が拒否されたことを示します。Node.jsのドキュメントには、“No connection could be made because the target machine actively refused it.”と書かれています。

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

私のMacでこの問題が起きています:Macの“npm error code ECONNREFUSED”。https://kilobat.app/ja/guides/npm-econnrefused.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 ECONNREFUSEDで止まります。
  • 次の行に、127.0.0.1:8080のようなアドレスとポートが表示されます。
  • プロキシやレジストリの設定のあとによく起こります。

考えられる原因

  • どこにもつながっていないプロキシ設定。127.0.0.1や別のホストのプロキシが設定されていますが、そこでプロキシが動いていません。
  • オフになっているローカルのレジストリ。ローカルのミラーやキャッシュが停止しています。
  • 非アクティブなサービス。Node.jsのドキュメントには、これは通常、リモートホストでサービスが非アクティブなために起こると書かれています。
  • ローカルサーバを呼び出すスクリプト。テストやビルドの手順が、まだ起動していないサーバを呼び出すことがあります。

確認方法

  1. エラーに表示されているアドレスとポートを読みます。

  2. npmのプロキシとレジストリを表示します。

    npm config get proxy
    npm config get https-proxy
    npm config get registry
  3. そのポートをテストします。

    nc -vz 127.0.0.1 8080
  4. プロキシ環境変数を表示します。

    env | grep -i proxy

解決方法

  1. 不要なプロキシ設定を削除します。

    npm config delete proxy
    npm config delete https-proxy
  2. アドレスが指しているローカルのレジストリまたはサーバを起動します。

  3. 誤ったプロキシ変数の設定を解除します。

    unset https_proxy http_proxy
  4. インストールをやり直します。

よくある質問

ECONNREFUSEDはECONNRESETと同じですか?

いいえ。ECONNREFUSEDは、最初の段階での拒否です。ECONNRESETは、開いている接続を閉じます。Macの“npm error code ECONNRESET”をご覧ください。

127.0.0.1が表示されるのはなぜですか?

npmがローカルのアドレスを試しました。たいていは、プロキシやレジストリの設定が原因です。

出典

2026年10月29日に確認。