---
title: "Macの“npm error code ECONNREFUSED” · Kilobatガイド"
url: "https://kilobat.app/ja/guides/npm-econnrefused"
description: "Macのnpm installが、npm error code ECONNREFUSEDで止まります。ホストが接続を拒否しました。レジストリ、プロキシ、ローカルのサービスを確認してください。"
---

# 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”](https://kilobat.app/ja/guides/npm-econnreset)をご覧ください。

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

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

## 出典

- [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 ENOTFOUND”](https://kilobat.app/ja/guides/npm-enotfound): ENOTFOUNDは、DNSの名前解決の失敗を示します。
- [MacのChromeでのERR_CONNECTION_REFUSED](https://kilobat.app/ja/guides/err-connection-refused): ERR_CONNECTION_REFUSEDは、Chromeのネットワークエラーです。
- [Macでプロキシ設定のせいでアプリが接続できない](https://kilobat.app/ja/guides/proxy-settings-breaking-apps): プロキシ設定は、通信を別のサーバ経由で送ります。
