Claude AI SSL Certificaat Verificatie Fout in Visual Studio oplossen met Secure Access

Downloadopties

PDF (246.5 KB)
Met Adobe Reader op diverse apparaten bekijken

Bijgewerkt:6 augustus 2026

Document-id:226235

Inclusief taalgebruik

De documentatie van dit product is waar mogelijk geschreven met inclusief taalgebruik. Inclusief taalgebruik wordt in deze documentatie gedefinieerd als taal die geen discriminatie op basis van leeftijd, handicap, gender, etniciteit, seksuele oriëntatie, sociaaleconomische status of combinaties hiervan weerspiegelt. In deze documentatie kunnen uitzonderingen voorkomen vanwege bewoordingen die in de gebruikersinterfaces van de productsoftware zijn gecodeerd, die op het taalgebruik in de RFP-documentatie zijn gebaseerd of die worden gebruikt in een product van een externe partij waarnaar wordt verwezen. Lees meer over hoe Cisco gebruikmaakt van inclusief taalgebruik.

Over deze vertaling

Cisco heeft dit document vertaald via een combinatie van machine- en menselijke technologie om onze gebruikers wereldwijd ondersteuningscontent te bieden in hun eigen taal. Houd er rekening mee dat zelfs de beste machinevertaling niet net zo nauwkeurig is als die van een professionele vertaler. Cisco Systems, Inc. is niet aansprakelijk voor de nauwkeurigheid van deze vertalingen en raadt aan altijd het oorspronkelijke Engelstalige document (link) te raadplegen.

Inhoud

uitgifte

Claude AI functioneert niet binnen de Visual Studio-applicatie, waardoor een API-fout wordt geretourneerd die verband houdt met SSL-certificaatverificatie.

De specifieke foutmelding die wordt weergegeven is:

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

Dit probleem doet zich specifiek voor wanneer u probeert Claude AI te gebruiken vanuit de ontwikkelomgeving van Visual Studio, terwijl toegang tot Claude via een webbrowser normaal gesproken vanuit hetzelfde eindpunt werkt. De Claude Code-extensie kan geen beveiligde verbinding met de Anthropic API tot stand brengen vanwege problemen met SSL-certificaatvertrouwen in de Node.js runtime-omgeving.

milieu

Cisco Secure Access (Umbrella) met SSL-decodering ingeschakeld
Visual Studio Code met Claude Code extensie
Node.js-gebaseerde extensieomgeving
Cisco Secure Access root CA geïnstalleerd in het systeemvertrouwensarchief
api.anthropic.com toegestaan in Cisco Secure Access-beleid met decodering ingeschakeld

resolutie

Het probleem is opgelost door de omgevingsvariabele NODE_EXTRA_CA_CERTS te configureren om expliciet te vertrouwen op het Cisco Secure Access-basiscertificaat voor Node.js-gebaseerde toepassingen.

Volg deze stappen om de SSL-certificaatverificatie op te lossen:

Stap 1: Configureer NODE_EXTRA_CA_CERTS-omgevingsvariabele

Stel de variabele NODE_EXTRA_CA_CERTS-systeemomgeving in om naar het bestandspad van het Cisco Secure Access-basiscertificaat te verwijzen. Met deze configuratie kunnen Node.js-toepassingen vertrouwen op de certificeringsinstantie voor het onderscheppen, zelfs wanneer de root-CA al is geïnstalleerd in de vertrouwensopslag voor het besturingssysteem.

NODE_EXTRA_CA_CERTS=[path_to_secure_access_root_certificate]

Stap 2: Visual Studio Code opnieuw starten

Sluit en start Visual Studio Code opnieuw om ervoor te zorgen dat de nieuwe configuratie van de omgevingsvariabele van kracht wordt voor de Claude Code-extensie.

Stap 3: Start Umbrella (Secure Access) Agent opnieuw op

Start de Umbrella Agent-service opnieuw om te zorgen voor een correcte certificaatverwerking nadat de omgevingsvariabele is gewijzigd.

Stap 4: Resolutie controleren

Test de Claude Code-extensiefunctie binnen Visual Studio Code om te bevestigen dat de SSL-verificatiefout is opgelost en Claude Code normaal werkt.

Opmerking: eerdere pogingen om dit probleem op te lossen door api.anthropic.com uit te sluiten van SSL-decodering in Cisco Secure Access-regels of certificaten rechtstreeks in Visual Studio te installeren, hebben het probleem niet opgelost, omdat het probleem specifiek was voor de Node.js-runtime-omgeving die wordt gebruikt door de Claude Code-extensie.

Oorzaak

De hoofdoorzaak van dit probleem is een Node.js-configuratievereiste voor SSL-certificaatvertrouwen. Node.js-gebaseerde extensies, zoals de Claude Code-extensie in Visual Studio, vereisen een expliciete configuratie van de certificeringsinstantie via de omgevingsvariabele NODE_EXTRA_CA_CERTS om te vertrouwen op het onderscheppen van certificaten, zelfs wanneer de basiscertificeringsinstantie al is geïnstalleerd in de vertrouwenswinkel voor het besturingssysteem.

Wanneer Cisco Secure Access SSL-decodering uitvoert op verkeer naar api.anthropic.com, presenteert het zijn eigen certificaat aan de clienttoepassing. Hoewel webbrowsers toegang kunnen krijgen tot de vertrouwenswinkel van het besturingssysteem om dit certificaat te valideren, moeten Node.js-toepassingen de variabele NODE_EXTRA_CA_CERTS expliciet configureren om het basiscertificaat voor beveiligde toegang te vertrouwen. Zonder deze configuratie kan de Node.js-runtime de SSL-certificaatketen niet valideren, wat resulteert in de SSL-certificaatverificatiefout.