O que é o CC Switch?
O README do GitHub chama o CC Switch de “All-in-One Manager” das ferramentas de programação com IA e promete troca de provedor com um clique, sem editar à mão arquivos de configuração JSON, TOML ou YAML. É um aplicativo de desktop que edita e, opcionalmente, faz proxy das configurações de ferramentas instaladas separadamente.
- Linha atual: o projeto está na versão 4; a versão mais recente do GitHub é a v4.0.35 e as três versões mais recentes foram publicadas em dias consecutivos
- Documentação: guias de provedores, roteamento, MCP, Skills e sessões ficam na documentação oficial
- Autor: a LICENSE cita Jason Young; nenhuma empresa é nomeada nos arquivos do repositório nem no site
- O que ele não é: não é um modelo de IA, nem uma API hospedada, nem um gateway de equipe
O que o CC Switch faz
Segundo o README, os recursos abrangem provedores, roteamento, recursos compartilhados, uso, sessões e sincronização.
- Provedores — mais de 90 predefinições, incluindo AWS Bedrock, NVIDIA NIM e relays da comunidade, ou uma configuração personalizada; troca pela bandeja do sistema para Claude Code, Claude Desktop, Codex, Gemini CLI e Grok Build
- Roteamento — converte entre os formatos Anthropic Messages, OpenAI Chat Completions, OpenAI Responses e Gemini Native, de modo que o GPT pode rodar no Claude Code e o Claude no Codex; uma fila de failover com disjuntor passa para o próximo provedor quando uma solicitação falha
- Agregação — Claude Code e Codex mostram modelos de vários provedores em uma só lista e cada solicitação vai para o provedor do modelo escolhido; segundo o README, esse modo não tem failover
- Recursos compartilhados — servidores MCP sincronizados com as ferramentas escolhidas, Skills instaladas do skills.sh ou do GitHub, arquivos de prompt por ferramenta (CLAUDE.md, AGENTS.md, GEMINI.md) e projetos salvos que trocam toda uma configuração de uma vez
- Uso e sessões — estatísticas de tokens, custos e acertos de cache lidas dos registros de sessão locais mesmo sem roteamento, cota restante nos cartões de provedor e uma visualização de leitura do histórico de sessões com busca e exportação em Markdown
- Sincronização e links — sincronização opcional por WebDAV ou S3, deep links
ccswitch://para importar provedores e interface em oito idiomas
Obter o CC Switch
O caminho mais fácil é o instalador do seu sistema na página de GitHub Releases, ou o Homebrew no macOS. O site oficial aponta para as mesmas versões.
Opção | Como obter |
|---|---|
| Windows (o mais fácil) | CC-Switch-v4.0.35-Windows.msi ou o ZIP portátil, em Releases |
| macOS | .dmg em Releases ou brew install --cask cc-switch |
| Linux | .deb, .rpm ou .AppImage (x86_64 e ARM64); Arch: paru -S cc-switch-bin |
| Site | ccswitch.io |
| Documentação | ccswitch.io/en/docs |
| Código-fonte (GitHub) | farion1231/cc-switch |
A versão atual é a 4.0.35, lançada em 18 de novembro de 2026; a última atualização upstream foi o commit mais recente de 19 de novembro de 2026, segundo o GitHub, verificado em 19 de novembro de 2026. O README exige Windows 10 ou posterior, macOS 12 ou posterior e Linux com glibc 2.35+ e WebKitGTK 4.1 (RHEL, Rocky e Alma 8–9 ainda não são suportados); diz que a versão para macOS é assinada e notarizada, o que a PromptQuorum não verificou. Nenhum instalador foi executado.
Instalação e primeiros passos
Estes passos seguem o Quick Start do README, verificado em 19 de novembro de 2026; a PromptQuorum não os executou.
- 1Instale o aplicativo
Why it matters: Execute o instalador do seu sistema ou, no macOS, `brew install --cask cc-switch`. - 2Deixe-o importar sua configuração
Why it matters: Segundo o README, na primeira execução o CC Switch importa sua configuração existente do Claude Code, Codex, Gemini CLI e Grok Build como um provedor chamado `default` e adiciona um provedor oficial para cada ferramenta. - 3Adicione um provedor
Why it matters: Selecione uma ferramenta na barra lateral, clique em “+”, escolha uma predefinição ou uma configuração personalizada e informe sua chave. - 4Troque e reinicie
Why it matters: Clique em “Enable” no provedor; o Claude Code não precisa reiniciar, enquanto Codex, Gemini CLI e Grok Build exigem um novo terminal ou sessão de CLI.
Preço, licença e privacidade
O CC Switch é gratuito e de código aberto; o README e o site não citam plano pago, e o uso é cobrado pelo provedor que você adicionar.
- Licença: MIT, copyright 2025 Jason Young, segundo o repositório
- Fluxo de dados: o SECURITY.md descreve o CC Switch como um aplicativo de desktop local, sem backend na nuvem operado pelo projeto; as solicitações que você roteia vão para o provedor ou relay escolhido, que as vê
- Proxy local: o mesmo arquivo diz que o endereço e a porta são configuráveis e podem ser vinculados a uma interface que não seja loopback; verifique essa configuração antes de expô-lo
- Dados remotos: segundo o SECURITY.md, o aplicativo busca um JSON de preços de modelos e avatares de provedores (verificado lá para a v3.18.0)
- Sincronização: a sincronização por WebDAV ou S3 é opcional e, segundo o README, grava em um armazenamento de sua escolha
- Assinaturas: o README avisa que usar uma assinatura do ChatGPT, Copilot ou Grok fora do cliente oficial pode violar os termos de serviço do fornecedor e pede que você avalie o risco por conta própria
- Patrocinadores: o README traz banners e códigos de desconto de serviços de relay de terceiros; a PromptQuorum não avaliou nenhum deles
Quem deveria usar o CC Switch?
O CC Switch serve para desenvolvedores que já usam CLIs de programação com IA e sabem adicionar suas próprias chaves de API.
Use o CC Switch se
- Você alterna entre várias ferramentas de programação com IA ou provedores de API e edita à mão os arquivos de configuração delas
- Você quer GPT no Claude Code, Claude no Codex ou failover automático entre provedores
- Você quer gerenciar servidores MCP e Skills em um só lugar
Procure outra opção se
- Você precisa de uma empresa com política de privacidade publicada como operadora de dados
- Você precisa de um servidor gateway compartilhado para uma equipe; o SECURITY.md não descreve modelo multiusuário
- Você usa RHEL, Rocky ou Alma 8–9, que o README lista como não suportados
CC Switch vs. outros roteadores e gateways
O CC Switch gerencia as configurações das ferramentas de programação em uma máquina, enquanto as ferramentas abaixo são servidores gateway. Veja o Diretório de IA local para o catálogo completo.
- LiteLLM — um gateway único compatível com OpenAI para mais de 100 APIs de provedores, com roteamento e acompanhamento de custos; um servidor que você opera para aplicações ou uma equipe. Veja a análise do LiteLLM.
- ClawRouter — um roteador auto-hospedado para agentes autônomos que decide localmente qual modelo chamar; descrito em nossa análise como um proxy local em Node.js com CLI, e não como um aplicativo de desktop com interface gráfica. Veja a análise do ClawRouter.
- AIClient2API — um proxy auto-hospedado que converte os protocolos de cliente do Gemini CLI, Codex, Grok, Kiro e Antigravity em uma única API compatível com OpenAI. Antes de usar assinaturas dessa forma, observe o aviso sobre os termos dos provedores em “Preço, licença e privacidade”. Veja a análise do AIClient2API.
Perguntas frequentes
O CC Switch inclui um modelo de IA?
Não. Ele edita e faz proxy das configurações de outras ferramentas; os modelos e a cobrança vêm do provedor que você adicionar, como uma API oficial, uma plataforma de nuvem como o AWS Bedrock ou um relay.
Trocar de provedor sobrescreve meus plugins e hooks?
Segundo o README, apenas campos-chave como endpoint, chave, nome do modelo e protocolo são substituídos, enquanto plugins, hooks, permissões, MCP e comentários permanecem. Antes da primeira reescrita, ele também faz backup de cada arquivo de configuração em ~/.cc-switch/backups/live-first-write/.
Por que os modelos agregados não aparecem no Codex?
O Codex lê a lista de modelos apenas na inicialização, então depois de mudar a Agregação você precisa reiniciar o Codex por completo; segundo o README, fechar o terminal não basta, porque um único daemon em segundo plano é compartilhado.
Qual é o site oficial?
O README e o llms.txt oficial indicam ccswitch.io como o único site oficial e dizem que outros domínios com esse nome não são afiliados ao projeto.
