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

# 修復 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日

如果 **Claude Code**、**Cursor**、**Windsurf** 或 **Claude Desktop** 在你的工作 Mac 上出現 `unable to get local issuer certificate`、`UNABLE_TO_GET_ISSUER_CERT_LOCALLY`、`self-signed certificate in certificate chain` 或 `CERTIFICATE_VERIFY_FAILED` 錯誤，代表公司安全 Web 閘道（如 Zscaler、Netskope 或 Cloudflare Gateway）正執行 **SSL/HTTPS 檢查**，並以 Node.js 與 Electron 預設不信任的企業根憑證重簽 API 回應。

下文整理 macOS 上的兩種安全解法——設定企業 CA 信任（`NODE_EXTRA_CA_CERTS` / Cursor 系統憑證）或在經授權網路啟用單網域 SWG 繞過——並說明如何連線 SWG bar 內建的 **MCP 伺服器**，讓 AI 程式設計代理自動診斷受檢查的網域。

## 1\. 先確認哪些 LLM 或套件倉庫主機名稱遭攔截

修改 Shell 設定檔或編輯器設定前，先用 **SWG bar → 網域**或 `--json` [CLI](<https://swgbar.com/zh-TW/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`

請避免使用 `NODE_TLS_REJECT_UNAUTHORIZED=0`：這會全域停用 TLS 驗證，使 API 金鑰在不安全網路中面臨外洩風險。建議選擇以下兩種安全途徑之一：

### 方案 A：設定企業根憑證 CA 信任（維持 SWG 解密檢查）

從「鑰匙圈存取」匯出（或向 IT 取得）企業 / Zscaler / Netskope 根憑證的 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/zh-TW/guides/zscaler-ssl-inspection-bypass-mac/>)、[Mac 上的 Netskope SSL 檢查](<https://swgbar.com/zh-TW/guides/netskope-ssl-inspection-bypass-mac/>)與[修復 Mac 終端機 CLI 與 AI 工具中的 SWG TLS/SSL 憑證錯誤](<https://swgbar.com/zh-TW/guides/swg-tls-certificate-errors-macos/>)。

### 方案 B：在經授權的 Mac 上啟用單網域 SWG 繞過

若你在自行管理或經授權設定的網路上工作——尤其是設定 `NODE_EXTRA_CA_CERTS` 後 HTTP/2 串流或憑證固定依然失敗時——可透過 **SWG bar → 網域 → 繞過 SWG → 開啟**或在終端機將指定主機名稱改經實體**硬體網卡** 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/zh-TW/guides/how-to-bypass-swg/>)。

## 3\. 將 SWG bar MCP 連線至 Claude Code 或 Cursor

