Pular para o conteúdo principal
PromptQuorumFeito para humanos. Estruturado para IA.
Início/LLMs locais avançados
Overview & Reference

Análise do CC Switch: gerenciador de provedores para ferramentas de programação com IA

·8 min de leituraPor · Fundador do PromptQuorum · Mecanismo de descoberta de IA de pesos abertos e código aberto

O CC Switch é um aplicativo de desktop gratuito com licença MIT para Windows, macOS e Linux que troca o provedor de API do Claude Code, Codex, Gemini CLI e de outras ferramentas de programação com IA. É uma camada de configuração e roteamento, não um modelo de IA, e na última atualização a PromptQuorum não encontrou política de privacidade em ccswitch.io nem nos arquivos do repositório.

Principais conclusões

  • Cobertura: o README lista doze ferramentas gerenciadas, do Claude Code e Codex ao OpenCode, Pi e Kimi Code; o site oficial lista dezesseis
  • Segundo o README, a troca substitui apenas o endpoint, a chave e o modelo; plugins, hooks, servidores MCP e comentários permanecem
  • Três modos: Direto, Roteamento (conversão de formato e failover) e Agregação (modelos de vários provedores em uma lista)
  • Servidores MCP, Skills e prompts são adicionados uma vez e sincronizados com as ferramentas que você escolher
  • Não inclui nenhum modelo; no modo Direto, as solicitações vão para o provedor que você adicionar, enquanto o modo Roteamento pode redirecioná-las a outro provedor, e o aplicativo busca dados de preços

📍 Em uma frase

O CC Switch é um aplicativo de desktop gratuito com licença MIT que troca provedores de API e gerencia servidores MCP, Skills e prompts de ferramentas de programação com IA como Claude Code, Codex e Gemini CLI.

💬 Em termos simples

Você escolhe uma predefinição de provedor, informa sua chave e clica em “Enable”; a ferramenta passa a falar com esse provedor. O roteamento local opcional converte formatos de API no seu computador, então uma ferramenta feita para um provedor pode usar outro.

O CC Switch (ccswitch.io, código-fonte em github.com/farion1231/cc-switch) é um aplicativo de desktop gratuito e de código aberto para Windows, macOS e Linux que gerencia os provedores de API, servidores MCP, Skills e prompts de ferramentas de programação com IA como Claude Code, Codex e Gemini CLI. Esta análise cobre o que ele faz, como instalá-lo, sua licença, as declarações do projeto relevantes para a privacidade e seu lugar ao lado de outros roteadores e gateways do diretório. A PromptQuorum não testou o aplicativo na prática; cada afirmação vem do site oficial, do repositório do GitHub e da sua versão mais recente, verificados em 19 de novembro de 2026.

Análise do CC Switch: gerenciador de provedores para ferramentas de programação com IA

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
Siteccswitch.io
Documentaçãoccswitch.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.

  1. 1
    Instale o aplicativo
    Why it matters: Execute o instalador do seu sistema ou, no macOS, `brew install --cask cc-switch`.
  2. 2
    Deixe-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.
  3. 3
    Adicione 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.
  4. 4
    Troque 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.

Comparar no diretório

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.

Fontes

← Voltar para LLMs locais avançados

MCP