convez.ai
MCP Server
farion1231

cc-switch

farion1231/cc-switch

Ver no GitHub
ExcelentePluginScore · de 0 a 100

A cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Gemini CLI & Hermes Agent. Only official website: ccswitch.io

Instalação

$npx convez-ai farion1231/cc-switch

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
155 mil
Forks
10 mil
Acompanhando
280
Saúde
100%
Último commit
há 1 dia
Versão
v4.0.35
Issues abertas
877
Contribuidores
165

README em português

CC Switch

O Gerenciador Tudo-em-Um para Claude Code, Claude Desktop, Codex, Gemini CLI, OpenCode, OpenClaw e Hermes Agent

Version Platform Built with Tauri Downloads

🌐 O Único Site Oficial: ccswitch.io

Inglês | 中文 | 日本語 | Deutsch | Changelog

❤️Patrocinadores

Quer aparecer aqui?

Obrigado à APINEBULA por patrocinar este projeto! A APINEBULA, uma plataforma de agregação de IA de nível empresarial sob a Galaxy Video Bureau, aproveita recursos extensivos da plataforma para fornecer aos desenvolvedores, equipes e empresas acesso estável e econômico às APIs de modelos de linguagem grandes. A plataforma integra os principais modelos completos como Claude, GPT e Gemini, permitindo que você se conecte aos melhores modelos de IA do mundo através de uma única API, com preços a partir de apenas 10% do custo original. Projetada para programação em IA, desenvolvimento de Agentes e integração de sistemas empresariais, a APINEBULA suporta alta concorrência empresarial, contratos formais, transferências bancárias corporativas e serviços de faturamento. A APINEBULA oferece descontos especiais para nossos usuários do software: registre-se usando este link e insira o código promocional "ccswitch" durante seu primeiro recarga para obter um desconto de 10%.
:---:---
A Atlas Cloud é uma plataforma de inferência de IA multimodal que oferece aos desenvolvedores uma única API de IA para acessar geração de vídeo, geração de imagem e APIs LLM. Em vez de gerenciar integrações com múltiplos fornecedores, você se conecta uma vez e obtém acesso unificado a mais de 300 modelos curados em todas as modalidades. Confira o novo plano de codificação da Atlas Cloud para um acesso à API ainda mais econômico!
:---:---
Obrigado ao CCSub por patrocinar este projeto! O CCSub é uma plataforma de retransmissão de APIs de IA estável e acessível — sua substituição direta para uma assinatura do Claude.ai. Uma única chave de API dá acesso ao Opus 4.8, Sonnet, Haiku, GPT-5, Gemini e DeepSeek da Claude em cerca de 30% do custo direto da API, sem necessidade de VPN a partir de qualquer lugar do mundo. Compatível com o Claude Code, Codex, Cursor, Cline, Continue, Windsurf e todas as principais ferramentas de codificação por IA. Registre-se via este link e ganhe $5 em crédito gratuito ao se inscrever.
:---:---
Obrigado à Unity2.ai por patrocinar este projeto! A Unity2.ai é uma plataforma de retransmissão de APIs de modelos de IA de alto desempenho para desenvolvedores individuais, equipes e empresas. Longo tempo confiada pelas principais empresas na China, ela atende mais de 30 bilhões de tokens por dia e suporta alta concorrência no nível de 5.000 RPM. Ela oferece faturamento baseado em saldo, bônus de primeiro recarga, assinaturas combinadas, faturamento corporativo e suporte dedicado. Registre-se via este link para ganhar $2 em créditos, mais outros $10 por se juntar ao grupo oficial — até $12 em créditos gratuitos!

Por que o CC Switch?

A codificação moderna impulsionada pela IA depende de ferramentas como Claude Code, Claude Desktop, Codex, Gemini CLI, OpenCode, OpenClaw e Hermes — mas cada uma possui seu próprio formato de configuração. Trocar provedores de API significa editar manualmente arquivos JSON, TOML ou .env, e não existe uma maneira unificada para gerenciar MCP (Model Context Protocol) e Skills em múltiplas ferramentas.

