Skip to main content
O CC Switch é um aplicativo desktop multiplataforma para gerenciar provedores no Claude Code, Claude Desktop, Codex, OpenCode e OpenClaw. Esta página centraliza a configuração avançada. Comece pela página de configuração direta de cada ferramenta e use o CC Switch somente quando precisar trocar de provedor ou executar um modelo não nativo.

​
Instale o CC Switch

Homebrew é a opção mais simples. Você também pode baixar o .dmg ou .zip 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://www.bettertoken.ai
  • Claude Desktop com um provedor não Claude requer a versão mais recente do Claude Desktop e CC Switch v3.16.5 ou posterior
  • Codex, OpenCode e OpenClaw usam o protocolo compatível com OpenAI; portanto, sua Base URL é https://www.bettertoken.ai/v1
  • Prepare um ID de modelo atual de provedor GPT 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://www.bettertoken.ai com https://www.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

1

Abra Claude Code no CC Switch e adicione um provedor

Abra o CC Switch, mude para Claude Code e clique em Add Provider.
Página do Claude Code no CC Switch, com o botão de adicionar no canto superior direito para criar um provedor.
2

Preencha os campos básicos

  • Provider Name: BetterToken-claude (ou outro nome que facilite a identificação do provedor)
  • Base URL: https://www.bettertoken.ai
  • API Key: sua BetterToken API Key
  • API Format: OpenAI Responses API
Os marcadores numerados da captura correspondem a estes campos:
  1. Provider Name
  2. API Key
  3. Base URL
Página de edição do provedor Claude Code no CC Switch, mostrando onde informar Provider Name, API Key e API Endpoint.
3

Configure o mapeamento de modelos conforme o provedor

  • Se você usar o provedor Claude, geralmente não precisa alterar opções avançadas nem mapeamento de modelos
  • Se você usar o provedor GPT, conclua a configuração adicional abaixo:
  1. Abra Advanced Options
  2. Defina API Format como OpenAI Responses API
Seção de opções avançadas no CC Switch, com API Format definido como OpenAI Responses API.
  1. Em Model Mapping, clique em Fetch Model List
  2. Escolha explicitamente valores nos menus de Primary Model, Thinking Model, Haiku Default Model, Sonnet Default Model e Opus Default Model
Seção de mapeamento de modelos no CC Switch, mostrando Fetch Model List e os mapeamentos de modelos Primary, Thinking, Haiku, Sonnet e Opus.
Todos esses modelos devem usar IDs de modelo atuais do provedor GPT da model plaza da BetterToken.
4

Salve, alterne e decida se ativa o proxy

Depois de salvar, volte à lista de provedores:
  1. Marque o provedor BetterToken como ativo
  2. Se usar o provedor Claude, não é necessário ativar o proxy CC Switch no canto superior esquerdo
  3. Se usar o provedor GPT, ative o proxy CC Switch
A captura abaixo mostra BetterToken-claude ativado na lista de provedores. Ative o proxy CC Switch no canto superior esquerdo somente quando usar o provedor GPT.
Lista de provedores do CC Switch com BetterToken-claude selecionado e marcado como In Use.

​
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

O CC Switch pode preservar o login oficial do Codex ao trocar para um provedor externo e combinar sessões oficiais e externas em um único histórico. Reinicie o Codex após ativar essas opções. Consulte manter o login oficial do Codex e o histórico unificado de sessões.

​
Problemas comuns

  • Não adicione /v1 à Base URL do Claude Code
  • Quando Claude Code usar o provedor GPT, defina API Format como OpenAI Responses API em Advanced Options
  • Quando Claude Code usar o provedor Claude, não é necessário ativar o proxy CC Switch
  • 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://www.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 a troca não tiver efeito, confirme que BetterToken é o provedor ativo no CC Switch e reinicie o cliente ou gateway afetado, como descrito acima

​
Páginas relacionadas

​
FAQ relacionada