---
title: "Mac npm에서 “SELF_SIGNED_CERT_IN_CHAIN” · Kilobat 가이드"
url: "https://kilobat.app/ko/guides/npm-self-signed-cert-in-chain"
description: "Mac의 npm이 SELF_SIGNED_CERT_IN_CHAIN으로 멈춥니다. 프록시나 필터가 자체 인증서로 트래픽에 서명합니다. 확인을 끄지 말고 해당 인증서를 신뢰하세요."
---

# Mac npm의 “SELF_SIGNED_CERT_IN_CHAIN”

SELF_SIGNED_CERT_IN_CHAIN은 인증서 체인에 알려진 인증 기관이 서명하지 않은 인증서가 들어 있다는 뜻입니다. 회사 네트워크에서는 TLS를 검사하는 프록시가 흔한 원인입니다.

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

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

적용 대상: 현재의 모든 macOS 버전의 npm. 이 오류는 다른 Node.js 도구에서도 나타납니다. · 확인일: 2026년 10월 29일

## 증상

- `npm install`이(가) `npm error code SELF_SIGNED_CERT_IN_CHAIN` 메시지와 함께 중단됩니다.
- 메시지에 `self-signed certificate in certificate chain`라고 나옵니다.
- 회사 네트워크에서 시작되거나 보안 앱을 설치한 뒤에 시작됩니다.

## 가능한 원인

- **TLS를 검사하는 프록시.** 프록시가 레지스트리 인증서를 자체 인증서로 바꿉니다. [Mac에서 기업 프록시 인증서가 터미널 도구를 깨뜨릴 때](https://kilobat.app/ko/guides/corporate-proxy-certificates)를 참고하세요.
- **HTTPS를 검사하는 보안 앱.** 트래픽에 자체 루트를 추가할 수 있습니다.
- **오래된 npm.** npm 흔한 오류 페이지에 따르면 npm은 더 이상 이전의 자체 서명 인증서를 지원하지 않습니다.
- **사설 레지스트리.** 사설 인증 기관의 레지스트리에는 해당 기관의 인증서가 필요합니다.

## 확인 방법

1. 레지스트리 인증서의 발급자를 확인하세요.

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

   ```
   npm config get cafile
   ```
3. npm 버전을 확인하세요.

   ```
   npm --version
   ```
4. 휴대폰 핫스팟을 사용해 보세요. 되면 첫 번째 네트워크가 TLS를 검사하는 것입니다.

## 해결 방법

1. 네트워크 관리자에게 PEM 형식의 루트 인증서를 받으세요.
2. npm이 해당 인증서를 가리키게 하세요.

   ```
   npm config set cafile /path/to/ca.pem
   ```
3. npm이 오래되었다면 업데이트하세요.

   ```
   npm install npm -g
   ```
4. `strict-ssl`를 false로 설정하지 마세요. npm 문서는 권장하지 않습니다.

## 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)를 참조하세요.

## 질문

**npm config set strict-ssl false는 안전한가요?**

인증서 확인을 끕니다. npm 문서는 프록시 오류에는 권장하지 않습니다. 대신 프록시의 CA를 추가하세요.

**왜 회사에서만 오류가 나타나나요?**

TLS를 검사하는 프록시가 자체 인증서로 트래픽에 서명합니다. Mac이 이를 신뢰하지 않습니다.

## 출처

- [npm 문서: 흔한 오류](https://docs.npmjs.com/common-errors)

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

## 관련 가이드

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