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 (
~/.zshrcund~/.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 esNODE_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.