CC-Switch Claude Code
Esta página explica apenas uma coisa: adicionar ou selecionar um Provedor no CC Switch e aplicá-lo ao Claude Code. Não se trata de um tutorial de configuração direta do Claude Code; se você deseja modificar diretamente o arquivo de configuração do Claude Code, consulte a configuração da CLI do Claude Code.
O que esta página explica
O objetivo do CC Switch é ajudar você a gerenciar Provedores de forma centralizada e sincronizar as configurações com as ferramentas de destino. Para o Claude Code, foque em verificar o protocolo Claude / Anthropic, a Key e o nome do modelo. Não use diretamente um endereço compatível com OpenAI como endereço do Claude, a menos que o provedor informe explicitamente que oferece suporte ao Claude Code.
Confirmações antes de começar
| O que confirmar | Como verificar | Por que |
|---|---|---|
| O Claude Code já consegue iniciar | Confirme no terminal ou cliente que o Claude Code abre normalmente | O CC Switch cuida apenas da troca de configurações; ele não gerencia a instalação do Claude Code |
| O provedor oferece suporte ao Claude Code | Você pode ver instruções relacionadas a Claude / Anthropic / Claude Code no painel ou na documentação | Provedores que oferecem apenas interfaces compatíveis com OpenAI podem não funcionar com o Claude Code |
| A Key e o nome do modelo são utilizáveis | Você consegue ver tokens, Keys, listas de modelos ou instruções de modelos disponíveis no painel | Digitar o nome do modelo incorretamente causará diretamente o erro de modelo não encontrado |
| Altere apenas uma ferramenta de destino primeiro | Inicialmente, selecione apenas o Claude Code | É mais fácil identificar onde está o problema durante a resolução de falhas |
Como preencher os campos
| Configuração | Como preencher | Atenção para iniciantes |
|---|---|---|
| Nome do Provedor | Escreva um nome fácil de identificar | Por exemplo, 'Provedor principal Claude'; não escreva apenas números |
| Ferramenta de Destino / Predefinição | Selecione o Claude Code ou a predefinição relacionada ao Claude | Não selecione Codex, OpenAI ou Gemini |
| Base URL | Copie o link de API fornecido pelo painel do provedor para Claude / Anthropic | Nem todos os provedores compartilham a mesma Base URL da OpenAI |
| API Key | Copie a Key completa gerada no painel | Ela também costuma ser chamada de token, Key, chave secreta |
| Nome do Modelo | Copie exatamente o nome do modelo Claude suportado pelo painel | Não abrevie por conta própria e não substitua o nome de exibição pelo nome do modelo |
Aplicar ao Claude Code
- Abra o CC Switch e acesse a área de gerenciamento de Provedores.
- Adicione um novo Provedor ou escolha uma configuração de provedor que você já criou.
- Selecione as predefinições relacionadas à ferramenta de destino Claude Code.
- Preencha o nome do Provedor, Base URL, API Key e o nome do modelo em ordem.
- Após salvar, execute Apply / Switch para aplicar o Provedor atual ao Claude Code.
- Se a página avisar que é necessário reiniciar o terminal ou a ferramenta de destino, feche a sessão atual do Claude Code e abra-a novamente.
Testar se está funcionando
Durante os testes, envie primeiro uma pergunta extremamente curta e não abra diretamente o projeto real. Desde que haja uma resposta normal, isso indica que a Key, Base URL, nome do modelo e a sincronização com a ferramenta de destino estão basicamente funcionais.
claude "Please reply only: CC-Switch Claude Code is active"