Conecte modelos Claude ao Claude Desktop com a BetterToken
Conecte o Claude Desktop ao BetterToken com um endpoint Gateway, uma API Key e um modelo Claude. Confira a autenticação, os modelos e as etapas de reinicialização.
O Claude Desktop aceita apenas modelos Claude. Essa é uma limitação do cliente Claude Desktop.
Copie um Model ID Claude disponível na model plaza, salve e reinicie o Claude Desktop.
Configurações principais
| Campo | Valor |
|---|---|
| API Key | BetterToken API Key |
| Base URL | https://bettertoken.ai |
| Modelo | Copie um Model ID Claude disponível na model plaza, salve e reinicie o Claude Desktop. |
Pré-requisitos
- Crie e copie uma BetterToken API Key
- Copie o Model ID exato da model plaza.
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
Ative o modo de desenvolvedor
No Claude Desktop, escolha Help → Troubleshooting → Enable Developer Mode na barra de menus do macOS.
Clique em Enable na janela de confirmação e reinicie o Claude Desktop.
Abra as configurações de inferência de terceiros
Após reiniciar, escolha Developer → Configure Third-Party Inference… na barra de menus do macOS.
Informe as configurações de API da BetterToken
Selecione Gateway e informe:
| Campo | Valor |
|---|---|
| Gateway base URL | https://bettertoken.ai |
| Credential kind | Static API key |
| Gateway API key | Sua BetterToken API Key |
| Gateway auth scheme | x-api-key |
O Claude Desktop busca os modelos Claude disponíveis após selecionar o esquema de autenticação. Clique em Apply Changes para salvar a configuração neste dispositivo e reiniciar o Claude Desktop. Versões antigas podem exibir Apply locally seguido de Save & Restart.
Teste a conexão
Após o Claude Desktop reiniciar, 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… e clique em Apply Changes para salvar e reiniciar o Claude Desktop.
Erros comuns
| Problema | Correção |
|---|---|
| O Gateway não conecta | Use exatamente https://bettertoken.ai em Gateway base URL. Não acrescente /v1. |
A solicitação retorna 401 | Copie a BetterToken API Key novamente e confirme que o esquema é x-api-key. |
| Nenhum modelo Claude aparece | Copie um Model ID Claude disponível na model plaza, salve e reinicie o Claude Desktop. |
| A configuração não é aplicada | Encerre completamente o Claude Desktop, abra-o novamente e escolha Continue with Gateway. |
Configuração avançada
Para gerenciar várias configurações em um aplicativo, consulte CC Switch.
Guias relacionados
Detalhes técnicos
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.
