https://bettertoken.ai e x-api-key e reinicie o Claude Desktop. Para GPT, Codex ou outro provedor que não seja Claude, use o guia de endpoint personalizado do Claude Desktop.
Configurações principais
Pré-requisitos
- Crie e copie uma BetterToken API Key
- Confirme que a API Key pode usar modelos do provedor Claude
Separe a assinatura da cobrança da API
As solicitações do Gateway usam sua BetterToken API Key e o saldo da BetterToken. Elas não consomem nem ampliam o limite de uma assinatura Claude. Trate a assinatura e a API como caminhos separados de acesso e cobrança. Antes de usar a configuração em trabalho real:- Crie uma BetterToken API Key dedicada ao Claude Desktop.
- Envie uma mensagem de teste curta e sem dados sensíveis pelo Gateway.
- Abra o Dashboard da BetterToken e confirme o modelo, o status, os Token de input, output e cache e a cobrança.
- Revogue a Key e crie outra se ela aparecer em uma captura de tela, repositório ou log público.
Instalação
Instale ou atualize para a versão mais recente no site do Claude Desktop e inicie o Claude Desktop.Configuração manual
1
Ative o modo de desenvolvedor
No Claude Desktop, escolha Help → Troubleshooting → Enable Developer Mode na barra de menus do macOS.
2
Abra as configurações de inferência de terceiros
Após reiniciar, escolha Developer → Configure Third-Party Inference… na barra de menus do macOS.
3
Informe as configurações de API da BetterToken
Selecione Gateway e informe:
O Claude Desktop busca os modelos Claude disponíveis após selecionar o esquema de autenticação. Clique em Apply locally.
Teste a conexão
Clique em Save & Restart. Selecione Continue with Gateway e envie uma mensagem curta. A configuração está ativa quando Gateway aparece no canto inferior esquerdo e a mensagem recebe uma resposta normal.
Alterne entre modelos
Abra o seletor de modelos e escolha outro modelo Claude retornado pelo Gateway. Se ele não aparecer, abra novamente Configure Third-Party Inference…, clique em Apply locally e reinicie o Claude Desktop.Erros comuns
Configuração avançada
Para usar GPT, Kimi, GLM ou outro provedor que não seja Claude no Claude Desktop, siga a aba Claude Desktop no CC Switch. O CC Switch gerencia API Format, mapeamento de modelos, proxy e reinicialização.Provedores compatíveis
Os status se aplicam ao método de configuração do BetterToken descrito nesta página.
O que significa cada método de configuração
O que significa cada método de configuração
- Configuração avançada: instale o CC Switch e use um proxy local, conversão de protocolo ou mapeamento de modelos.
- Configuração manual: informe a API Key, a Base URL e o Model.
Guias relacionados
- Usar modelos de terceiros no Claude Desktop
- Configurar a BetterToken no CC Switch
- Configurar um provedor personalizado no Codex CLI
- Baixar a versão mais recente do CC Switch
Detalhes técnicos
Endpoint do Gateway e autenticação
Endpoint do Gateway e autenticação
Use
https://bettertoken.ai, compatível com Anthropic, como Gateway base URL, sem /v1. Selecione x-api-key como esquema de autenticação.