Resolver error de verificación de certificado SSL de Claude AI en Visual Studio con acceso seguro

Problema

Claude AI no puede funcionar dentro de la aplicación de Visual Studio y devuelve un error de API relacionado con un error de verificación de certificado SSL.

El mensaje de error específico que se muestra es:

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

Este problema se produce específicamente cuando se intenta utilizar Claude AI desde el entorno de desarrollo de Visual Studio, mientras que el acceso a Claude a través de un explorador web funciona normalmente desde el mismo extremo. La extensión de código Claude no puede establecer una conexión segura con la API Anthropic debido a problemas de confianza de certificados SSL en el entorno de tiempo de ejecución Node.js.

Entorno

• Cisco Secure Access (Umbrella) con descifrado SSL habilitado

• Código de Visual Studio con extensión de código Claude

• Entorno de extensión basado en Node.js

• CA raíz de Cisco Secure Access instalada en el almacén de confianza del equipo

• api.anthropic.com permitidos en las políticas de Cisco Secure Access con el descifrado habilitado

Resolución

El problema se resolvió configurando la variable de entorno NODE_EXTRA_CA_CERTS para confiar explícitamente en el certificado raíz de Cisco Secure Access para las aplicaciones basadas en Node.js.

Siga estos pasos para resolver el error de verificación del certificado SSL:

Paso 1: Configurar variable de entorno NODE_EXTRA_CA_CERTS

Establezca la variable de entorno del sistema NODE_EXTRA_CA_CERTS para que apunte a la ruta del archivo del certificado raíz de Cisco Secure Access. Esta configuración permite que las aplicaciones Node.js confíen en la autoridad de certificados interceptora incluso cuando la CA raíz ya está instalada en el almacén de confianza del sistema operativo.

NODE_EXTRA_CA_CERTS=[path_to_secure_access_root_certificate]

Paso 2: Reiniciar código de Visual Studio

Cierre y reinicie Visual Studio Code para asegurarse de que la nueva configuración de la variable de entorno surta efecto para la extensión de código de la cláusula.

Paso 3: Reinicio del agente de Umbrella (Secure Access)

Reinicie el servicio de agente de Umbrella para garantizar una gestión de certificados adecuada después del cambio de la variable de entorno.

Paso 4: Verificar resolución

Pruebe la funcionalidad de extensión de código de Claude en Visual Studio Code para confirmar que se ha resuelto el error de comprobación de SSL y que el código de Claude funciona normalmente.

Causa

La causa raíz de este problema es un requisito de configuración de Node.js para la confianza de certificados SSL. Las extensiones basadas en Node.js, como la extensión Claude Code en Visual Studio, requieren una configuración explícita de la entidad emisora de certificados mediante la variable de entorno NODE_EXTRA_CA_CERTS para confiar en los certificados interceptores, incluso cuando la entidad emisora de certificados raíz ya está instalada en el almacén de confianza del sistema operativo.

Cuando Cisco Secure Access realiza el descifrado SSL en el tráfico a api.anthropic.com, presenta su propio certificado a la aplicación cliente. Mientras que los exploradores web pueden tener acceso al almacén de confianza del sistema operativo para validar este certificado, las aplicaciones Node.js necesitan que la variable NODE_EXTRA_CA_CERTS se configure explícitamente para confiar en el certificado raíz de Secure Access. Sin esta configuración, el motor en tiempo de ejecución Node.js no puede validar la cadena de certificados SSL, lo que provoca el error de verificación del certificado SSL.

Contenido relacionado

• Soporte técnico y descargas de Cisco

Historial de revisiones

Revisión	Fecha de publicación	Comentarios
1.0	06-Aug-2026	Versión inicial