---
title: "„Unable to connect to API: SSL certificate verification failed“ auf dem Mac · Kilobat Anleitungen"
url: "https://kilobat.app/de/guides/claude-code-ssl-certificate-verification-failed"
description: "Claude Code auf deinem Mac meldet „SSL certificate verification failed“. Ein Proxy oder eine private CA signiert den Datenverkehr. Füge deren CA mit NODE_EXTRA_CA_CERTS hinzu."
---

# “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 beheben**Kopiert 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](https://kilobat.app/de/guides/recipes/why-cant-it-connect).

## 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

- [Claude Code: Error reference](https://code.claude.com/docs/en/errors.md)
- [Claude Code: Enterprise network configuration](https://code.claude.com/docs/en/network-config.md)

Geprüft am 29. Oktober 2026.

## Verwandte Anleitungen

- [“Unable to connect to API” in Claude Code auf dem Mac](https://kilobat.app/de/guides/claude-code-unable-to-connect-to-api): Claude Code gibt Unable to connect to API aus, wenn eine Anfrage api.anthropic.com nicht erreicht.
- [“UNABLE_TO_GET_ISSUER_CERT_LOCALLY” auf dem Mac](https://kilobat.app/de/guides/npm-unable-to-get-issuer-cert-locally): UNABLE_TO_GET_ISSUER_CERT_LOCALLY bedeutet, dass Node.js die Stelle nicht findet, die ein Zertifikat signiert hat.
- [Firmenproxy-Zertifikate legen Terminal-Tools auf dem Mac lahm](https://kilobat.app/de/guides/corporate-proxy-certificates): Manche Firmennetzwerke prüfen HTTPS-Datenverkehr.
- [“curl: (60) SSL certificate problem” auf dem Mac](https://kilobat.app/de/guides/curl-60-ssl-certificate-problem): Der curl-Exit-Code 60 meldet einen fehlgeschlagenen Schritt.
