Исправление ошибки 'unable to get local issuer certificate' в Claude Code и Cursor на Mac (SWG и MCP)

Исправьте ошибку unable to get local issuer certificate в Claude Code и Cursor за Zscaler, Netskope или корпоративным SWG в macOS — плюс подключение 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, значит корпоративный защищённый веб-шлюз (например, Zscaler, Netskope или Cloudflare Gateway) выполняет SSL/HTTPS-инспекцию и переподписывает ответы API корпоративным корневым CA, которому среды Node.js и Electron не доверяют по умолчанию.

Ниже описаны два безопасных решения для macOS — настройка доверия к корпоративному CA (NODE_EXTRA_CA_CERTS / системные сертификаты Cursor) или включение подоменного обхода SWG в разрешённых сетях — а также подключение встроенного MCP-сервера SWG bar, чтобы ваш ИИ-агент разработки мог автоматически диагностировать проверяемые домены.

1. Убедитесь, какие имена хостов LLM или реестров пакетов перехватываются

Прежде чем редактировать профили оболочки или настройки, проверьте, какие именно имена хостов (api.anthropic.com, api2.cursor.sh, registry.npmjs.org, хосты входа OAuth или конечные точки MCP) переподписываются на вашем Mac, с помощью SWG bar → Домены или CLI с флагом --json:

swgbar overview --json
swgbar domains list --status confirmed --json
swgbar probe api.anthropic.com --json
swgbar domains detail registry.npmjs.org --json

Обращайте особое внимание на второстепенные конечные точки: ИИ-IDE часто обращаются к отдельным именам хостов для инференса моделей, аутентификации, телеметрии и каталогов расширений.

2. Исправьте unable to get local issuer certificate в Claude Code и Cursor

Не задавайте NODE_TLS_REJECT_UNAUTHORIZED=0 — эта переменная глобально отключает проверку TLS и подвергает ваши API-ключи риску в недоверенных сетях. Выберите один из двух безопасных способов ниже:

Вариант А: Настройте доверие к корпоративному корневому CA (сохраняет расшифровку SWG активной)

Экспортируйте корпоративный корневой CA (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)): включите использование системных сертификатов (и при необходимости отключите HTTP/2, если прокси SWG ломает потоковую передачу), затем полностью закройте (Cmd + Q) и заново запустите Cursor из Терминала, чтобы он унаследовал NODE_EXTRA_CA_CERTS:
{
  "http.experimental.systemCertificatesV2": true,
  "cursor.general.disableHttp2": true
}

Команды для пакетов CA конкретных вендоров Zscaler, Netskope и Cloudflare см. в руководствах SSL-инспекция Zscaler на Mac, SSL-инспекция Netskope на Mac и Как исправить ошибки сертификатов TLS и SSL из-за SWG в CLI и ИИ.

Вариант Б: Включите подоменный обход SWG на авторизованном Mac

При работе в сети, которой вы управляете или которую имеете право настраивать — особенно если потоки HTTP/2 или привязка сертификатов всё равно дают сбой даже с NODE_EXTRA_CA_CERTS — включите обход по имени хоста через физический IPv4-интерфейс Аппаратный вашего Mac в SWG bar → Домены → Обойти SWG → Включить обход для этого домена или в Терминале:

swgbar bypass enable api.anthropic.com
swgbar bypass status --json
swgbar probe api.anthropic.com --json

Перезапустите Claude Code или Cursor после появления статуса Обход активен, чтобы существующие сокеты переподключились заново. Если корпоративный межсетевой экран блокирует прямые исходящие соединения, отключите обход (swgbar bypass disable <domain>) и используйте вариант А или запросите у ИТ правило Do Not Decrypt. Подробные шаги настройки и поведение при перезапуске см. в статье Как обойти SWG на Mac.

3. Подключите SWG bar MCP к Claude Code или Cursor

Убедитесь, что SWG bar установлен в /Applications/SWGBar.app и работает на macOS 14+ (Apple silicon). Зарегистрируйте локальный stdio MCP-сервер одной командой для Claude Code:

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.

Помните о границах локальных данных

MCP-сервер SWG bar работает локально через stdio с локальной базой данных на вашем Mac — никакие данные не отправляются на облачные серверы SWG bar. Тем не менее не вставляйте необработанные сведения о корпоративном корневом CA или закрытые внутренние имена хостов в публичные отчёты об ошибках; перед передачей диагностических журналов ознакомьтесь со статьёй Разрешения SWG bar и локальная приватность.