CC Switch
安装 CC Switch，并为 Claude Code 与 Codex CLI 导入、启用或切换 HopBase 供应商。
CC Switch 是适用于 Windows 和 macOS 的桌面配置管理工具。偏好图形界面，或经常切换 Claude Code、Codex 供应商时使用。它负责管理配置，不会安装 Node.js、Claude Code 或 Codex CLI。
开始前准备
按模型选择密钥
先安装目标 CLI：Claude Code 或 Codex CLI。
按模型选择密钥：Claude 使用 Claude 分组密钥，GPT 使用 OpenAI / Codex 分组密钥，GLM 使用 GLM 分组密钥。
更新 CC Switch：使用最新版本；GLM 路由需要 3.17.0 或更高版本。
安装 CC Switch
从 CC Switch 发布页下载最新的 .dmg。完成安装后至少启动一次，让浏览器在导入时可以唤起 CC Switch。
从 HopBase 控制台导入
发起导入
打开密钥右侧的 ··· 菜单，点「导入 CCS」，再选择 Claude Code 或 Codex CLI。两个客户端都要使用时，请分别导入一次。
核对并确认
浏览器提示时点 Open CC Switch。核对供应商名称、Base URL 和已隐藏部分内容的密钥，再点 Import。
启用供应商
在 CC Switch 中打开对应的 Claude Code 或 Codex 页签，找到刚导入的供应商，点 Enable。供应商显示「当前启用」即完成切换。
在新终端中验证
运行 claude 或 codex，发送一个简短测试。如果已经打开的 Codex 终端仍使用旧供应商，请关闭终端后重新打开。
在 Claude Code 中使用 GLM-5.2
GLM-5.2 使用 OpenAI Chat Completions，而 Claude Code 发送 Anthropic Messages。CC Switch 必须保持本地路由运行，才能在两种协议之间转换。
| 字段 | 填写值 |
|---|---|
| CC Switch 版本 | 3.17.0 或更高版本 |
| 供应商页签 | Claude Code |
| 请求地址 | https://api.hop-base.com/v1 |
| API 格式 | OpenAI Chat Completions（需开启路由） |
| 默认兜底模型 | glm-5.2 |
保存供应商后，进入「设置 → 路由 → 本地路由」，先打开路由总开关，再打开 Claude Code。回到供应商卡片点 Enable，并保持 CC Switch 在后台运行。模型映射和验证方法见 GLM-5.2。
常见问题
浏览器没有打开 CC Switch：手动启动一次，再重新点「导入 CCS」。
供应商没有切换：进入对应客户端页签，在刚导入的供应商卡片上点 Enable。
找不到命令或仍是旧供应商：安装 Node.js LTS 和目标 CLI，再使用新终端。
GLM 路由错误：核对 API 格式，打开两个本地路由开关，并保持 CC Switch 运行。其他错误见报错速查。