CC Switch oferece um único aplicativo desktop para gerenciar todas as ferramentas de IA suportadas. Em vez de editar arquivos de configuração à mão, você obtém uma interface visual para importar provedores com um clique, alternar entre eles instantaneamente, com mais de 50 presets de provedor embutidos, gerenciamento unificado de MCP e Skills, e troca rápida na bandeja do sistema — tudo apoiado por um banco de dados SQLite confiável com gravações atômicas que protegem suas configurações contra corrupção.

  • Um Aplicativo, Sete Ferramentas — Gerencie o Claude Code, Claude Desktop, Codex, Gemini CLI, OpenCode, OpenClaw e Hermes a partir de uma única interface
  • Sem Mais Edição Manual — Mais de 50 presets de provedores incluindo AWS Bedrock, NVIDIA NIM e retransmissões da comunidade; basta escolher e alternar
  • Gerenciamento Unificado de MCP & Skills — Um painel para gerenciar servidores MCP e Skills no Claude, Codex, Gemini, OpenCode e Hermes com sincronização bidirecional
  • Troca Rápida na Bandeja do Sistema — Alterne provedores instantaneamente pelo menu da bandeja, sem necessidade de abrir o aplicativo completo
  • Sincronização em Nuvem — Sincronize dados de provedor entre dispositivos via Dropbox, OneDrive, iCloud ou servidores WebDAV
  • Multiplataforma — Aplicativo desktop nativo para Windows, macOS e Linux, construído com Tauri 2
  • Utilitários Embutidos — Inclui vários utilitários para confirmação de login no primeiro lançamento, contornamento de assinatura, sincronização de extensão de plugin e muito mais

Screenshots

Interface PrincipalAdicionar Provedor
Interface PrincipalAdicionar Provedor

Recursos

Registro de Alterações Completo | Notas da Versão

Gestão de Provedores

  • 7 ferramentas suportadas, 50+ presets — Claude Code, Claude Desktop, Codex, Gemini CLI, OpenCode, OpenClaw e Hermes; copie sua chave e importe com um clique
  • Provedores universais — Uma configuração sincroniza para o Claude Code, Codex e Gemini CLI
  • Alternância de um clique, acesso rápido na bandeja do sistema, ordenação por arrastar e soltar, importação/exportação

Proxy & Failover (Alternativa)

  • Proxy local com troca em tempo real — Conversão de formato, failover automático, disjuntor térmico (circuit breaker), monitoramento da saúde dos provedores e correção de requisições
  • Tomada de controle no nível do aplicativo — Proxy independente para Claude, Codex ou Gemini, até mesmo em provedores individuais

MCP, Prompts & Skills (Habilidades)

  • Painel unificado MCP — Gerencie servidores MCP entre o Claude Code, Codex, Gemini, OpenCode e Hermes com sincronização bidirecional e importação via Deep Link
  • Prompts — Editor de Markdown com sincronia cruzada entre aplicativos (CLAUDE.md / AGENTS.md / GEMINI.md) e proteção contra sobrescrita (backfill)
  • Skills — Instalação em um clique a partir de repositórios do GitHub ou arquivos ZIP, gerenciamento personalizado de repositório, com suporte a symlinks e cópia de arquivo

Uso & Rastreamento de Custos

  • Painel de uso — Acompanhe gastos, requisições e tokens com gráficos de tendência, logs detalhados de requisições e preços personalizados por modelo

Gerenciador de Sessões & Workspace (Ambiente de Trabalho)

  • Navegue, pesquise e restaure o histórico de conversas entre as fontes de sessão suportadas
  • Editor do workspace (OpenClaw) — Edite arquivos de agentes (AGENTS.md, SOUL.md, etc.) com prévia em Markdown