確認已在 macOS 14+（Apple 晶片）上將 [SWG bar 安裝](<https://swgbar.com/zh-TW/install/>)於 `/Applications/SWGBar.app` 並保持執行。在 **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/zh-TW/mcp/>)。

## 留意本機證據的隱私邊界

SWG bar 的 MCP 伺服器完全透過本機 stdio 存取你 Mac 上的本機資料庫，不會向 SWG bar 雲端伺服器傳送任何資料。但在公開回報錯誤時仍應避免貼上原始企業根憑證細節或內部私有主機名稱；分享診斷日誌前，建議先閱讀 [SWG bar 權限、本機隱私與探測上限](<https://swgbar.com/zh-TW/guides/macos-network-extension-privacy-probe-limits/>)。

## 延伸閱讀

*   [如何在 Mac 上繞過 SWG（單網域一鍵繞過與 CLI 指令）](<https://swgbar.com/zh-TW/guides/how-to-bypass-swg/>)
*   [如何在 Mac 上繞過 SSL 檢查（企業 SWG 單網域直連方案）](<https://swgbar.com/zh-TW/guides/bypass-ssl-inspection-mac/>)
*   [如何在 macOS 上繞過 HTTPS 與 TLS 檢查（Break-and-Inspect 指南）](<https://swgbar.com/zh-TW/guides/bypass-https-tls-inspection-mac/>)
*   [如何在 Mac 上繞過企業代理伺服器與 SWG SSL 檢查](<https://swgbar.com/zh-TW/guides/bypass-corporate-proxy-ssl-inspection-mac/>)
*   [如何判斷 Mac 是否被 SWG 劫持（偵測 HTTPS 與 SSL 檢查）](<https://swgbar.com/zh-TW/guides/detect-https-inspection/>)
*   [如何檢查公司或工作用 Mac 是否正在攔截 HTTPS（SSL 檢查）](<https://swgbar.com/zh-TW/guides/check-if-work-mac-intercepting-https/>)
*   [Mac 專用 SSL 檢查偵測工具：在選單列即時發現 HTTPS 攔截](<https://swgbar.com/zh-TW/guides/ssl-inspection-checker-mac/>)
*   [Mac 上的 Zscaler SSL 檢查：如何偵測並按網域繞過](<https://swgbar.com/zh-TW/guides/zscaler-ssl-inspection-bypass-mac/>)
*   [Mac 上的 Netskope SSL 檢查：偵測解密與單網域繞過指南](<https://swgbar.com/zh-TW/guides/netskope-ssl-inspection-bypass-mac/>)
*   [Mac 上的 Cloudflare WARP 與 Zero Trust TLS 檢查：偵測與繞過](<https://swgbar.com/zh-TW/guides/cloudflare-warp-tls-inspection-mac/>)
*   [SWG bar 中的「已確認」與「疑似」HTTPS 檢查狀態解析](<https://swgbar.com/zh-TW/guides/confirmed-vs-suspected-https-inspection/>)
*   [在 SWG bar 中檢查中間人根憑證與核發機構](<https://swgbar.com/zh-TW/guides/inspect-mitm-root-certificates-macos/>)
*   [Mac 上的企業 SWG 與 MDM HTTPS 解密檢查解析](<https://swgbar.com/zh-TW/guides/enterprise-swg-https-inspection-macos/>)
*   [SWG 繞過與 TLS 解密例外（Break-and-Inspect）對比](<https://swgbar.com/zh-TW/guides/swg-bypass-vs-tls-exception/>)
*   [在 Mac 上為多網域 Web 應用、SSO、CDN 與 API 設定 SWG 繞過](<https://swgbar.com/zh-TW/guides/multi-domain-sso-api-cdn-swg-bypass/>)
*   [排解 Mac 上 SWG 繞過的「恢復中」「已暫停」與連線錯誤](<https://swgbar.com/zh-TW/guides/troubleshoot-swg-bypass-recovering-paused-macos/>)
*   [macOS VPN 虛擬介面與 SWG HTTPS 檢查比較](<https://swgbar.com/zh-TW/guides/macos-vpn-virtual-interface-vs-swg-inspection/>)
*   [為什麼憑證固定（Pinning）應用與 mTLS 在 SWG 檢查下會中斷](<https://swgbar.com/zh-TW/guides/certificate-pinning-mtls-swg-inspection-macos/>)
*   [修復 Mac 終端機 CLI 與 AI 工具中的 SWG TLS/SSL 憑證錯誤](<https://swgbar.com/zh-TW/guides/swg-tls-certificate-errors-macos/>)
*   [Mac 在 SWG 下的 Homebrew、Docker、Python 與 Node.js CA 信任設定](<https://swgbar.com/zh-TW/guides/homebrew-docker-python-node-ca-trust-swg-macos/>)
*   [在 Mac 上使用 openssl 與 security verify-cert 驗證 TLS 憑證](<https://swgbar.com/zh-TW/guides/verify-tls-certificates-openssl-security-verify-cert-macos/>)
*   [SWG bar 權限、本機隱私與 TLS 探測上限說明](<https://swgbar.com/zh-TW/guides/macos-network-extension-privacy-probe-limits/>)
*   [SWG bar 如何檢查 HTTPS 解密](<https://swgbar.com/zh-TW/how-it-works/>)
*   [下載並安裝 Mac 版 SWG bar（macOS 14+）](<https://swgbar.com/zh-TW/install/>)
*   [偵測 SSL 與 HTTPS 檢查的 Chrome 擴充功能（SWG bar 配套外掛）](<https://swgbar.com/zh-TW/chrome-extension/>)
*   [SWG bar CLI 使用指南](<https://swgbar.com/zh-TW/cli/>)
*   [SWG bar MCP 使用指南](<https://swgbar.com/zh-TW/mcp/>)
*   [SWG bar 版本資訊](<https://swgbar.com/zh-TW/releases/>)
*   [關於 SWG bar](<https://swgbar.com/zh-TW/about/>)
