Mac의 “Unable to connect to API: SSL certificate verification failed”
Claude Code는 신뢰하지 않는 인증 기관의 인증서를 받으면 이 메시지를 출력합니다. 문서는 TLS를 검사하는 기업 프록시나 사설 CA를 쓰는 게이트웨이를 원인으로 꼽습니다.
제 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 점검은 직접 실행하고, 알아낸 내용을 알려 주세요. 저만 할 수 있는 단계는 목록으로 정리해 주세요. 설정을 바꾸기 전에는 먼저 물어봐 주세요.
증상
- 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 파일을 읽지 못하면 경고합니다.
- 잘못된 시계. 날짜가 크게 어긋나면 인증서 확인이 실패합니다.
확인 방법
발급자를 확인하세요.
curl -v -o /dev/null https://api.anthropic.com 2>&1 | grep -i issuer변수를 표시하세요.
echo $NODE_EXTRA_CA_CERTS디버그 로깅으로 Claude Code를 시작한 다음 로그에서 CA 줄을 읽으세요.
claude --debug날짜를 확인하세요.
date
해결 방법
관리자에게 PEM 형식의 CA 번들을 받으세요.
실행하기 전에 Claude Code가 이 번들을 가리키게 하세요.
export NODE_EXTRA_CA_CERTS=/path/to/ca-bundle.pem또는 문서에 나온 대로 macOS 시스템 인증서 저장소에 CA를 추가하세요.
NODE_TLS_REJECT_UNAUTHORIZED=0를 설정하지 마세요. 검증이 꺼집니다.
Kilobat 사용
Kilobat의 연결 진단은 API 호스트를 계층별로 테스트합니다. TLS 계층에서 인증서에 누가 서명했는지 알 수 있습니다.
kilobat why https://api.anthropic.com이 Kilobat 검사는 무료입니다. AI 에이전트는 MCP를 통해
diagnose_connection및diagnose_network(으)로 실행합니다. 특정 사이트나 API에 연결되지 않는 이유 찾기를 참조하세요.
질문
Claude Code는 macOS 인증서 저장소를 사용하나요?
기본적으로 내장된 Mozilla CA와 운영체제 저장소를 신뢰합니다. 네이티브 설치는 항상 시스템 저장소를 읽습니다.
검증을 끌 수 있나요?
문서에서는 NODE_TLS_REJECT_UNAUTHORIZED=0을 설정하지 말라고 합니다.
출처
2026년 10월 29일 확인했습니다.