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

# 修复 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 · 更新日期 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`，通常说明企业安全 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](<https://swgbar.com/zh-CN/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 检查指南](<https://swgbar.com/zh-CN/guides/zscaler-ssl-inspection-bypass-mac/>)、[Mac 上的 Netskope SSL 检查指南](<https://swgbar.com/zh-CN/guides/netskope-ssl-inspection-bypass-mac/>)以及[修复 Mac 终端 CLI 与 AI 工具中的 SWG TLS/SSL 证书错误](<https://swgbar.com/zh-CN/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-CN/guides/how-to-bypass-swg/>)。

## 3\. 将 SWG bar MCP 接入 Claude Code 或 Cursor

确保已在运行 macOS 14+（Apple 芯片）的 Mac 上[安装 SWG bar](<https://swgbar.com/zh-CN/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-CN/mcp/>)。

## 注意本地证据边界

SWG bar 的 MCP 服务器在本地通过 stdio 读取你 Mac 上的本地数据库——不会向 SWG bar 云端服务器发送任何数据。尽管如此，向外部公开提交错误报告时仍应避免直接粘贴公司内部根证书详情或私有内网主机名；分享诊断日志前，请先阅读 [SWG bar 权限与本地隐私说明](<https://swgbar.com/zh-CN/guides/macos-network-extension-privacy-probe-limits/>)。

## 继续阅读

*   [如何在 Mac 上绕过 SWG（单域名一键绕过与 CLI 命令）](<https://swgbar.com/zh-CN/guides/how-to-bypass-swg/>)
*   [如何在 Mac 上绕过 SSL 检查（企业 SWG 单域名绕过指南）](<https://swgbar.com/zh-CN/guides/bypass-ssl-inspection-mac/>)
*   [如何在 macOS 上绕过 HTTPS 与 TLS 检查（Break-and-Inspect 指南）](<https://swgbar.com/zh-CN/guides/bypass-https-tls-inspection-mac/>)
*   [如何在 Mac 上绕过企业代理与 SWG SSL 检查](<https://swgbar.com/zh-CN/guides/bypass-corporate-proxy-ssl-inspection-mac/>)
*   [如何判断我的电脑是否被 SWG 劫持（Mac 上检测 HTTPS/SSL 检查）](<https://swgbar.com/zh-CN/guides/detect-https-inspection/>)
*   [如何检查公司或办公 Mac 是否正在拦截 HTTPS（SSL 检查排查）](<https://swgbar.com/zh-CN/guides/check-if-work-mac-intercepting-https/>)
*   [Mac SSL 检查检测工具：菜单栏实时侦测 HTTPS 拦截](<https://swgbar.com/zh-CN/guides/ssl-inspection-checker-mac/>)
*   [Mac 上的 Zscaler SSL 检查：如何检测并按域名绕过](<https://swgbar.com/zh-CN/guides/zscaler-ssl-inspection-bypass-mac/>)
*   [Mac 上的 Netskope SSL 检查：检测解密与单域名绕过指南](<https://swgbar.com/zh-CN/guides/netskope-ssl-inspection-bypass-mac/>)
*   [Mac 上的 Cloudflare WARP 与 Zero Trust TLS 检查：检测与绕过](<https://swgbar.com/zh-CN/guides/cloudflare-warp-tls-inspection-mac/>)
*   [SWG bar 中的“已确认”与“疑似”HTTPS 检查状态解析](<https://swgbar.com/zh-CN/guides/confirmed-vs-suspected-https-inspection/>)
*   [在 SWG bar 中检查中间人根证书与签发机构](<https://swgbar.com/zh-CN/guides/inspect-mitm-root-certificates-macos/>)
*   [Mac 上的企业 SWG 与 MDM HTTPS 解密检查解析](<https://swgbar.com/zh-CN/guides/enterprise-swg-https-inspection-macos/>)
*   [SWG 绕过与 TLS 解密例外（Break-and-Inspect）对比](<https://swgbar.com/zh-CN/guides/swg-bypass-vs-tls-exception/>)
*   [在 Mac 上为多域名 Web 应用、SSO、CDN 与 API 配置 SWG 绕过](<https://swgbar.com/zh-CN/guides/multi-domain-sso-api-cdn-swg-bypass/>)
*   [排查 Mac 上 SWG 绕过的“恢复中”“已暂停”与连接错误](<https://swgbar.com/zh-CN/guides/troubleshoot-swg-bypass-recovering-paused-macos/>)
*   [macOS VPN 虚拟网卡与 SWG HTTPS 检查对比](<https://swgbar.com/zh-CN/guides/macos-vpn-virtual-interface-vs-swg-inspection/>)
*   [为什么证书固定（Pinning）应用与 mTLS 在 SWG 检查下会失效](<https://swgbar.com/zh-CN/guides/certificate-pinning-mtls-swg-inspection-macos/>)
*   [修复 Mac 终端 CLI 与 AI 工具中的 SWG TLS/SSL 证书错误](<https://swgbar.com/zh-CN/guides/swg-tls-certificate-errors-macos/>)
*   [Mac 在 SWG 下的 Homebrew、Docker、Python 与 Node.js CA 信任配置](<https://swgbar.com/zh-CN/guides/homebrew-docker-python-node-ca-trust-swg-macos/>)
*   [在 Mac 上使用 openssl 与 security verify-cert 验证 TLS 证书](<https://swgbar.com/zh-CN/guides/verify-tls-certificates-openssl-security-verify-cert-macos/>)
*   [SWG bar 权限、本地隐私与 TLS 探测限额说明](<https://swgbar.com/zh-CN/guides/macos-network-extension-privacy-probe-limits/>)
*   [SWG bar 如何检查 HTTPS 解密](<https://swgbar.com/zh-CN/how-it-works/>)
*   [下载并安装 Mac 版 SWG bar（macOS 14+）](<https://swgbar.com/zh-CN/install/>)
*   [检测 SSL 与 HTTPS 检查的 Chrome 扩展（SWG bar 配套插件）](<https://swgbar.com/zh-CN/chrome-extension/>)
*   [SWG bar CLI 使用指南](<https://swgbar.com/zh-CN/cli/>)
*   [SWG bar MCP 使用指南](<https://swgbar.com/zh-CN/mcp/>)
*   [SWG bar 版本信息](<https://swgbar.com/zh-CN/releases/>)
*   [关于 SWG bar](<https://swgbar.com/zh-CN/about/>)
