Appearance
CC Switch 一键导入
在控制台「一键配置」选中目标客户端,点一下即可通过 CC-Switch 自动填好接口地址和 API Key,支持 Claude Code、Claude Desktop、OpenCode、OpenClaw、Hermes Agent 等 11 个客户端。
开始前先完成 注册充值并创建 Key,Key 的分组要和客户端对应(见下表)。
1. 安装 CC Switch
到 CC Switch 下载页 下载适合自己系统的安装包。

不要用 zip 免安装版
Windows 选 .exe / .msi,macOS 选 .dmg。zip 版点一键导入没反应。
2. 在控制台选择客户端并导入
登录 CcodeZH 控制台 →「API 密钥」→ 点开目标密钥的 「一键配置」,选中客户端后点 「导入到 xxx」:

浏览器弹出提示选允许,在 CC-Switch 弹窗勾上「导入后立即切换到这个供应商」,再点 「导入」:

没勾这个开关的,在 CC-Switch 左侧选对应客户端,点 ccodezh 那一行的 ▷ 启用:

支持一键导入的客户端
每个客户端的完整步骤(安装、导入、开始使用)见侧边栏「客户端」下对应页面:
| 客户端 | 推荐分组 |
|---|---|
| Claude Code(终端 / VSCode 插件) | cc 或 cc-n |
| Claude Desktop | cc-3 |
| Codex | cx |
| OpenCode、OpenClaw、Hermes Agent、Pi、Oh My Pi、Kimi Code、MiniMax Code、DeepSeek Harness、GitHub Copilot CLI | cc-3 或 cc-n |
点击「导入」没反应时,检查是否装成了 zip 免安装版。
3. 重启目标客户端
- Claude Code CLI:关掉当前终端重开,进入项目目录运行
claude - VSCode 插件 / Claude 桌面版:彻底退出重开(桌面版首次进入见 Claude Desktop)
- 其他 CLI / 网关客户端:重开终端或重启 gateway
无法一键调起?在 CC-Switch 里手动添加
打开 CC-Switch,选中目标客户端(如 Claude Code 或 Claude Desktop),点右上角 「添加供应商」:

粘贴 API Key,请求地址填
https://api.ccodezh.com(末尾不要加/v1):
保存后点 ▷ 启用,变为 「使用中」,再按第 3 步重启客户端:
