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 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일 확인했습니다.