Résoudre l'échec de vérification du certificat SSL AI Claude dans Visual Studio avec accès sécurisé

Problème

Claude AI ne fonctionne pas dans l'application Visual Studio, retournant une erreur d'API liée à l'échec de vérification du certificat SSL.

Le message d'erreur suivant s'affiche :

API Error: Unable to connect to API. SSL Certificate verification failed. Check your proxy or corporate SSL certificates.

Ce problème se produit spécifiquement lorsque vous essayez d'utiliser Claude AI à partir de l'environnement de développement Visual Studio, alors que l'accès à Claude via un navigateur Web fonctionne normalement à partir du même terminal. L'extension Code Claude ne parvient pas à établir une connexion sécurisée à l'API anthropique en raison de problèmes d'approbation de certificat SSL dans l'environnement d'exécution Node.js.

Environnement

• Cisco Secure Access (Umbrella) avec déchiffrement SSL activé

• Code Visual Studio avec extension Code Claude

• Environnement d'extension basé sur Node.js

• Autorité de certification racine Cisco Secure Access installée dans le magasin de confiance de la machine

• api.anthropic.com autorisé dans les politiques d'accès sécurisé Cisco avec déchiffrement activé

Résolution

Le problème a été résolu en configurant la variable d'environnement NODE_EXTRA_CA_CERTS pour faire explicitement confiance au certificat racine Cisco Secure Access pour les applications Node.js.

Procédez comme suit pour résoudre l'échec de la vérification du certificat SSL :

Étape 1: Configurer la variable d'environnement NODE_EXTRA_CA_CERTS

Définissez la variable d'environnement système NODE_EXTRA_CA_CERTS pour qu'elle pointe vers le chemin d'accès au fichier de certificat racine Cisco Secure Access. Cette configuration permet aux applications Node.js d'approuver l'autorité de certification d'interception même lorsque l'autorité de certification racine est déjà installée dans le magasin d'approbation du système d'exploitation.

NODE_EXTRA_CA_CERTS=[path_to_secure_access_root_certificate]

Étape 2: Redémarrer le code Visual Studio

Fermez et redémarrez Visual Studio Code pour vous assurer que la nouvelle configuration de variable d'environnement prend effet pour l'extension Code Claude.

Étape 3: Redémarrer l'agent Umbrella (Secure Access)

Redémarrez le service d'agent Umbrella pour assurer un traitement de certificat approprié après la modification de la variable d'environnement.

Étape 4: Vérifier la résolution

Testez la fonctionnalité d'extension Claude Code dans Visual Studio Code pour confirmer que l'erreur de vérification SSL a été résolue et que Claude Code fonctionne normalement.

Motif

La cause principale de ce problème est une exigence de configuration Node.js pour l'approbation de certificat SSL. Les extensions basées sur Node.js, telles que l'extension Code Claude dans Visual Studio, nécessitent une configuration d'autorité de certification explicite via la variable d'environnement NODE_EXTRA_CA_CERTS pour approuver les certificats d'interception, même si l'autorité de certification racine est déjà installée dans le magasin d'approbation du système d'exploitation.

Lorsque Cisco Secure Access effectue un déchiffrement SSL sur le trafic vers api.anthropic.com, il présente son propre certificat à l'application cliente. Alors que les navigateurs Web peuvent accéder au magasin d'approbation du système d'exploitation pour valider ce certificat, les applications Node.js ont besoin que la variable NODE_EXTRA_CA_CERTS soit explicitement configurée pour approuver le certificat racine d'accès sécurisé. Sans cette configuration, le runtime Node.js ne parvient pas à valider la chaîne de certificats SSL, ce qui entraîne une erreur de vérification du certificat SSL.

Autres informations utiles

• Assistance technique de Cisco et téléchargements

Historique de révision

Révision	Date de publication	Commentaires
1.0	06-Aug-2026	Première publication