HopBase DocsCC Switch
Create a HopBase key, import it into CC Switch, and use the provider in Codex App, Codex CLI, or Claude Code.
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 Codex App, Node.js, or either CLI.
Only follow this guide for development tools
To make product images or videos in the browser, skip API-key setup and use Creative Studio.
The complete path
Create a HopBase key → Import CCS → Choose Claude Code or Codex CLI → Confirm in CC Switch → Enable
Before you start
Choose the key by model
Prepare the target client first: Codex App, Codex CLI, or Claude Code.
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
Open Key Management
Open Key Management and select Create key in the upper-right corner.
Name the key and choose a model group
Enter a recognizable name, choose the group for the models you need, and select Create. Claude uses a Claude group, GPT uses an OpenAI / Codex group, and GLM uses a GLM group. Expiration is optional.
Open Import CCS
Find the new key row, open its ··· menu, and select Import CCS. You do not need to copy the key manually.
Choose the client
Choose Codex CLI for both Codex App and Codex CLI. Choose Claude Code when you use Claude Code. If you use both client families, repeat the import for each one.
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. For Codex App, fully quit and reopen the app before starting a test task. If an existing terminal still uses the previous provider, close it and open a new terminal.
Codex App and Codex CLI
CC Switch writes the user-level Codex provider configuration. After switching providers, fully restart Codex App or open a new Codex CLI session so it reloads the configuration.
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.