CC-Switch · Common Steps
CC-Switch is an open-source configuration manager for Claude Code / Codex / Gemini CLI. It uses a graphical interface to manage each CLI's provider configuration and switch between them with one click, sparing you from editing config files by hand.
CC-Switch is a third-party open-source tool, not maintained by Tianshu. You can review its open-source repository before installing.
What it can do
- ✅ One-click API config switching — quickly switch between multiple providers
- ✅ Visual configuration management — manage all configs from a GUI
- ✅ MCP server management
- ✅ System tray shortcuts
Download
Go to CC-Switch's GitHub Releases page and download the installer for your system:
Visit GitHub Releases, choose the .msi installer, then download and install it.
After installing, run the CC-Switch main program.# Add the tap
brew tap farion1231/ccswitch
# Install CC-Switch
brew install --cask cc-switch
# Then find and launch CC-Switch in Launchpad / Applications# Check the latest version number on GitHub Releases and replace the filename below
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.debComplete the environment check first
Don't skip this
CC-Switch only helps you manage configuration; actually running the models still depends on Node.js and the relevant CLI (Claude Code / Codex). Complete the Environment Check and CLI Install first to make sure node, claude and codex all run properly.
Add Tianshu as a custom provider
CC-Switch ships with some provider templates, but you need to add Tianshu manually as a custom provider:
- Provider name:
天枢/tianshu(custom) - Base URL: see the per-CLI guides (Claude Code uses
https://tian-shu.org, Codex useshttps://tian-shu.org/v1) - API Key: a token created in the Console → Token Management with the right group
Next steps
Continue by CLI type: