> ## Documentation Index > Fetch the complete documentation index at: https://docs.bettertoken.ai/llms.txt > Use this file to discover all available pages before exploring further. # Configuração avançada do CC Switch para provedores BetterToken > Gerencie provedores BetterToken, mapeamentos de modelos e configurações de proxy para Claude Code, Claude Desktop, Codex CLI, OpenCode e OpenClaw no CC Switch. 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](https://github.com/farion1231/cc-switch/releases). ```bash theme={null} brew tap farion1231/ccswitch brew install --cask cc-switch ``` Baixe o instalador `CC-Switch-v{version}-Windows.msi` mais recente ou a versão portátil `.zip` em [GitHub Releases](https://github.com/farion1231/cc-switch/releases). Baixe a versão `.deb`, `.rpm` ou `.AppImage` mais recente em [GitHub Releases](https://github.com/farion1231/cc-switch/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 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. * **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. * 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. 3. Em **Model Mapping**, clique em **Fetch Model List** 4. 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. 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. Esta aba é para GPT, Kimi, GLM e outros provedores não Claude. Para o provedor Claude, use a [configuração direta do Claude Desktop](/pt-br/faq/claude-desktop-bettertoken-api). Abra o CC Switch, selecione o ícone **Claude Desktop** na barra de ferramentas superior e clique em **+** no canto superior direito. Mude para Claude Desktop no CC Switch e clique no botão de mais para adicionar um provedor. * **Provider Name**: use um nome identificável, como `BetterToken-GPT` * **API Key**: sua BetterToken API Key * **API Endpoint**: `https://www.bettertoken.ai` Informe Provider Name, API Key e API Endpoint para Claude Desktop no CC Switch. Selecione **OpenAI Responses API (Requires routing)** em **API Format** e clique em **Fetch Models**. Mapeie Sonnet, Opus, Fable e Haiku para o ID de modelo que deseja usar: | Função do modelo | Modelo solicitado | | ---------------- | ----------------- | | Sonnet | `YOUR_MODEL_ID` | | Opus | `YOUR_MODEL_ID` | | Fable | `YOUR_MODEL_ID` | | Haiku | `YOUR_MODEL_ID` | Selecione OpenAI Responses API e configure o mapeamento de modelos do Claude Desktop no CC Switch. Copie um ID de modelo atual da model plaza ou da caixa de diálogo **Setup** da API Key. Ative **Declare 1M** somente quando a model plaza indicar que o modelo aceita uma janela de contexto de 1M. Salve o provedor, defina-o como **In use** e ative o proxy no canto superior esquerdo. O provedor BetterToken para Claude Desktop está ativo e o proxy CC Switch está habilitado. Encerre completamente o Claude Desktop e abra-o novamente. **Gateway** no canto inferior esquerdo confirma que a configuração está ativa. Escolha um modelo mapeado no menu de modelos da caixa de mensagem. Claude Desktop mostra Gateway após reiniciar e oferece os modelos mapeados pelo CC Switch. 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 Página Codex no CC Switch, com Codex selecionado na parte superior e o botão de adicionar no canto superior direito para criar um provedor. * **Provider Name**: `BetterToken` * **Base URL**: `https://www.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** Página de edição do provedor Codex no CC Switch, mostrando onde informar Provider Name, API Key e Base URL. Clique em **Fetch Models** e escolha um ID de modelo atual na model plaza. Codex não requer o proxy CC Switch. Salve o provedor e alterne o Codex para BetterToken. O CC Switch grava os arquivos correspondentes de autenticação e configuração do Codex. Depois de salvar, volte à lista e confirme que a entrada BetterToken está marcada como **In Use**. Lista de provedores Codex no CC Switch, com BetterToken selecionada e marcada como em uso. 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**. * **Provider Name**: `BetterToken` * **Base URL**: `https://www.bettertoken.ai/v1` * **API Key**: sua BetterToken API Key * **API Format**: `OpenAI Compatible` Use **Fetch Models** quando possível. Se precisar informar o modelo manualmente, use um ID de modelo atual de **provedor GPT** da model plaza da BetterToken. O OpenCode lê diretamente a configuração salva do provedor e não requer o proxy CC Switch. Salve o provedor e alterne o OpenCode para BetterToken. 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**. * **Provider Name**: `BetterToken` * **Base URL**: `https://www.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`. 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 o provedor e alterne o OpenClaw para BetterToken. ## 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](/pt-br/faq/codex/official-login-third-party-api). ## 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 * Detalhes do Claude Code: [Claude Code](/pt-br/ai-tools/claude-code) * Configuração direta do provedor Claude para Claude Desktop: [Claude Desktop](/pt-br/faq/claude-desktop-bettertoken-api) * Detalhes do Codex: [Codex](/pt-br/ai-tools/codex) * Detalhes do OpenCode: [OpenCode](/pt-br/ai-tools/opencode) * Detalhes do OpenClaw: [OpenClaw](/pt-br/ai-tools/openclaw) ## FAQ relacionada * [Usar modelos externos e Codex no Claude Desktop](/pt-br/faq/claude-desktop/third-party-models) * [API compatível com OpenAI vs. API compatível com Anthropic](/pt-br/faq/concepts/openai-compatible-vs-anthropic-compatible) * [MCP vs. API Key e Base URL](/pt-br/faq/concepts/mcp-vs-api-key-base-url) * [O que são model\_provider, base\_url e wire\_api?](/pt-br/faq/codex/model-provider-base-url-wire-api) * [Como configurar uma API compatível com OpenAI no Cline](/pt-br/faq/cline/openai-compatible-api)