CC Switch
Install CC Switch and import, enable, or switch HopBase providers for Claude Code and Codex CLI.
CC Switch is a desktop configuration manager for Windows and macOS. Use it when you prefer a graphical setup or regularly switch Claude Code and Codex providers. It manages configuration; it does not install Node.js or either CLI.
Before you start
Choose the key by model
Install the target CLI first: Claude Code or Codex CLI.
Choose the key by model: Claude uses a Claude-group key, GPT uses an OpenAI / Codex-group key, and GLM uses a GLM-group key.
Update CC Switch: use the latest release; GLM routing requires version 3.17.0 or later.
Install CC Switch
Download the current .dmg from CC Switch Releases. Install and open the app once so your browser can launch it during import.
Import from the HopBase console
Select the correct package key
Open Key Management and find the key for the model family you plan to use.
Start the import
Open the key's ··· menu, select Import CCS, then choose Claude Code or Codex CLI. If you use both, import each client separately.
Review and confirm
In the browser prompt, select Open CC Switch. Verify the provider name, Base URL, and masked key, then select Import.
Enable the provider
Open the matching Claude Code or Codex tab in CC Switch, find the imported provider, and select Enable. The provider should now appear as active.
Verify in a new terminal
Run claude or codex and send a short test. If an existing Codex terminal still uses the previous provider, close it and open a new terminal.
Use GLM-5.2 with Claude Code
GLM-5.2 uses OpenAI Chat Completions, while Claude Code sends Anthropic Messages. CC Switch must keep its local router running to translate between them.
| Field | Value |
|---|---|
| CC Switch version | 3.17.0 or later |
| Provider tab | Claude Code |
| Request URL | https://api.hop-base.com/v1 |
| API format | OpenAI Chat Completions (routing required) |
| Default fallback model | glm-5.2 |
After saving the provider, open Settings → Routing → Local routing, enable the main routing switch, then enable Claude Code. Return to the provider card, select Enable, and leave CC Switch running in the background. See GLM-5.2 for model mappings and verification details.
Troubleshooting
Browser did not open CC Switch: launch it manually once, then retry Import CCS.
Provider did not change: open the matching client tab and select Enable.
Command not found or an old provider remains: install Node.js LTS and the target CLI, then use a new terminal.
GLM routing error: confirm the API format, enable both local-routing switches, and keep CC Switch running. More errors are covered in Troubleshooting.