Source: https://swgbar.com/ko/guides/ai-coding-agents-claude-code-cursor-swg-macos/
Language: ko

# 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 · 업데이트 2026년 11월 19일

업무용 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](<https://swgbar.com/ko/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 검사](<https://swgbar.com/ko/guides/zscaler-ssl-inspection-bypass-mac/>), [Mac의 Netskope SSL 검사](<https://swgbar.com/ko/guides/netskope-ssl-inspection-bypass-mac/>), [Mac의 CLI 및 AI 도구 SWG TLS/SSL 인증서 오류 해결](<https://swgbar.com/ko/guides/swg-tls-certificate-errors-macos/>)에서도 확인할 수 있습니다.

### 옵션 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 우회하는 방법](<https://swgbar.com/ko/guides/how-to-bypass-swg/>)을 참고하세요.

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

macOS 14 이상(Apple Silicon)의 `/Applications/SWGBar.app`에 [SWG bar가 설치](<https://swgbar.com/ko/install/>)되어 실행 중인지 확인한 뒤, **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 가이드](<https://swgbar.com/ko/mcp/>)에서 확인하세요.

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

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

## 관련 가이드

*   [Mac에서 SWG 우회하는 방법 (원클릭 도메인 우회 및 CLI)](<https://swgbar.com/ko/guides/how-to-bypass-swg/>)
*   [Mac에서 SSL 검사 우회하는 방법(기업 SWG 도메인별 해결책)](<https://swgbar.com/ko/guides/bypass-ssl-inspection-mac/>)
*   [macOS에서 HTTPS 및 TLS 검사 우회하는 방법(Break-and-Inspect 가이드)](<https://swgbar.com/ko/guides/bypass-https-tls-inspection-mac/>)
*   [Mac에서 기업 프록시 및 SWG SSL 검사 우회하는 방법](<https://swgbar.com/ko/guides/bypass-corporate-proxy-ssl-inspection-mac/>)
*   [내 Mac이 SWG에 의해 가로채기되고 있는지 확인하는 방법(HTTPS 및 SSL 검사)](<https://swgbar.com/ko/guides/detect-https-inspection/>)
*   [회사나 업무용 Mac이 HTTPS를 가로채고 있는지 확인하는 방법(SSL 검사)](<https://swgbar.com/ko/guides/check-if-work-mac-intercepting-https/>)
*   [Mac용 SSL 검사 체커: HTTPS 가로채기를 감지하는 메뉴 막대 도구](<https://swgbar.com/ko/guides/ssl-inspection-checker-mac/>)
*   [Mac의 Zscaler SSL 검사: 도메인별 확인 및 우회 방법](<https://swgbar.com/ko/guides/zscaler-ssl-inspection-bypass-mac/>)
*   [Mac의 Netskope SSL 검사: 복호화 확인 및 도메인별 우회](<https://swgbar.com/ko/guides/netskope-ssl-inspection-bypass-mac/>)
*   [Mac의 Cloudflare WARP 및 Zero Trust TLS 검사: 감지 및 우회](<https://swgbar.com/ko/guides/cloudflare-warp-tls-inspection-mac/>)
*   [SWG bar에서 HTTPS 검사의 ‘확인됨’과 ‘의심됨’ 분류 이해하기](<https://swgbar.com/ko/guides/confirmed-vs-suspected-https-inspection/>)
*   [SWG bar에서 중간자(MITM) 루트 인증서 및 발급자 확인하기](<https://swgbar.com/ko/guides/inspect-mitm-root-certificates-macos/>)
*   [Mac의 기업용 SWG 및 MDM HTTPS 검사 원리](<https://swgbar.com/ko/guides/enterprise-swg-https-inspection-macos/>)
*   [SWG 우회와 TLS 검사 예외(Break-and-Inspect) 비교](<https://swgbar.com/ko/guides/swg-bypass-vs-tls-exception/>)
*   [Mac에서 멀티 도메인 웹 앱, SSO, CDN, API용 SWG 우회하기](<https://swgbar.com/ko/guides/multi-domain-sso-api-cdn-swg-bypass/>)
*   [Mac에서 SWG 우회 ‘복구 중’, ‘일시 중지’ 및 연결 오류 해결하기](<https://swgbar.com/ko/guides/troubleshoot-swg-bypass-recovering-paused-macos/>)
*   [macOS VPN 가상 인터페이스와 SWG HTTPS 검사 비교](<https://swgbar.com/ko/guides/macos-vpn-virtual-interface-vs-swg-inspection/>)
*   [인증서 피닝 및 mTLS 앱이 SWG 검사 환경에서 실패하는 이유](<https://swgbar.com/ko/guides/certificate-pinning-mtls-swg-inspection-macos/>)
*   [Mac의 CLI 및 AI 도구에서 발생하는 SWG TLS/SSL 인증서 오류 해결](<https://swgbar.com/ko/guides/swg-tls-certificate-errors-macos/>)
*   [Mac의 SWG 환경에서 Homebrew, Docker, Python, Node.js CA 신뢰 구성](<https://swgbar.com/ko/guides/homebrew-docker-python-node-ca-trust-swg-macos/>)
*   [Mac에서 openssl과 security verify-cert로 TLS 인증서 검증하기](<https://swgbar.com/ko/guides/verify-tls-certificates-openssl-security-verify-cert-macos/>)
*   [SWG bar 권한, 로컬 개인정보 보호 및 TLS 프로브 제한](<https://swgbar.com/ko/guides/macos-network-extension-privacy-probe-limits/>)
*   [SWG bar의 HTTPS 검사 원리](<https://swgbar.com/ko/how-it-works/>)
*   [Mac용 SWG bar 다운로드 및 설치(macOS 14+)](<https://swgbar.com/ko/install/>)
*   [SSL 및 HTTPS 검사를 감지하는 Chrome 확장 프로그램(SWG bar 연동)](<https://swgbar.com/ko/chrome-extension/>)
*   [SWG bar CLI 가이드](<https://swgbar.com/ko/cli/>)
*   [SWG bar MCP 가이드](<https://swgbar.com/ko/mcp/>)
*   [SWG bar 릴리스 정보](<https://swgbar.com/ko/releases/>)
*   [SWG bar 소개](<https://swgbar.com/ko/about/>)
