Passos gerais do CC-Switch
O CC Switch é uma ferramenta open-source para gerenciamento unificado de CLIs de programação com IA. Ele resolve principalmente um problema: quando você usa Claude Code, Codex, Gemini CLI, OpenCode e outras ferramentas ao mesmo tempo, evita ter que alterar Key, Base URL, nome do modelo e configurações de MCP individualmente para cada ferramenta.
Informações oficiais Downloads e documentação estão sujeitos ao site oficial.
O que é esta ferramenta e para que serve
É adequada para quem já instalou várias ferramentas de programação com IA via linha de comando. Iniciantes que utilizam apenas um aplicativo de chat não precisam aprender o CC Switch logo de início; se você começou a usar Claude Code, Codex CLI e Gemini CLI simultaneamente, vale a pena utilizá-lo para gerenciar provedores de forma unificada.
Para quais cenários ela é adequada
Compartilhar provedores entre múltiplos CLIsO mesmo provedor de IA ou API oficial precisa ser usado simultaneamente no Claude Code, Codex e Gemini CLI.
Alternar provedores com frequênciaPor exemplo, usar a conta oficial durante o dia, alternar para o provedor durante testes ou usar modelos diferentes em projetos distintos.
MCP / Skills unificadosA documentação oficial do CC Switch também inclui recursos de gerenciamento entre ferramentas como MCP e Skills. Iniciantes podem começar aprendendo a alternar provedores primeiro.
Baixar, instalar e abrir pela primeira vez
Primeiro, confirme a interface principal Após a instalação, abra o programa principal e certifique-se de ver opções como Provider, MCP e Skills à esquerda. Iniciantes devem mexer apenas em Provider primeiro, sem alterar MCP e prompts ao mesmo tempo.
- Acesse o site oficial do CC Switch ou os Releases no GitHub para baixar a versão atual.
- Usuários de Windows devem escolher o pacote de instalação adequado ao sistema; usuários de macOS / Linux devem seguir as instruções oficiais de instalação.
- Após instalar, abra o programa principal e confirme que a interface carrega normalmente.
- Se o sistema bloquear a inicialização, confirme primeiro que a origem é o repositório oficial ou site oficial e siga as instruções do sistema para permitir.
Adicionar Provider
Referência para adicionar Provider Aqui, confirme primeiro o local de acesso e os campos para adicionar um novo Provider; os campos para diferentes CLIs de destino podem ter pequenas variações dependendo da versão.
- Primeiro, confirme separadamente que Claude Code, Codex CLI e Gemini CLI abrem por conta própria. O CC Switch é uma ferramenta de gerenciamento, ele não instala esses CLIs para você.
- Baixe o instalador pelo repositório oficial do CC Switch ou site oficial. Não baixe de discos virtuais ou fontes desconhecidas.
- Abra o CC Switch e acesse a página de gerenciamento de Provider.
- Adicione um novo Provider e dê a ele o nome do provedor, por exemplo, 'Provedor de IA X'.
- Insira a Base URL, a API Key e o nome do modelo fornecidos pelo painel do seu provedor. Os campos podem variar conforme a ferramenta de destino, portanto preencha de acordo com os avisos na tela do CC Switch.
- Após salvar, selecione a ferramenta de destino a aplicar, como Claude Code, Codex ou Gemini CLI.
- Após executar Switch / Apply, siga o aviso para reiniciar o terminal ou CLI correspondente. Segundo a documentação oficial, a maioria das ferramentas exige reinicialização após a troca, enquanto o Claude Code atualmente suporta troca dinâmica (hot switching).
| Item de configuração | Como preencher | Atenção para iniciantes |
|---|---|---|
| Provider Name | Informe o nome do provedor ou finalidade | Por exemplo, 'provedor principal' e 'chave oficial reserva'; evite usar apenas 1, 2, 3 |
| Base URL | Copie o link da API do painel do provedor | Decida se inclui /v1 de acordo com os exemplos no painel do provedor |
| API Key | Copie a chave completa | Não tire capturas de tela públicas e não use o nome de observação como chave |
| Model Name | Copie a lista de modelos | Claude Code, Codex e Gemini CLI podem exigir nomes de modelo diferentes |
| Target Tool | Selecione o CLI para sincronizar | Nem todo provedor funciona com todas as ferramentas. Em caso de falha, teste primeiro selecionando apenas uma ferramenta. |
Verifique separadamente de acordo com o CLI de destino
| Ferramenta de destino | O que verificar primeiro? | Página de detalhes |
|---|---|---|
| Claude Code | Endereço da interface Claude / Anthropic, Key, nome do modelo Claude | CC-Switch Claude Code |
| Codex CLI | Endereço compatível com OpenAI / Codex, Key, nomes de modelo Codex disponíveis | CC-Switch Codex |
| Gemini CLI | Métodos de autenticação relacionados a Google / Gemini ou Vertex | CC-Switch Gemini |
| CC-Switch-CLI | Método de configuração via linha de comando quando não há interface gráfica | Uso do CC-Switch-CLI |
O CC Switch é o ponto de gerenciamento unificado, mas isso não significa que um mesmo Provider funcione em todos os CLIs indistintamente. Claude, Codex e Gemini têm protocolos de interface diferentes; se falhar, selecione apenas uma ferramenta de destino para testar primeiro.
Como testar após alternar
Após alternar, não vá direto para projetos reais. Primeiro, envie uma pergunta bem curta em um diretório vazio ou projeto de teste para confirmar que a requisição está realmente indo para o provedor selecionado.
Comando mínimo de teste após alternar
claude "Please reply only: Configuration successful" codex "Please reply only: Configuration successful" gemini "Please reply only: Configuration successful"Se algum CLI continuar usando a configuração antiga, feche a janela atual do terminal e abra-o novamente para tentar. Evite modificar manualmente arquivos de configuração enquanto usa o CC Switch para alterar o mesmo item simultaneamente.