---
title: "« Unable to connect to API: SSL certificate verification failed » sur Mac · Guides Kilobat"
url: "https://kilobat.app/fr/guides/claude-code-ssl-certificate-verification-failed"
description: "Claude Code sur votre Mac signale SSL certificate verification failed. Un proxy ou une autorité de certification privée signe le trafic. Ajoutez son autorité avec NODE_EXTRA_CA_CERTS."
---

# « Unable to connect to API: SSL certificate verification failed » sur Mac

Claude Code affiche ce message quand un certificat vient d’une autorité à laquelle il ne fait pas confiance. La documentation cite un proxy d’entreprise qui inspecte le TLS ou une passerelle dotée d’une autorité privée.

**Réglez-le avec votre agent**Copie un prompt pour Claude Code, Codex ou tout agent capable d’utiliser Terminal.

Mon Mac a ce problème : « Unable to connect to API: SSL certificate verification failed » sur Mac. Lis https://kilobat.app/fr/guides/claude-code-ssl-certificate-verification-failed.md et résous-le avec moi. Installe la CLI Kilobat si elle manque : brew install seifip/kilobat/kilobat. Lance toi-même les vérifications Terminal et kilobat du guide et dis-moi ce que tu trouves. Liste les étapes que moi seul peux faire. Demande-moi avant de modifier un réglage.

S’applique à : Claude Code dans un terminal, sur toutes les versions actuelles de macOS. · Vérifié le 29 octobre 2026

## Symptômes

- Claude Code affiche `Unable to connect to API: SSL certificate verification failed`.
- Le code indique UNABLE_TO_GET_ISSUER_CERT_LOCALLY, ou le texte parle de certificat auto-signé.
- Cela commence sur un réseau professionnel.

## Causes probables

- **Un proxy qui inspecte le TLS.** Un proxy ou un équipement de sécurité intercepte le trafic TLS avec son propre certificat.
- **Une passerelle avec une autorité privée.** Une passerelle LLM peut utiliser un certificat d’une autorité privée.
- **Un fichier d’autorité qui ne se charge pas.** Claude Code avertit quand il ne peut pas lire le fichier NODE_EXTRA_CA_CERTS.
- **Une horloge fausse.** Une date très éloignée fait échouer la vérification des certificats.

## Comment vérifier

1. Lisez l’émetteur.

   ```
   curl -v -o /dev/null https://api.anthropic.com 2>&1 | grep -i issuer
   ```
2. Affichez la variable.

   ```
   echo $NODE_EXTRA_CA_CERTS
   ```
3. Lancez Claude Code avec la journalisation de débogage, puis lisez les lignes CA du journal.

   ```
   claude --debug
   ```
4. Vérifiez la date.

   ```
   date
   ```

## Comment corriger

1. Demandez le lot d’autorités à l’administrateur, au format PEM.
2. Indiquez-le à Claude Code avant le lancement.

   ```
   export NODE_EXTRA_CA_CERTS=/path/to/ca-bundle.pem
   ```
3. Ou ajoutez l’autorité au trousseau de certificats système de macOS, comme l’indique la documentation.
4. Ne définissez pas `NODE_TLS_REJECT_UNAUTHORIZED=0`. Cela désactive la validation.

## Avec Kilobat

1. Le diagnostic de connexion de Kilobat teste l’hôte de l’API couche par couche. La couche TLS montre qui a signé le certificat.

   ```
   kilobat why https://api.anthropic.com
   ```
2. Ces vérifications Kilobat sont gratuites. Les agents IA les lancent via MCP avec `diagnose_connection` et `diagnose_network`. Consultez [Trouver pourquoi un site ou une API ne se connecte pas](https://kilobat.app/fr/guides/recipes/why-cant-it-connect).

## Questions

**Claude Code utilise-t-il le magasin de certificats de macOS ?**

Par défaut, il fait confiance aux autorités Mozilla qu’il embarque et au magasin du système. Les installations natives lisent toujours le magasin du système.

**Puis-je désactiver la validation ?**

La documentation dit de ne pas définir NODE_TLS_REJECT_UNAUTHORIZED=0.

## Sources

- [Claude Code : référence des erreurs](https://code.claude.com/docs/en/errors.md)
- [Claude Code : configuration réseau en entreprise](https://code.claude.com/docs/en/network-config.md)

Vérifié le 29 octobre 2026.

## Guides associés

- [« Unable to connect to API » dans Claude Code sur Mac](https://kilobat.app/fr/guides/claude-code-unable-to-connect-to-api): Claude Code affiche Unable to connect to API quand une requête n’atteint pas api.anthropic.com.
- [« UNABLE_TO_GET_ISSUER_CERT_LOCALLY » sur Mac](https://kilobat.app/fr/guides/npm-unable-to-get-issuer-cert-locally): UNABLE_TO_GET_ISSUER_CERT_LOCALLY signifie que Node.js ne trouve pas l’autorité qui a signé un certificat.
- [Les certificats de proxy d’entreprise bloquent les outils de Terminal sur un Mac](https://kilobat.app/fr/guides/corporate-proxy-certificates): Certains réseaux d’entreprise inspectent le trafic HTTPS.
- [« curl: (60) SSL certificate problem » sur Mac](https://kilobat.app/fr/guides/curl-60-ssl-certificate-problem): Le code de sortie 60 de curl signale une étape en échec.
