Skip to main content
Se o Claude Desktop já estiver conectado à API, mas não retornar uma resposta normal ou mostrar um erro como este:
Isso nem sempre significa que a API Key seja inválida ou que o certificado do servidor tenha expirado. Segundo relatos de usuários, o Claude Desktop pode falhar ao se conectar diretamente a um Gateway de terceiros em redes com proxy, redes restritas ou ambientes com inspeção rigorosa de certificados. Use o roteamento local do Claude Desktop no CC Switch e ative Needs model mapping. O Claude Desktop se conectará primeiro a um endereço local e o CC Switch encaminhará a solicitação para BetterToken.
Claude Desktop exibindo API Error: Unable to connect to API: SSL certificate has expired.

​
Quando usar esta solução

  • O Claude Desktop está conectado à API, mas as mensagens não recebem resposta.
  • A página mostra SSL certificate has expired.
  • A página de Chat parece começar a responder, mas continua carregando.
  • Você usa uma rede com proxy, restrita ou corporativa, ou um ambiente com inspeção de certificados.
  • A mesma API Key funciona em outras ferramentas.

​
Correção

1

Confirme que o provedor está ativo no CC Switch

Abra o CC Switch, confirme que o provedor BetterToken está selecionado e ative o interruptor superior de roteamento / proxy.
O provedor BetterToken está selecionado no CC Switch e o interruptor superior de roteamento está ativo.
2

Ative Needs model mapping

Abra a página de edição do provedor e ative Needs model mapping.Isso permite que o CC Switch mapeie as três funções aceitas pelo Claude Desktop para os modelos realmente disponíveis na BetterToken:
  • claude-sonnet-*
  • claude-opus-*
  • claude-haiku-*
Página de edição do provedor no CC Switch com Needs model mapping ativo e configurações de API Format e Model mapping.
3

Escolha o API Format

Em API Format, escolha:
4

Preencha Model mapping

Preencha Model mapping. Use os IDs de modelo disponíveis no momento na model plaza.Se o modelo aceitar uma janela de contexto de 1M, ative Declare 1M.
5

Salve e teste novamente

Clique em Save. Volte ao Claude Desktop, selecione o modelo novamente e envie uma mensagem de teste.Quando a configuração está correta, o Claude Desktop chama BetterToken pela rota local do CC Switch. Isso geralmente corrige o erro SSL ou a falta de resposta.
Claude Desktop retorna uma resposta após ativar o roteamento local e o mapeamento de modelos no CC Switch.

​
Observações

  • Não copie nomes de modelos de capturas antigas sem conferir. Use os IDs disponíveis no momento na model plaza.
  • Armazene a API Key no provedor do CC Switch. Não a coloque em documentação pública, capturas de tela ou logs de chat.
  • Se a falha continuar, verifique o interruptor superior de roteamento, o provedor ativo, o preenchimento completo de Model mapping e se um firewall local bloqueia 127.0.0.1.

​
Documentos relacionados