“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.

Mit deinem Agenten behebenKopiert einen Prompt für Claude Code, Codex oder jeden Agenten, der das Terminal nutzen kann.

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.

Gilt für: Claude Code in einem Terminal unter allen aktuellen macOS-Versionen.Geprüft: 29. Oktober 2026

Symptome

  • Claude Code gibt Unable to connect to API: SSL certificate verification failed aus.
  • 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

  1. Lies den Aussteller aus.

    curl -v -o /dev/null https://api.anthropic.com 2>&1 | grep -i issuer
  2. Zeige die Variable an.

    echo $NODE_EXTRA_CA_CERTS
  3. Starte Claude Code mit Debug-Protokoll und lies dann die CA-Zeilen im Protokoll.

    claude --debug
  4. Prüfe das Datum.

    date

So behebst du es

  1. Hole das CA-Bundle im PEM-Format vom Administrator.

  2. Verweise vor dem Start darauf.

    export NODE_EXTRA_CA_CERTS=/path/to/ca-bundle.pem
  3. Oder füge die CA dem Zertifikatsspeicher von macOS hinzu, wie es die Dokumentation beschreibt.

  4. Setze NODE_TLS_REJECT_UNAUTHORIZED=0 nicht. Es schaltet die Validierung ab.

Mit Kilobat

  1. 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.com
  2. Diese Kilobat-Prüfungen sind kostenlos. KI-Agenten führen sie über MCP mit diagnose_connection und diagnose_network aus. 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.