Configure o BetterToken no CC Switch

O CC Switch é um aplicativo de desktop opcional para gerenciar API Keys, endpoints e modelos do Claude Code, Claude Desktop, Codex CLI, OpenCode e OpenClaw.

Instale o CC Switch

macOS

Homebrew é a opção mais simples. Você também pode baixar o .dmg ou .zip mais recente em GitHub Releases.

brew tap farion1231/ccswitch
brew install --cask cc-switch

Windows

Baixe o instalador CC-Switch-v{version}-Windows.msi mais recente ou a versão portátil .zip em GitHub Releases.

Linux

Baixe a versão .deb, .rpm ou .AppImage mais recente em GitHub Releases.

O que preparar

• BetterToken API Key (cadastre-se aqui)
• Claude Code usa o protocolo Anthropic; portanto, sua Base URL é https://bettertoken.ai
• Codex, OpenCode e OpenClaw usam o protocolo compatível com OpenAI; portanto, sua Base URL é https://bettertoken.ai/v1
• Prepare um ID de modelo atual de para Codex, OpenCode e OpenClaw. Você pode copiá-lo da model plaza da BetterToken ou deixar o CC Switch buscá-lo em /v1/models

Na primeira inicialização, o CC Switch importa automaticamente as configurações já encontradas no computador. Você pode manter o provedor oficial como alternativa e adicionar a BetterToken ao lado dele.

A BetterToken usa dois modos de acesso: Anthropic e compatível com OpenAI. Para evitar misturar https://bettertoken.ai com https://bettertoken.ai/v1, crie provedores por aplicativo em vez de tentar forçar Claude Code e ferramentas compatíveis com OpenAI em um único provedor universal.

Adicione um provedor BetterToken

Claude Code

No CC Switch, selecione Claude Code e clique em Add Provider.

Conecte o Claude Code com sua BetterToken API Key, a Base URL https://bettertoken.ai e o Model ID escolhido.

• Provider Name: BetterToken
• API Key: YOUR_API_KEY
• API Endpoint: https://bettertoken.ai

Use o formato Anthropic Messages API. Informe os Model IDs escolhidos em Model Mapping e salve.

Copie o Model ID exato da model plaza.

Salve a configuração, ative o BetterToken e reinicie completamente o cliente.

Claude Desktop

O Claude Desktop aceita apenas modelos Claude. Essa é uma limitação do cliente Claude Desktop.

Abra a página separada de Claude Desktop no CC Switch para adicionar um provedor ou importar provedores existentes do Claude Code. Confira os Model IDs Claude importados e o modo de conexão antes de ativar; consulte o manual oficial do Claude Desktop.

Para configurar diretamente no Claude Desktop, siga o guia do Claude Desktop: selecione Gateway, use a Base URL https://bettertoken.ai, sua BetterToken API Key e Gateway auth scheme x-api-key. Clique em Apply Changes para salvar e reiniciar o Claude Desktop.

Codex

No CC Switch atual, faça o login oficial primeiro para preservá-lo. Abra Configurações → Configuração de aplicativos → Codex, ative Preservar login oficial ao trocar sem assumir o controle e adicione ou ative BetterToken. Não substitua o arquivo de login oficial por uma chave de terceiros.

Abra Codex no CC Switch e adicione um provedor

Abra o CC Switch, mude para Codex e clique em Add Provider. Se o CC Switch pedir uma predefinição, prefira OpenAI Compatible ou Custom.

Os marcadores numerados da captura correspondem a estas ações:

1. Mude para Codex
2. Clique em Add Provider no canto superior direito

Preencha os campos básicos

• Provider Name: BetterToken
• Base URL: https://bettertoken.ai/v1
• API Key: sua BetterToken API Key

Se mudar para uma exibição de configuração personalizada, confirme que a configuração subjacente usa wire_api = "responses".

Os marcadores numerados da captura correspondem a estes campos:

1. Provider Name
2. API Key
3. Base URL

Busque e mapeie um modelo

Clique em Fetch Models e escolha um ID de modelo atual na model plaza. Codex não requer o proxy CC Switch.

Salve e alterne

Salve e ative BetterToken. A API Key de terceiros vai para o provider em config.toml; o seletor de preservação determina se o auth.json oficial permanece.

Depois de salvar, volte à lista e confirme que a entrada BetterToken está marcada como In Use.

OpenCode

Abra OpenCode no CC Switch e adicione um provedor

