Mac에서 Claude Code 및 Cursor의 'unable to get local issuer certificate' 오류 해결(SWG 및 MCP)

Zscaler, Netskope 등 기업 SWG 환경의 macOS에서 발생하는 Claude Code·Cursor unable to get local issuer certificate 오류 해결, SWG bar MCP 연동 및 도메인별 우회 안내.

SWG bar · 업데이트

업무용 Mac에서 Claude Code, Cursor, Windsurf, Claude Desktop을 실행할 때 unable to get local issuer certificate, UNABLE_TO_GET_ISSUER_CERT_LOCALLY, self-signed certificate in certificate chain, 또는 CERTIFICATE_VERIFY_FAILED 오류가 발생한다면 Zscaler, Netskope, Cloudflare Gateway 같은 기업 보안 웹 게이트웨이(SWG)가 SSL/HTTPS 검사를 수행하면서 Node.js 및 Electron 런타임이 기본으로 신뢰하지 않는 기업 루트 CA로 API 응답을 재서명하고 있기 때문입니다.

아래에서는 macOS에서 안전하게 해결하는 두 가지 방법(기업 CA 신뢰 구성 NODE_EXTRA_CA_CERTS / Cursor 시스템 인증서 설정, 또는 승인된 네트워크에서의 도메인별 SWG 우회)과 AI 코딩 에이전트가 검사 대상 도메인을 자동 진단하도록 SWG bar 내장 MCP 서버를 연결하는 방법을 정리했습니다.

1. 어떤 LLM·레지스트리 호스트 이름이 가로채기되는지 먼저 확인

셸 프로필이나 설정을 수정하기 전에 SWG bar → 도메인 또는 --json CLI를 사용해 정확히 어떤 호스트 이름(api.anthropic.com, api2.cursor.sh, registry.npmjs.org, OAuth 로그인 호스트, MCP 엔드포인트)이 재서명되고 있는지 확인하세요.

swgbar overview --json
swgbar domains list --status confirmed --json
swgbar probe api.anthropic.com --json
swgbar domains detail registry.npmjs.org --json

AI IDE는 모델 추론, 인증, 원격 측정, 확장 마켓플레이스에 각각 다른 호스트 이름을 사용하는 경우가 많으므로 보조 엔드포인트까지 꼼꼼히 확인하세요.

2. Claude Code 및 Cursor의 unable to get local issuer certificate 해결

TLS 검증을 전역으로 꺼서 신뢰할 수 없는 네트워크에 API 키를 노출하는 NODE_TLS_REJECT_UNAUTHORIZED=0 설정은 피하세요. 대신 아래 두 가지 안전한 방법 중 하나를 선택합니다.

옵션 A: 기업 루트 CA 신뢰 설정(SWG 복호화 유지)

키체인 접근에서 내보내거나 IT에서 받은 회사/Zscaler/Netskope 루트 CA PEM 파일(예: $HOME/.certs/corporate-ca.pem)을 각 도구에 설정합니다.

  • Claude Code(~/.zshrc 및 ~/.claude/settings.json):
export NODE_EXTRA_CA_CERTS="$HOME/.certs/corporate-ca.pem"
{
  "env": {
    "NODE_EXTRA_CA_CERTS": "/Users/<your-user>/.certs/corporate-ca.pem",
    "CLAUDE_CODE_CERT_STORE": "bundled,system"
  }
}
  • Cursor(Preferences: Open User Settings (JSON)): 시스템 인증서 옵션을 켜고(SWG 프록시가 스트리밍을 끊을 경우 HTTP/2 비활성화 추가), Cmd + Q로 Cursor를 완전히 종료한 뒤 터미널에서 다시 실행해 NODE_EXTRA_CA_CERTS를 상속받도록 합니다.
{
  "http.experimental.systemCertificatesV2": true,
  "cursor.general.disableHttp2": true
}

Zscaler, Netskope, Cloudflare별 CA 번들 명령은 Mac의 Zscaler SSL 검사, Mac의 Netskope SSL 검사, Mac의 CLI 및 AI 도구 SWG TLS/SSL 인증서 오류 해결에서도 확인할 수 있습니다.

옵션 B: 승인된 Mac에서 도메인별 SWG 우회 활성화

직접 관리하거나 구성 권한이 있는 네트워크에서 작업 중이고—특히 NODE_EXTRA_CA_CERTS 설정 후에도 HTTP/2 스트리밍이나 인증서 피닝이 깨진다면—SWG bar → 도메인 → SWG 우회 → 켜기 또는 터미널에서 해당 호스트 이름만 Mac의 물리적 하드웨어 IPv4 인터페이스로 우회할 수 있습니다.

swgbar bypass enable api.anthropic.com
swgbar bypass status --json
swgbar probe api.anthropic.com --json

우회 중이 표시된 뒤 기존 소켓이 새로 열리도록 Claude Code나 Cursor를 재시작하세요. 회사 방화벽이 직접 아웃바운드 연결을 막는다면 우회를 끄고(swgbar bypass disable <domain>) 옵션 A를 사용하거나 IT에 Do Not Decrypt 규칙을 요청하세요. 전체 설정과 재시작 동작은 Mac에서 SWG 우회하는 방법을 참고하세요.

3. SWG bar MCP를 Claude Code 또는 Cursor에 연결하기

macOS 14 이상(Apple Silicon)의 /Applications/SWGBar.app에 SWG bar가 설치되어 실행 중인지 확인한 뒤, Claude Code에서 한 줄로 로컬 stdio MCP 서버를 등록하세요.

claude mcp add swgbar -- /Applications/SWGBar.app/Contents/MacOS/swgbar mcp

또는 .cursor/mcp.json(Cursor)이나 claude_desktop_config.json(Claude Desktop)에 다음 블록을 추가합니다.

{
  "mcpServers": {
    "swgbar": {
      "command": "/Applications/SWGBar.app/Contents/MacOS/swgbar",
      "args": ["mcp"]
    }
  }
}

제공되는 모든 도구 영역(개요, 도메인, 인증서, SWG 우회, 온디맨드 프로브, 브라우저 확장, 앱 환경설정)은 전체 MCP 가이드에서 확인하세요.

로컬 근거의 개인정보 경계 유의

SWG bar MCP 서버는 Mac의 로컬 데이터베이스에 대해 stdio로만 로컬 동작하며 어떤 데이터도 SWG bar 클라우드 서버로 전송하지 않습니다. 다만 공개 버그 리포트에 회사 루트 CA 원본 정보나 내부 사설 호스트 이름을 붙여 넣지 않도록 주의하고, 진단 로그를 공유하기 전에 SWG bar 권한, 로컬 개인정보 및 프로브 한도를 확인하세요.