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 installが表示される、またはスクリプトがnpm error code ECONNREFUSEDで止まります。- 次の行に、
127.0.0.1:8080のようなアドレスとポートが表示されます。 - プロキシやレジストリの設定のあとによく起こります。
考えられる原因
- どこにもつながっていないプロキシ設定。
127.0.0.1や別のホストのプロキシが設定されていますが、そこでプロキシが動いていません。 - オフになっているローカルのレジストリ。ローカルのミラーやキャッシュが停止しています。
- 非アクティブなサービス。Node.jsのドキュメントには、これは通常、リモートホストでサービスが非アクティブなために起こると書かれています。
- ローカルサーバを呼び出すスクリプト。テストやビルドの手順が、まだ起動していないサーバを呼び出すことがあります。
確認方法
エラーに表示されているアドレスとポートを読みます。
npmのプロキシとレジストリを表示します。
npm config get proxy npm config get https-proxy npm config get registryそのポートをテストします。
nc -vz 127.0.0.1 8080プロキシ環境変数を表示します。
env | grep -i proxy
解決方法
不要なプロキシ設定を削除します。
npm config delete proxy npm config delete https-proxyアドレスが指しているローカルのレジストリまたはサーバを起動します。
誤ったプロキシ変数の設定を解除します。
unset https_proxy http_proxyインストールをやり直します。
よくある質問
ECONNREFUSEDはECONNRESETと同じですか?
いいえ。ECONNREFUSEDは、最初の段階での拒否です。ECONNRESETは、開いている接続を閉じます。Macの“npm error code ECONNRESET”をご覧ください。
127.0.0.1が表示されるのはなぜですか?
npmがローカルのアドレスを試しました。たいていは、プロキシやレジストリの設定が原因です。
出典
2026年10月29日に確認。