修復 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 · 更新日期
如果 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 確認究竟是哪些主機名稱(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 檢查、Mac 上的 Netskope SSL 檢查與修復 Mac 終端機 CLI 與 AI 工具中的 SWG TLS/SSL 憑證錯誤。
方案 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。
3. 將 SWG bar MCP 連線至 Claude Code 或 Cursor
確認已在 macOS 14+(Apple 晶片)上將 SWG bar 安裝於 /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 使用指南。
留意本機證據的隱私邊界
SWG bar 的 MCP 伺服器完全透過本機 stdio 存取你 Mac 上的本機資料庫,不會向 SWG bar 雲端伺服器傳送任何資料。但在公開回報錯誤時仍應避免貼上原始企業根憑證細節或內部私有主機名稱;分享診斷日誌前,建議先閱讀 SWG bar 權限、本機隱私與探測上限。