---
title: "Mac의 “UNABLE_TO_GET_ISSUER_CERT_LOCALLY” · Kilobat 가이드"
url: "https://kilobat.app/ko/guides/npm-unable-to-get-issuer-cert-locally"
description: "Mac의 Node.js나 npm이 UNABLE_TO_GET_ISSUER_CERT_LOCALLY로 멈춥니다. 인증서 발급자를 알 수 없습니다. 확인을 끄지 말고 올바른 CA 파일을 추가하세요."
---

# Mac의 “UNABLE_TO_GET_ISSUER_CERT_LOCALLY”

UNABLE_TO_GET_ISSUER_CERT_LOCALLY는 Node.js가 인증서에 서명한 인증 기관을 찾지 못한다는 뜻입니다. TLS를 검사하는 프록시나 사설 인증 기관이 흔한 원인입니다.

**에이전트로 해결하기**Claude Code, Codex 또는 터미널을 쓸 수 있는 에이전트용 프롬프트를 복사합니다.

제 Mac에 이런 문제가 있습니다: Mac의 “UNABLE_TO_GET_ISSUER_CERT_LOCALLY”. https://kilobat.app/ko/guides/npm-unable-to-get-issuer-cert-locally.md을(를) 읽고 저와 함께 해결해 주세요. Kilobat CLI가 없으면 설치해 주세요: brew install seifip/kilobat/kilobat. 가이드의 터미널 및 kilobat 점검은 직접 실행하고, 알아낸 내용을 알려 주세요. 저만 할 수 있는 단계는 목록으로 정리해 주세요. 설정을 바꾸기 전에는 먼저 물어봐 주세요.

적용 대상: 현재의 모든 macOS 버전의 Node.js, npm 및 Node.js 기반 도구. · 확인일: 2026년 10월 29일

## 증상

- Node.js 도구가 `UNABLE_TO_GET_ISSUER_CERT_LOCALLY`로 멈춥니다.
- 메시지에 `unable to get local issuer certificate`가 나올 수 있습니다.
- 브라우저에서는 같은 사이트가 열릴 수 있습니다.

## 가능한 원인

- **TLS를 검사하는 프록시.** 회사 프록시가 자체 인증서로 트래픽에 서명합니다. [Mac에서 기업 프록시 인증서가 터미널 도구를 깨뜨릴 때](https://kilobat.app/ko/guides/corporate-proxy-certificates)를 참고하세요.
- **사설 인증 기관.** 회사 레지스트리나 게이트웨이가 Node.js가 모르는 인증 기관의 인증서를 사용합니다.
- **HTTPS를 검사하는 보안 앱.** Node.js가 기본적으로 사용하지 않는 자체 루트를 추가합니다.
- **누락된 중간 인증서.** 서버가 인증서 체인의 일부를 빠뜨렸을 수 있습니다.

## 확인 방법

1. 발급자를 확인하세요.

   ```
   curl -v -o /dev/null https://registry.npmjs.org/ 2>&1 | grep -i issuer
   ```
2. npm이 사용하는 CA 파일을 표시하세요.

   ```
   npm config get cafile
   ```
3. Node.js CA 변수를 표시하세요.

   ```
   echo $NODE_EXTRA_CA_CERTS
   ```
4. 휴대폰 핫스팟을 사용해 보세요.

## 해결 방법

1. 네트워크 관리자에게 PEM 형식의 CA 인증서를 받으세요.
2. 이 셸에서 Node.js가 해당 인증서를 신뢰하도록 지정하세요.

   ```
   export NODE_EXTRA_CA_CERTS=/path/to/ca.pem
   ```
3. npm에도 같은 파일을 설정하세요.

   ```
   npm config set cafile /path/to/ca.pem
   ```
4. `NODE_TLS_REJECT_UNAUTHORIZED=0`를 설정하지 마세요. 모든 확인이 꺼집니다.

## Kilobat 사용

1. Kilobat의 연결 진단은 호스트를 계층별로 테스트합니다. TLS 계층에서 이 Mac이 신뢰하지 않는 인증서를 확인할 수 있습니다.

   ```
   kilobat why https://registry.npmjs.org/
   ```
2. 이 Kilobat 검사는 무료입니다. AI 에이전트는 MCP를 통해 `diagnose_connection` 및 `diagnose_network`(으)로 실행합니다. [특정 사이트나 API에 연결되지 않는 이유 찾기](https://kilobat.app/ko/guides/recipes/why-cant-it-connect)를 참조하세요.

## 질문

**브라우저에서는 되는 이유는 무엇인가요?**

macOS는 관리자가 설치한 인증서를 신뢰합니다. Node.js는 파일을 추가하지 않는 한 자체 목록을 사용합니다.

**NODE_TLS_REJECT_UNAUTHORIZED=0으로 설정하면 해결되나요?**

아니요. 모든 연결에서 인증서 검증이 꺼집니다. 대신 CA를 추가하세요.

## 출처

- [npm 문서: 흔한 오류](https://docs.npmjs.com/common-errors)
- [Claude Code: 기업 네트워크 구성](https://code.claude.com/docs/en/network-config.md)

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

## 관련 가이드

- [Mac npm의 “SELF_SIGNED_CERT_IN_CHAIN”](https://kilobat.app/ko/guides/npm-self-signed-cert-in-chain): SELF_SIGNED_CERT_IN_CHAIN은 인증서 체인에 알려진 인증 기관이 서명하지 않은 인증서가 들어 있다는 뜻입니다.
- [회사 프록시 인증서로 인해 Mac의 터미널 도구가 작동하지 않음](https://kilobat.app/ko/guides/corporate-proxy-certificates): 일부 회사 네트워크는 HTTPS 트래픽을 검사합니다.
- [Mac의 “curl: (60) SSL certificate problem”](https://kilobat.app/ko/guides/curl-60-ssl-certificate-problem): curl 종료 코드 60은 한 단계가 실패했음을 알립니다.
- [Mac에서 “npm error code ECONNRESET”](https://kilobat.app/ko/guides/npm-econnreset): ECONNRESET은 강제로 재설정된 연결을 나타냅니다.
