“Unable to connect to API: SSL certificate verification failed” auf dem Mac
Claude Code gibt das aus, wenn ein Zertifikat von einer Stelle stammt, der es nicht vertraut. Die Dokumentation nennt einen TLS-prüfenden Firmenproxy oder ein Gateway mit privater CA.
Mein Mac hat dieses Problem: „Unable to connect to API: SSL certificate verification failed“ auf dem Mac. Lies https://kilobat.app/de/guides/claude-code-ssl-certificate-verification-failed.md und geh es mit mir durch. Installiere die Kilobat-CLI, falls sie fehlt: brew install seifip/kilobat/kilobat. Führe die Terminal- und kilobat-Checks aus der Anleitung selbst aus und sag mir, was du findest. Liste die Schritte auf, die nur ich erledigen kann. Frag nach, bevor du eine Einstellung änderst.
Symptome
- Claude Code gibt
Unable to connect to API: SSL certificate verification failedaus. - Der Code lautet UNABLE_TO_GET_ISSUER_CERT_LOCALLY, oder der Text spricht von einem selbstsignierten Zertifikat.
- Es beginnt in einem Firmennetzwerk.
Mögliche Ursachen
- Ein TLS-prüfender Proxy. Ein Proxy oder eine Sicherheits-Appliance fängt den TLS-Verkehr mit einem eigenen Zertifikat ab.
- Ein Gateway mit privater CA. Ein LLM-Gateway kann ein Zertifikat einer privaten Zertifizierungsstelle verwenden.
- Eine CA-Datei, die sich nicht laden lässt. Claude Code warnt, wenn es die Datei aus NODE_EXTRA_CA_CERTS nicht lesen kann.
- Eine falsche Uhr. Ein stark abweichendes Datum bricht die Zertifikatsprüfung.
So prüfst du es
Lies den Aussteller aus.
curl -v -o /dev/null https://api.anthropic.com 2>&1 | grep -i issuerZeige die Variable an.
echo $NODE_EXTRA_CA_CERTSStarte Claude Code mit Debug-Protokoll und lies dann die CA-Zeilen im Protokoll.
claude --debugPrüfe das Datum.
date
So behebst du es
Hole das CA-Bundle im PEM-Format vom Administrator.
Verweise vor dem Start darauf.
export NODE_EXTRA_CA_CERTS=/path/to/ca-bundle.pemOder füge die CA dem Zertifikatsspeicher von macOS hinzu, wie es die Dokumentation beschreibt.
Setze
NODE_TLS_REJECT_UNAUTHORIZED=0nicht. Es schaltet die Validierung ab.
Mit Kilobat
Der Verbindungsdoktor von Kilobat testet den API-Host Schicht für Schicht. Die TLS-Schicht zeigt, wer das Zertifikat signiert hat.
kilobat why https://api.anthropic.comDiese Kilobat-Prüfungen sind kostenlos. KI-Agenten führen sie über MCP mit
diagnose_connectionunddiagnose_networkaus. Siehe Herausfinden, warum eine Website oder API keine Verbindung bekommt.
Fragen
Verwendet Claude Code den Zertifikatsspeicher von macOS?
Standardmäßig vertraut es seinen mitgelieferten Mozilla-CAs und dem Speicher des Betriebssystems. Native Installationen lesen immer den Systemspeicher.
Kann ich die Validierung abschalten?
Die Dokumentation rät davon ab, NODE_TLS_REJECT_UNAUTHORIZED=0 zu setzen.
Quellen
Geprüft am 29. Oktober 2026.