Risoluzione errore di verifica certificato SSL Claude AI in Visual Studio con accesso sicuro

Opzioni per il download

PDF (245.6 KB)
Visualizza con Adobe Reader su diversi dispositivi
ePub (85.8 KB)
Visualizza in diverse app su iPhone, iPad, Android, Sony Reader o Windows Phone
Mobi (Kindle) (71.7 KB)
Visualizza su dispositivo Kindle o tramite app Kindle su più dispositivi

Aggiornato:6 agosto 2026

ID documento:226235

Linguaggio senza pregiudizi

La documentazione per questo prodotto è stata redatta cercando di utilizzare un linguaggio senza pregiudizi. Ai fini di questa documentazione, per linguaggio senza di pregiudizi si intende un linguaggio che non implica discriminazioni basate su età, disabilità, genere, identità razziale, identità etnica, orientamento sessuale, status socioeconomico e intersezionalità. Le eventuali eccezioni possono dipendere dal linguaggio codificato nelle interfacce utente del software del prodotto, dal linguaggio utilizzato nella documentazione RFP o dal linguaggio utilizzato in prodotti di terze parti a cui si fa riferimento. Scopri di più sul modo in cui Cisco utilizza il linguaggio inclusivo.

Informazioni su questa traduzione

Cisco ha tradotto questo documento utilizzando una combinazione di tecnologie automatiche e umane per offrire ai nostri utenti in tutto il mondo contenuti di supporto nella propria lingua. Si noti che anche la migliore traduzione automatica non sarà mai accurata come quella fornita da un traduttore professionista. Cisco Systems, Inc. non si assume alcuna responsabilità per l’accuratezza di queste traduzioni e consiglia di consultare sempre il documento originale in inglese (disponibile al link fornito).

Sommario

Problema

Claude AI non funziona all'interno dell'applicazione di Visual Studio e restituisce un errore API relativo a un errore di verifica del certificato SSL.

Viene visualizzato il seguente messaggio di errore:

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

Questo problema si verifica in modo specifico quando si tenta di utilizzare Claude AI dall'ambiente di sviluppo di Visual Studio, mentre l'accesso a Claude tramite un browser Web funziona normalmente dallo stesso endpoint. L'estensione Claude Code non è in grado di stabilire una connessione protetta all'API antropica a causa di problemi di attendibilità del certificato SSL nell'ambiente di runtime Node.js.

Ambiente

Cisco Secure Access (Umbrella) con decrittografia SSL abilitata
Codice di Visual Studio con estensione Claude Code
Ambiente di estensione basato su Node.js
CA radice Cisco Secure Access installata nell'archivio di attendibilità del computer
api.anthropic.com consentito nei criteri Cisco Secure Access con decrittografia abilitata

Risoluzione

Il problema è stato risolto configurando la variabile di ambiente NODE_EXTRA_CA_CERTS in modo che consideri in modo esplicito attendibile il certificato radice Cisco Secure Access per le applicazioni basate su Node.js.

Per risolvere l'errore di verifica del certificato SSL, attenersi alla procedura seguente:

Passaggio 1: Configurare la variabile di ambiente NODE_EXTRA_CA_CERTS

Impostare la variabile di ambiente di sistema NODE_EXTRA_CA_CERTS in modo che punti al percorso del file del certificato radice Cisco Secure Access. Questa configurazione consente alle applicazioni Node.js di considerare attendibile l'Autorità di certificazione intercettante anche quando la CA radice è già installata nell'archivio di certificati del sistema operativo.

NODE_EXTRA_CA_CERTS=[path_to_secure_access_root_certificate]

Passaggio 2: Riavvia codice di Visual Studio

Chiudere e riavviare Visual Studio Code per garantire che la nuova configurazione delle variabili di ambiente venga applicata all'estensione Claude Code.

Passaggio 3: Riavvia agente Umbrella (Secure Access)

Riavviare il servizio dell'agente Umbrella per garantire la corretta gestione dei certificati dopo la modifica della variabile di ambiente.

Passaggio 4: Verifica risoluzione

Verificare la funzionalità di estensione del codice Claude nel codice di Visual Studio per verificare che l'errore di verifica SSL sia stato risolto e che il codice Claude funzioni normalmente.

Nota: I tentativi precedenti di risolvere il problema escludendo api.anthropic.com dalla decrittografia SSL nelle regole Cisco Secure Access o installando i certificati direttamente in Visual Studio non hanno risolto il problema, in quanto il problema era specifico dell'ambiente di runtime Node.js utilizzato dall'estensione Claude Code.

Causa

La causa principale di questo problema è un requisito di configurazione Node.js per l'attendibilità del certificato SSL. Le estensioni basate su Node.js, ad esempio l'estensione Claude Code in Visual Studio, richiedono una configurazione esplicita dell'autorità di certificazione tramite la variabile di ambiente NODE_EXTRA_CA_CERTS per considerare attendibili i certificati di intercettazione, anche quando l'autorità di certificazione radice è già installata nell'archivio di certificati del sistema operativo.

Quando Cisco Secure Access esegue la decrittografia SSL sul traffico verso api.anthropic.com, presenta il proprio certificato all'applicazione client. Mentre i browser Web possono accedere all'archivio di certificati del sistema operativo per convalidare questo certificato, le applicazioni Node.js devono configurare in modo esplicito la variabile NODE_EXTRA_CA_CERTS per considerare attendibile il certificato radice di accesso sicuro. Senza questa configurazione, il runtime Node.js non è in grado di convalidare la catena di certificati SSL, generando un errore di verifica del certificato SSL.