修复 Mac 上 Claude Code 与 Cursor 的 'unable to get local issuer certificate' 报错(SWG 与 MCP)

修复 macOS 在 Zscaler、Netskope 或企业 SWG 下运行 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,通常说明企业安全 Web 网关(例如 Zscaler、Netskope 或 Cloudflare Gateway)正在执行 SSL/HTTPS 检查,并使用 Node.js 与 Electron 运行时默认不信任的企业根证书(Root CA)重新签发了 API 响应。

下文介绍 macOS 上的两种安全修复方案——配置企业 CA 信任(NODE_EXTRA_CA_CERTS / Cursor 系统证书)或在获授权网络上启用单域名 SWG 绕过——以及如何接入 SWG bar 内置的 MCP 服务器,让 AI 编程助手自动诊断受检域名。

1. 确认哪些大模型或包仓库主机名正在被拦截

在修改 Shell 配置或 IDE 设置之前,先用 SWG bar → 域名或支持 --json 的 CLI 核实 Mac 上究竟哪些准确主机名(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:配置企业根证书信任(保持 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 芯片)的 Mac 上安装 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 权限与本地隐私说明。