Claude Desktop

Claude Desktop: errores SSL y problemas de carga

Corrige la falta de respuesta y los errores de certificado SSL caducado de Claude Desktop mediante el enrutamiento local de CC Switch y Needs model mapping.

Si Claude Desktop ya está conectado a la API, pero no devuelve una respuesta normal o muestra un error como este:

API Error: Unable to connect to API: SSL certificate has expired

Esto no siempre significa que la API Key sea incorrecta ni que el certificado del servidor haya caducado realmente. Según los informes de usuarios, Claude Desktop puede fallar al conectarse directamente a un API Gateway de terceros desde redes con proxy, redes restringidas o entornos con una inspección estricta de certificados.

Usa el enrutamiento local de Claude Desktop en CC Switch y activa Needs model mapping. Claude Desktop se conectará primero a una dirección local y CC Switch reenviará la solicitud a BetterToken.

Claude Desktop muestra el error API Error: Unable to connect to API: SSL certificate has expired.

Cuándo usar esta solución

Claude Desktop está conectado a la API, pero los mensajes no reciben respuesta.
La página muestra SSL certificate has expired.
La página Chat parece empezar a responder, pero permanece cargando.
Usas una red con proxy, una red restringida, una red empresarial o un entorno con inspección de certificados.
La misma API Key funciona en otras herramientas.

Solución

Confirma que el proveedor de CC Switch esté activo

Abre CC Switch, confirma que el proveedor BetterToken esté seleccionado y activa el interruptor superior de enrutamiento / proxy.

El proveedor BetterToken está seleccionado en CC Switch y el interruptor superior de enrutamiento está activado.

Activa Needs model mapping

Abre la página de edición del proveedor y activa Needs model mapping.

Esto permite que CC Switch asigne las tres funciones de modelo que acepta Claude Desktop a los modelos disponibles realmente en BetterToken:

claude-sonnet-*
claude-opus-*
claude-haiku-*

Página de edición del proveedor de CC Switch con Needs model mapping activado y los ajustes API Format y Model mapping.

Elige el formato de API

En API Format, elige:

Anthropic Messages (Native)

Completa Model mapping

Completa Model mapping. Usa los ID de modelo disponibles actualmente en la model plaza.

Función del modelo	Nombre visible en el menú	Modelo solicitado
Sonnet	`claude-sonnet-5`	`claude-sonnet-5`
Opus	`claude-opus-4-8`	`claude-opus-4-8`
Haiku	`claude-haiku-4-5`	`claude-haiku-4-5-20251001`

Si el modelo admite una ventana de contexto de 1M, activa Declare 1M.

Guarda y vuelve a probar

Haz clic en Save. Vuelve a Claude Desktop, selecciona de nuevo el modelo y envía un mensaje de prueba.

Cuando la configuración es correcta, Claude Desktop llama a BetterToken mediante la ruta local de CC Switch. Esto suele corregir el error SSL o la falta de respuesta.

Claude Desktop devuelve una respuesta después de activar el enrutamiento local y el mapeo de modelos en CC Switch.

Notas

No copies a ciegas los nombres de modelos de capturas antiguas. Usa los ID de modelo disponibles actualmente en la model plaza.
Guarda la API Key en el proveedor de CC Switch. No la incluyas en documentación pública, capturas de pantalla ni registros de chat.
Si el problema continúa, comprueba el interruptor superior de enrutamiento de CC Switch, el proveedor activo, que Model mapping esté completo y si un firewall local bloquea 127.0.0.1.