Claude Code & Cursor 'unable to get local issuer certificate' auf Mac beheben (SWG & MCP)

Behebe Claude Code- und Cursor-Fehler unable to get local issuer certificate hinter Zscaler, Netskope oder Unternehmens-SWGs auf macOS – plus SWG bar MCP & Domain-Umgehung.

SWG bar · Aktualisiert

Wenn Claude Code, Cursor, Windsurf oder Claude Desktop auf deinem Arbeits-Mac mit unable to get local issuer certificate, UNABLE_TO_GET_ISSUER_CERT_LOCALLY, self-signed certificate in certificate chain oder CERTIFICATE_VERIFY_FAILED fehlschlagen, führt dein Unternehmens-SWG (Secure Web Gateway wie Zscaler, Netskope oder Cloudflare Gateway) eine SSL-/HTTPS-Inspektion durch und signiert API-Antworten mit einer Unternehmens-Root-CA neu, der Node.js- und Electron-Laufzeitumgebungen standardmäßig nicht vertrauen.

Im Folgenden findest du die zwei sicheren Lösungen auf macOS – die Konfiguration des Unternehmens-CA-Vertrauens (NODE_EXTRA_CA_CERTS / Cursor-Systemzertifikate) oder die domänenbasierte SWG-Umgehung in autorisierten Netzwerken – sowie die Anleitung zum Verbinden des integrierten MCP-Servers von SWG bar, damit dein KI-Coding-Agent inspizierte Domains automatisch diagnostizieren kann.

1. Bestätigen, welche LLM- oder Registry-Hostnamen abgefangen werden

Bevor du Shell-Profile oder Einstellungen bearbeitest, prüfe über SWG bar → Domains oder die --json-CLI, welche genauen Hostnamen (api.anthropic.com, api2.cursor.sh, registry.npmjs.org, OAuth-Anmeldehosts oder MCP-Endpunkte) auf deinem Mac neu signiert werden:

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

Achte besonders auf sekundäre Endpunkte: Eine KI-IDE kontaktiert häufig getrennte Hostnamen für Modell-Inferenz, Authentifizierung, Telemetrie und Erweiterungs-Marktplätze.

2. unable to get local issuer certificate in Claude Code & Cursor beheben

Vermeide es, NODE_TLS_REJECT_UNAUTHORIZED=0 zu setzen – dies deaktiviert die TLS-Prüfung global und gefährdet API-Schlüssel in nicht vertrauenswürdigen Netzwerken. Wähle stattdessen einen der beiden folgenden sicheren Wege:

Option A: Unternehmens-Root-CA-Vertrauen konfigurieren (lässt SWG-Entschlüsselung aktiv)

Exportiere deine Unternehmens-, Zscaler- oder Netskope-Root-CA als PEM-Datei (zum Beispiel $HOME/.certs/corporate-ca.pem) aus der Schlüsselbundverwaltung oder beziehe sie von der IT und konfiguriere anschließend jedes Tool:

  • Claude Code (~/.zshrc und ~/.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)): Aktiviere Systemzertifikate (und deaktiviere optional HTTP/2, falls der SWG-Proxy Streaming unterbricht), beende Cursor anschließend vollständig (Cmd + Q) und starte Cursor aus dem Terminal neu, damit es NODE_EXTRA_CA_CERTS übernimmt:
{
  "http.experimental.systemCertificatesV2": true,
  "cursor.general.disableHttp2": true
}

Zscaler-, Netskope- und Cloudflare-spezifische Befehle für CA-Bundles findest du außerdem unter Zscaler SSL-Inspektion auf dem Mac, Netskope SSL-Inspektion auf dem Mac und SWG-TLS- & SSL-Zertifikatsfehler in CLI- und KI-Tools beheben.

Option B: Domänenbasierte SWG-Umgehung auf einem autorisierten Mac aktivieren

Wenn du in einem Netzwerk arbeitest, das du verwaltest oder konfigurieren darfst – insbesondere wenn HTTP/2-Streaming oder Certificate Pinning trotz NODE_EXTRA_CA_CERTS weiterhin fehlschlagen –, aktiviere die Umgehung pro Hostname über die physische Hardware-IPv4-Schnittstelle deines Mac unter SWG bar → Domains → SWG umgehen → Umgehung für diese Domain aktivieren oder im Terminal:

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

Starte Claude Code oder Cursor neu, sobald Umgehung aktiv erscheint, damit bestehende Sockets sauber neu aufgebaut werden. Blockiert deine Unternehmens-Firewall direkte ausgehende Verbindungen, deaktiviere die Umgehung (swgbar bypass disable <domain>) und nutze Option A oder beantrage bei der IT eine Do Not Decrypt-Regel. Folge SWG auf dem Mac umgehen für die vollständige Einrichtung und das Neustartverhalten.

3. SWG bar MCP mit Claude Code oder Cursor verbinden

Stelle sicher, dass SWG bar installiert ist (/Applications/SWGBar.app) und unter macOS 14+ (Apple Chip) läuft. Registriere den lokalen stdio-MCP-Server für Claude Code mit einem einzigen Befehl:

claude mcp add swgbar -- /Applications/SWGBar.app/Contents/MacOS/swgbar mcp

Oder füge den Server-Block in .cursor/mcp.json (für Cursor) bzw. claude_desktop_config.json (für Claude Desktop) ein:

{
  "mcpServers": {
    "swgbar": {
      "command": "/Applications/SWGBar.app/Contents/MacOS/swgbar",
      "args": ["mcp"]
    }
  }
}

Alle freigegebenen Werkzeugbereiche (Übersicht, Domains, Zertifikate, SWG umgehen, bedarfsgesteuerte Prüfungen, Browser-Begleiter und App-Einstellungen) findest du in der vollständigen MCP-Anleitung.

Grenzen lokaler Nachweise beachten

Der MCP-Server von SWG bar läuft lokal über stdio gegen die lokale Datenbank deines Mac – es werden keine Daten an Cloud-Server von SWG bar gesendet. Vermeide dennoch, rohe Unternehmens-Root-CA-Details oder private interne Hostnamen in öffentliche Fehlerberichte einzufügen; lies vor dem Teilen von Diagnoseprotokollen SWG bar-Berechtigungen & lokaler Datenschutz.