---
title: "Mac의 “npm error code ECONNREFUSED” · Kilobat 가이드"
url: "https://kilobat.app/ko/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/ko/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/ko/guides/npm-econnreset)을 참고하세요.

**왜 127.0.0.1이 나오나요?**

npm이 보통 프록시나 레지스트리 설정에서 가져온 로컬 주소를 시도했습니다.

## 출처

- [Node.js 문서: 일반적인 시스템 오류](https://nodejs.org/api/errors.html#common-system-errors)
- [npm 문서: 흔한 오류](https://docs.npmjs.com/common-errors)

2026년 10월 29일 확인했습니다.

## 관련 가이드

- [Mac에서 “npm error code ECONNRESET”](https://kilobat.app/ko/guides/npm-econnreset): ECONNRESET은 강제로 재설정된 연결을 나타냅니다.
- [Mac의 “npm error code ENOTFOUND”](https://kilobat.app/ko/guides/npm-enotfound): ENOTFOUND는 DNS 조회 실패를 알립니다.
- [Mac의 Chrome에서 ERR_CONNECTION_REFUSED](https://kilobat.app/ko/guides/err-connection-refused): Chrome의 네트워크 오류 ERR_CONNECTION_REFUSED입니다.
- [프록시 설정으로 인해 Mac에서 앱이 연결되지 않습니다](https://kilobat.app/ko/guides/proxy-settings-breaking-apps): 프록시 설정은 다른 서버를 통해 트래픽을 전송합니다.