Abra o CC Switch, mude para OpenCode e clique em Add Provider. Se o CC Switch pedir uma predefinição, prefira OpenAI Compatible ou Custom.

Preencha os campos básicos

• Provider Name: BetterToken
• Base URL: https://bettertoken.ai/v1
• API Key: sua BetterToken API Key
• API Format: OpenAI Compatible

Escolha o modelo padrão

Use Fetch Models quando possível. Se precisar informar o modelo manualmente, use um ID de modelo atual de da model plaza da BetterToken.

O OpenCode lê diretamente a configuração salva do provedor e não requer o proxy CC Switch.

Salve e alterne

Adicione o provedor no CC Switch e selecione o provedor e o modelo BetterToken no OpenCode. O CC Switch salva esse provedor junto com os demais provedores do OpenCode.

OpenClaw

Abra OpenClaw no CC Switch e adicione um provedor

Abra o CC Switch, mude para OpenClaw e clique em Add Provider. Se o CC Switch pedir uma predefinição, prefira OpenAI Compatible ou Custom.

Preencha os campos básicos

• Provider Name: BetterToken
• Base URL: https://bettertoken.ai/v1
• API Key: sua BetterToken API Key
• API Format: OpenAI Responses API

Se estiver editando uma configuração personalizada de provedor do OpenClaw, confirme que api está definido como openai-responses.

Escolha o modelo padrão

Use Fetch Models quando possível. Se precisar informar o modelo manualmente, use um ID de modelo atual de provedor GPT.

O OpenClaw usa diretamente a configuração salva do provedor e não requer o proxy CC Switch.

Salve e alterne

Adicione o provedor no CC Switch e selecione o provedor e o modelo BetterToken no OpenClaw. O CC Switch salva esse provedor junto com os demais provedores do OpenClaw.

Aplique as alterações salvas

Depois de salvar e trocar de provedor, reinicie o cliente ou gateway afetado antes de verificar a configuração.

• Claude Code: encerre completamente a sessão atual do Claude Code e inicie-a novamente.
• Claude Desktop: encerre completamente o aplicativo, abra-o novamente e confirme que Gateway aparece no canto inferior esquerdo.
• Codex: reinicie o processo atual do Codex ou abra uma nova sessão de terminal.
• OpenCode: encerre a sessão atual do OpenCode e inicie-a novamente.
• OpenClaw: execute openclaw gateway restart e use /new, /status e /model no Discord.

Recursos avançados específicos do CC Switch

CC Switch pode preservar o login oficial de Codex na troca direta. Histórico unificado de sessões Codex é opcional e só afeta a lista resume do CLI; não é necessário para o desktop atual. Continuar uma sessão com outro provider pode falhar; crie outra após trocar. Veja login oficial e histórico.

Problemas comuns

• Não adicione /v1 à Base URL do Claude Code

• Quando Claude Desktop usar um provedor não Claude, ative o proxy CC Switch e reinicie completamente o aplicativo

• Codex, OpenCode e OpenClaw devem usar https://bettertoken.ai/v1

• Quando Codex, OpenCode ou OpenClaw solicitar um modelo, use um ID de modelo de provedor GPT

• Se Fetch Models falhar, verifique a API Key e a Base URL; depois cole o ID de modelo manualmente

• Se as alterações não tiverem efeito, confirme que BetterToken está ativo no CC Switch para Codex ou selecionado dentro do OpenCode/OpenClaw. Depois, reinicie o cliente ou gateway afetado, como descrito acima.

• Se o Codex bloquear o envio após o fim da cota oficial, preservar o login oficial pode manter esse bloqueio. Siga as instruções da versão oficial: mude para o modo direto, desative Keep official login for direct switches em Settings → App config → Codex, ative BetterToken e reinicie completamente o Codex. Isso usa o modo API Key e remove o acesso aos recursos que exigem o login oficial; restaure a configuração que preserva o login quando a cota for renovada.

Páginas relacionadas

• Detalhes do Claude Code: Claude Code

• Configuração direta do provedor Claude para Claude Desktop: Claude Desktop

• Detalhes do Codex: Codex

• Detalhes do OpenCode: OpenCode

• Detalhes do OpenClaw: OpenClaw

• Compare as ferramentas compatíveis

• Erros da API, códigos de status e limites de requisições

FAQ relacionada

• Endpoint do Claude Desktop
• API compatível com OpenAI vs. API compatível com Anthropic
• MCP vs. API Key e Base URL
• O que são model_provider, base_url e wire_api?
• Como configurar uma API compatível com OpenAI no Cline