CC-Switch · Passos Comuns

O CC-Switch é um gerenciador de configuração open-source para Claude Code / Codex / Gemini CLI. Ele usa uma interface gráfica para gerenciar a configuração de provedor de cada CLI e alternar entre elas com um clique, poupando você de editar arquivos de configuração à mão.

O CC-Switch é uma ferramenta open-source de terceiros, não mantida pela Tianshu. Você pode revisar o repositório open-source antes de instalar.

O que ele faz

✅ Alternância de configuração de API com um clique — troque rapidamente entre vários provedores
✅ Gerenciamento visual de configuração — gerencie todas as configurações por uma GUI
✅ Gerenciamento de servidores MCP
✅ Atalhos na bandeja do sistema

Download

Acesse a página de Releases do CC-Switch no GitHub e baixe o instalador para o seu sistema:

WindowsmacOS (Homebrew)Linux (Debian/Ubuntu)

text

Acesse o GitHub Releases, escolha o instalador .msi e depois baixe e instale.
Após a instalação, execute o programa principal do CC-Switch.

bash

# Adicione o tap
brew tap farion1231/ccswitch
# Instale o CC-Switch
brew install --cask cc-switch
# Depois encontre e abra o CC-Switch no Launchpad / Aplicativos

bash

# Verifique o número da versão mais recente no GitHub Releases e substitua o nome do arquivo abaixo
wget https://github.com/farion1231/cc-switch/releases/latest/download/cc-switch_x.x.x_amd64.deb
sudo dpkg -i cc-switch_x.x.x_amd64.deb

Conclua primeiro a verificação de ambiente

Não pule esta etapa

O CC-Switch apenas ajuda você a gerenciar a configuração; rodar os modelos de fato ainda depende do Node.js e do CLI correspondente (Claude Code / Codex). Conclua primeiro a Verificação de Ambiente e Instalação do CLI para garantir que node, claude e codex rodem corretamente.

Adicione a Tianshu como provedor personalizado

O CC-Switch vem com alguns modelos de provedor, mas você precisa adicionar a Tianshu manualmente como provedor personalizado:

Nome do provedor: 天枢 / tianshu (personalizado)
Base URL: consulte os guias de cada CLI (Claude Code usa https://tian-shu.org, Codex usa https://tian-shu.org/v1)
API Key: um token criado no Console → Gerenciamento de Token com o grupo correto

Próximos passos

Continue pelo tipo de CLI:

CC-Switch · Passos Comuns ​

O que ele faz ​

Download ​

Conclua primeiro a verificação de ambiente ​