« 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.
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.
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
Lisez l’émetteur.
curl -v -o /dev/null https://api.anthropic.com 2>&1 | grep -i issuerAffichez la variable.
echo $NODE_EXTRA_CA_CERTSLancez Claude Code avec la journalisation de débogage, puis lisez les lignes CA du journal.
claude --debugVérifiez la date.
date
Comment corriger
Demandez le lot d’autorités à l’administrateur, au format PEM.
Indiquez-le à Claude Code avant le lancement.
export NODE_EXTRA_CA_CERTS=/path/to/ca-bundle.pemOu ajoutez l’autorité au trousseau de certificats système de macOS, comme l’indique la documentation.
Ne définissez pas
NODE_TLS_REJECT_UNAUTHORIZED=0. Cela désactive la validation.
Avec Kilobat
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.comCes vérifications Kilobat sont gratuites. Les agents IA les lancent via MCP avec
diagnose_connectionetdiagnose_network. Consultez Trouver pourquoi un site ou une API ne se connecte pas.
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
Vérifié le 29 octobre 2026.