Sistema & Plataforma

  • Sincronização na nuvem — Diretório personalizado de configuração (Dropbox, OneDrive, iCloud, NAS) e sincronização via servidor WebDAV
  • Deep Link (ccswitch://) — Importe provedores, servidores MCP, prompts e skills via URL
  • Tema Escuro / Claro / Sistema, inicialização automática, atualizador automático, escrita atômica (atomic writes), backups automáticos, i18n (zh/zh-TW/en/ja)

FAQ

O CC Switch suporta sete ferramentas: Claude Code, Claude Desktop, Codex, Gemini CLI, OpenCode, OpenClaw e Hermes. Cada ferramenta possui presets dedicados do provedor e gerenciamento de configuração.

Para a maioria das ferramentas, sim — reinicie seu terminal ou a ferramenta CLI para que as alterações tenham efeito. A exceção é Claude Code, que atualmente suporta troca em tempo real de dados do provedor sem necessidade de reinício.

O CC Switch oferece um recurso "Shared Config Snippet" para passar dados comuns (além de chaves API e endpoints) entre provedores. Vá em "Editar Provedor" → "Painel de Configuração Compartilhada" → clique em "Extrair do Provedor Atual" para salvar todos os dados comuns. Ao criar um novo provedor, marque "Escrever Configuração Compartilhada" (ativado por padrão) para incluir dados de plugins no novo provedor. Todos os seus itens de configuração são preservados no provedor padrão importado quando você inicia o aplicativo pela primeira vez.

O CC Switch para macOS é assinado digitalmente e notariado pela Apple. Você pode baixar e instalá-lo diretamente — sem etapas extras. Recomendamos usar o instalador .dmg.

O CC Switch segue um princípio de design de "intrusão mínima" — mesmo se você desinstalar o aplicativo, suas ferramentas CLI continuarão funcionando normalmente. O sistema sempre mantém uma configuração ativa, pois excluir todas as configurações tornaria a ferramenta CLI correspondente inutilizável. Se raramente usa uma ferramenta CLI específica, pode ocultá-la nas Configurações. Para voltar ao login oficial, veja a próxima pergunta.

Adicione um provedor oficial da lista de presets. Após alternar para ele, execute o fluxo de Logout / Login e, em seguida, você pode alternar livremente entre o provedor oficial e provedores de terceiros. O Codex suporta alternância entre diferentes provedores oficiais, facilitando a troca entre múltiplas contas Plus ou Team.

  • Banco de Dados: ~/.cc-switch/cc-switch.db (SQLite — provedores, MCP, prompts, skills)
  • Configurações locais: ~/.cc-switch/settings.json (preferências da interface em nível de dispositivo)
  • Backups: ~/.cc-switch/backups/ (auto-rotação, mantém os 10 mais recentes)
  • Skills: ~/.cc-switch/skills/ (vinculado por padrão aos aplicativos correspondentes)
  • Backups de Skills: ~/.cc-switch/skill-backups/ (criado automaticamente antes da desinstalação, mantém os 20 mais recentes)

Documentação

Para guias detalhados sobre cada recurso, confira o Manual do Usuário — cobrindo gerenciamento de provedores, MCP/Prompts/Skills, proxy e failover, entre outros.

Início Rápido

Uso Básico

  1. Adicionar Provedor: Clique em "Add Provider" → Escolha um preset ou crie uma configuração personalizada
  2. Alternar Provedor:
    • Interface Principal: Selecione o provedor → Clique em "Enable" (Ativar)
    • Bandeja do Sistema: Clique diretamente no nome do provedor (efeito instantâneo)
  3. Aplicação das Alterações: Reinicie seu terminal ou a ferramenta CLI correspondente para aplicar as alterações (Claude Code não requer reinício)
  4. Voltar ao Oficial: Adicione um preset "Official Login", reinicie a ferramenta CLI e, em seguida, siga o fluxo de login/OAuth dela

MCP, Prompts, Skills & Sessões

  • MCP: Clique no botão "MCP" → Adicione servidores via templates ou configuração personalizada → Ative/desative sincronização por aplicativo
  • Prompts: Clique em "Prompts" → Crie presets com editor Markdown → Ative para sincronizar com arquivos ao vivo
  • Skills: Clique em "Skills" → Navegue repositórios GitHub → Instale com um clique nos aplicativos suportados
  • Sessões: Clique em "Sessions" → Navegue, pesquise e restaure histórico de conversas entre fontes de sessão suportadas

Nota: Na primeira execução, você pode importar manualmente configurações existentes da ferramenta CLI como provedor padrão.

Download & Instalação

Requisitos do Sistema

  • Windows: Windows 10 ou superior
  • macOS: macOS 12 (Monterey) ou superior
  • Linux: Ubuntu 22.04+ / Debian 11+ / Fedora 34+ e outras distribuições principais

Usuários Windows

Baixe o instalador mais recente CC-Switch-v{version}-Windows.msi ou a versão portátil CC-Switch-v{version}-Windows-Portable.zip da página Releases.

Usuários macOS

Método 1: Instalar via Homebrew (Recomendado)

brew install --cask cc-switch

Atualização:

brew upgrade --cask cc-switch

Método 2: Download Manual

Baixe CC-Switch-v{version}-macOS.dmg (recomendado) ou .zip da página Releases.

Nota: O CC Switch para macOS é assinado digitalmente e notariado pela Apple. Você pode instalá-lo e abri-lo diretamente.

Usuários Arch Linux

Instale via paru (Recomendado)

paru -S cc-switch-bin

Usuários Linux

Baixe a versão mais recente para Linux na página de Liberações:

  • CC-Switch-v{version}-Linux.deb (Debian/Ubuntu)
  • CC-Switch-v{version}-Linux.rpm (Fedora/RHEL/openSUSE)
  • CC-Switch-v{version}-Linux.AppImage (Universal)

Flatpak: Não incluído nas liberações oficiais. Você pode compilá-lo a partir do .deb; veja flatpak/README.md para instruções.

Princípios de Design

┌─────────────────────────────────────────────────────────────┐
│                    Frontend (React + TS)                    │
│  ┌─────────────┐  ┌──────────────┐  ┌──────────────────┐    │
│  │ Components  │  │    Hooks     │  │  TanStack Query  │    │
│  │   (UI)      │──│ (Bus. Logic) │──│   (Cache/Sync)   │    │
│  └─────────────┘  └──────────────┘  └──────────────────┘    │
└────────────────────────┬────────────────────────────────────┘
                         │ Tauri IPC
┌────────────────────────▼────────────────────────────────────┐
│                  Backend (Tauri + Rust)                     │
│  ┌─────────────┐  ┌──────────────┐  ┌──────────────────┐    │
│  │  Commands   │  │   Services   │  │  Models/Config   │    │
│  │ (API Layer) │──│ (Bus. Layer) │──│     (Data)       │    │
│  └─────────────┘  └──────────────┘  └──────────────────┘    │
└─────────────────────────────────────────────────────────────┘

Padrões de Design Principais

  • SSOT (Single Source of Truth): Todos os dados armazenados em ~/.cc-switch/cc-switch.db (SQLite)
  • Armazenamento Duplo-Camada: SQLite para dados sincronizáveis, JSON para configurações no nível do dispositivo
  • Sincronização Bidirecional: Escreva nos arquivos ao vivo na troca e preencha lacunas a partir dos arquivos ao vivos quando editar o provedor ativo
  • Escrita Atômica: O padrão de arquivo temporário + renomeamento previne corrupção da configuração
  • Seguro para Concorrência: Conexão com banco de dados protegida por mutex evita condições de corrida
  • Arquitetura em Camadas: Separação clara (Comandos → Serviços → DAO → Banco de Dados)

Componentes Principais

  • ProviderService: CRUD do provedor, troca, preenchimento e ordenação
  • McpService: Gerenciamento do servidor MCP, import/export, sincronização ao vivo de arquivos
  • ProxyService: Modo proxy local com hot-switching e conversão de formato
  • SessionManager: Navegação pelo histórico de conversas entre fontes de sessão suportadas
  • ConfigService: Import/export de configuração, rotação de backup
  • SpeedtestService: Medição de latência do endpoint da API

Requisitos de Ambiente

  • Node.js 18+
  • pnpm 8+
  • Rust 1.85+
  • Tauri CLI 2.8+

Comandos de Desenvolvimento

# Install dependencies
pnpm install

# Dev mode (hot reload)
pnpm dev

# Type check
pnpm typecheck

# Format code
pnpm format

# Check code format
pnpm format:check

# Run frontend unit tests
pnpm test:unit

# Run tests in watch mode (recommended for development)
pnpm test:unit:watch

# Build application
pnpm build

# Build debug version
pnpm tauri build --debug

Desenvolvimento do Backend em Rust

cd src-tauri

# Format Rust code
cargo fmt

# Run clippy checks
cargo clippy

# Run backend tests
cargo test

# Run specific tests
cargo test test_name

# Run tests with test-hooks feature
cargo test --features test-hooks

Guia de Testes

Testes Frontend:

  • Usa vitest como framework de teste
  • Usa MSW (Mock Service Worker) para simular chamadas da API Tauri
  • Usa @testing-library/react para testes de componentes

Executando Testes:

# Run all tests
pnpm test:unit

# Watch mode (auto re-run)
pnpm test:unit:watch

# With coverage report
pnpm test:unit --coverage

Stack Tecnológica

Frontend: React 18 · TypeScript · Vite · TailwindCSS 3.4 · TanStack Query v5 · react-i18next · react-hook-form · zod · shadcn/ui · @dnd-kit

Backend: Tauri 2.8 · Rust · serde · tokio · thiserror · tauri-plugin-updater/process/dialog/store/log

Testes: vitest · MSW · @testing-library/react

├── src/                        # Frontend (React + TypeScript)
│   ├── components/
│   │   ├── providers/          # Provider management
│   │   ├── mcp/                # MCP panel
│   │   ├── prompts/            # Prompts management
│   │   ├── skills/             # Skills management
│   │   ├── sessions/           # Session Manager
│   │   ├── proxy/              # Proxy mode panel
│   │   ├── openclaw/           # OpenClaw config panels
│   │   ├── settings/           # Settings (Terminal/Backup/About)
│   │   ├── deeplink/           # Deep Link import
│   │   ├── env/                # Environment variable management
│   │   ├── universal/          # Cross-app configuration
│   │   ├── usage/              # Usage statistics
│   │   └── ui/                 # shadcn/ui component library
│   ├── hooks/                  # Custom hooks (business logic)
│   ├── lib/
│   │   ├── api/                # Tauri API wrapper (type-safe)
│   │   └── query/              # TanStack Query config
│   ├── locales/                # Translations (zh/zh-TW/en/ja)
│   ├── config/                 # Presets (providers/mcp)
│   └── types/                  # TypeScript definitions
├── src-tauri/                  # Backend (Rust)
│   └── src/
│       ├── commands/           # Tauri command layer (by domain)
│       ├── services/           # Business logic layer
│       ├── database/           # SQLite DAO layer
│       ├── proxy/              # Proxy module
│       ├── session_manager/    # Session management
│       ├── deeplink/           # Deep Link handling
│       └── mcp/                # MCP sync module
├── tests/                      # Frontend tests
└── assets/                     # Screenshots & partner resources

Contribuindo

Issues e sugestões são bem-vindos!

Antes de enviar PRs, por favor garanta:

  • Passe na verificação de tipos: pnpm typecheck
  • Passe na verificação de formatação: pnpm format:check
  • Passe nos testes unitários: pnpm test:unit

Para novos recursos, abra um issue para discussão antes de enviar o PR. PRs para recursos que não se encaixam bem no projeto podem ser fechados.

Histórico de Estrelas

Gráfico do Histórico de Estrelas

Licença

MIT © Jason Young

Ver o original no GitHub

Bom para

Relacionados