Skip to main content
Si Claude Desktop ya está conectado a la API, pero no devuelve una respuesta normal o muestra un error como este:
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

1

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.
2

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.
3

Elige el formato de API

En API Format, elige:
4

Completa Model mapping

Completa Model mapping. Usa los ID de modelo disponibles actualmente en la model plaza.Si el modelo admite una ventana de contexto de 1M, activa Declare 1M.
5

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.

​
Documentación relacionada