CC Switch

CC Switch é um gerenciador de configuração de desktop de código aberto para ferramentas de programação com IA. Ele ajuda desenvolvedores a manter endpoints de provedores, credenciais, modelos, servidores MCP, skills, prompts, sessões e uso em uma única interface. Ele não fornece uma assinatura de modelo de IA nem substitui os clientes de programação que gerencia.

Recursos

• Alterna campos de conexão de provedores preservando configurações não relacionadas do cliente.
• Escolha entre conexões diretas, roteamento local com conversão e failover ou agregação baseada em modelos para clientes compatíveis. A agregação não oferece failover.
• Gerencia Claude Code, Claude Desktop, Codex, Gemini CLI, Grok Build, OpenCode, OpenClaw, Hermes, Pi e MiniMax Code; as integrações variam individualmente.
• Sincroniza configurações compatíveis de MCP e skills e edita prompts específicos de ferramentas.
• Lê etapas de sessões, resultados de ferramentas e alterações; pesquisa e exporta conversas e retoma sessões compatíveis.
• Examina o uso de solicitações, custos estimados, cotas de provedores e informações da conta quando as integrações oferecem suporte.

Instalação e requisitos

Instale o cask para Mac registrado com brew install --cask cc-switch ou baixe o DMG oficial, abra-o e copie CC Switch para Aplicativos. A versão oficial para Mac é universal para Apple Silicon e Intel, requer macOS12 ou posterior e, segundo o mantenedor, é assinada e notarizada. O cask não lista dependências extras de formula nem conflitos explícitos. Configure um provedor ou importe uma configuração existente compatível e selecione o modo desejado. As ferramentas de programação gerenciadas têm seus próprios requisitos de instalação, execução, permissões e conta.

O mantenedor também fornece pacotes para Windows10+ (incluindo versões ARM) e compilações Linux x86_64/ARM64. O Linux requer glibc2.35+ e WebKitGTK4.1, por exemplo Ubuntu22.04+ ou Debian12+; RHEL/Rocky/Alma8–9 não são compatíveis com os requisitos declarados para a versão. Não foi confirmada nenhuma edição móvel compatível. Os requisitos mínimos de RAM e espaço em disco para instalação não foram publicados no guia citado. O DMG verificado para Mac, versão 4.0.4, tem33,926,314bytes; esse é o tamanho do download, não o espaço ocupado após a instalação.

Compatibilidade e atualizações

O roteamento e a agregação dependem do gateway local e do suporte ao protocolo upstream. A agregação do Claude Code requer Claude Code2.1.243 ou posterior. Reinicie Codex, Gemini CLI e Grok Build quando solicitado após a troca; as alterações de agregação do Claude Code são aplicadas sem reinicialização. A rede do WSL tem requisitos próprios para localhost.

A versão 4.0 altera a forma como as configurações são preservadas e remove trechos de configuração comuns. Ela migra o banco de dados para o esquema 20 e cria automaticamente um backup em ~/.cc-switch/backups/; um cliente da série 3.x não consegue abrir o novo banco de dados. Consulte as notas oficiais de atualização antes de reverter a versão ou alterar configurações existentes. Predefinições de provedores existentes não são substituídas silenciosamente por novos padrões.

Contas, custos e licença

CC Switch é lançado sob a licença MIT (copyright de Jason Young) e pode ser usado sem comprar uma assinatura do CC Switch. Cada provedor de IA tem autenticação, cobranças de assinatura/API e condições de serviço próprias. São necessárias chaves de API e credenciais de conta para as operações pertinentes do provedor; estimativas de custo das solicitações não são faturas. Por padrão, os dados de configuração e sessão são armazenados localmente em ~/.cc-switch. A sincronização por nuvem/WebDAV e os endpoints de retransmissão envolvem escolhas próprias de conta e tratamento de dados.

Fontes: Projeto oficial e requisitos, Notas de versão em inglês 4.0.4, Licença.