---
title: "Mac의 “Unable to connect to API: SSL certificate verification failed” · Kilobat 가이드"
url: "https://kilobat.app/ko/guides/claude-code-ssl-certificate-verification-failed"
description: "Mac의 Claude Code가 SSL certificate verification failed를 보고합니다. 프록시나 사설 CA가 트래픽에 서명합니다. NODE_EXTRA_CA_CERTS로 해당 CA를 추가하세요."
---

# Mac의 “Unable to connect to API: SSL certificate verification failed”

Claude Code는 신뢰하지 않는 인증 기관의 인증서를 받으면 이 메시지를 출력합니다. 문서는 TLS를 검사하는 기업 프록시나 사설 CA를 쓰는 게이트웨이를 원인으로 꼽습니다.

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

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

적용 대상: 현재의 모든 macOS 버전의 터미널에서 실행하는 Claude Code. · 확인일: 2026년 10월 29일

## 증상

- Claude Code가 `Unable to connect to API: SSL certificate verification failed`를 출력합니다.
- 코드가 UNABLE_TO_GET_ISSUER_CERT_LOCALLY로 표시되거나, 문구에 self-signed certificate라고 나옵니다.
- 회사 네트워크에서 시작됩니다.

## 가능한 원인

- **TLS를 검사하는 프록시.** 프록시나 보안 장비가 자체 인증서로 TLS 트래픽을 가로챕니다.
- **사설 CA를 쓰는 게이트웨이.** LLM 게이트웨이가 사설 인증 기관의 인증서를 사용할 수 있습니다.
- **불러오지 못하는 CA 파일.** Claude Code는 NODE_EXTRA_CA_CERTS 파일을 읽지 못하면 경고합니다.
- **잘못된 시계.** 날짜가 크게 어긋나면 인증서 확인이 실패합니다.

## 확인 방법

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

   ```
   curl -v -o /dev/null https://api.anthropic.com 2>&1 | grep -i issuer
   ```
2. 변수를 표시하세요.

   ```
   echo $NODE_EXTRA_CA_CERTS
   ```
3. 디버그 로깅으로 Claude Code를 시작한 다음 로그에서 CA 줄을 읽으세요.

   ```
   claude --debug
   ```
4. 날짜를 확인하세요.

   ```
   date
   ```

## 해결 방법

1. 관리자에게 PEM 형식의 CA 번들을 받으세요.
2. 실행하기 전에 Claude Code가 이 번들을 가리키게 하세요.

   ```
   export NODE_EXTRA_CA_CERTS=/path/to/ca-bundle.pem
   ```
3. 또는 문서에 나온 대로 macOS 시스템 인증서 저장소에 CA를 추가하세요.
4. `NODE_TLS_REJECT_UNAUTHORIZED=0`를 설정하지 마세요. 검증이 꺼집니다.

## Kilobat 사용

1. Kilobat의 연결 진단은 API 호스트를 계층별로 테스트합니다. TLS 계층에서 인증서에 누가 서명했는지 알 수 있습니다.

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

## 질문

**Claude Code는 macOS 인증서 저장소를 사용하나요?**

기본적으로 내장된 Mozilla CA와 운영체제 저장소를 신뢰합니다. 네이티브 설치는 항상 시스템 저장소를 읽습니다.

**검증을 끌 수 있나요?**

문서에서는 NODE_TLS_REJECT_UNAUTHORIZED=0을 설정하지 말라고 합니다.

## 출처

- [Claude Code: 오류 참고](https://code.claude.com/docs/en/errors.md)
- [Claude Code: 기업 네트워크 구성](https://code.claude.com/docs/en/network-config.md)

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

## 관련 가이드

- [Mac Claude Code의 “Unable to connect to API”](https://kilobat.app/ko/guides/claude-code-unable-to-connect-to-api): Claude Code는 요청이 api.anthropic.com에 도달하지 못하면 Unable to connect to API를 출력합니다.
- [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의 “curl: (60) SSL certificate problem”](https://kilobat.app/ko/guides/curl-60-ssl-certificate-problem): curl 종료 코드 60은 한 단계가 실패했음을 알립니다.
