« 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 agentCopie 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.

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.