CC Switch 桌面端一键导入教程
CC Switch 是当前最受开发者欢迎的 AI 编程 CLI 统一配置管理桌面软件。Oplaude 原生深度支持 CC Switch 协议，只需在控制台点击一次即可实现全自动供应商导入与节点切换。
一、什么是 CC Switch？为什么开发者都在用？
在日常高强度编程中，开发者经常需要在 Claude Code、Codex、Cursor、OpenClaw 之间频繁切换不同的模型和中转供应商。CC Switch 提供了优雅的桌面可视化界面，统一接管各工具的配置文件，省去了手动编辑 config.toml 或重复导出环境变量的繁琐步骤。
二、一键导入教程 (推荐 · 零配置门槛)
⚡ 极速导入流程
无需复制黏贴繁长的 Base URL 与 Key，Oplaude 已经为你打包好一键协议。
- 启动本地已安装的 CC Switch 客户端。
- 使用浏览器打开 Oplaude 控制台的 API 密钥管理页。
- 找到您希望使用的密钥，在操作栏点击 导入到 CCS 按钮。
- 浏览器弹出确认提示「是否允许打开 CC Switch？」，点击 允许。
- CC Switch 客户端将自动弹出并完成供应商添加，状态显示为已就绪。
- 在客户端中点击启用该供应商，随后打开终端运行
claude或codex即可！
三、手动添加供应商参数 (备用方案)
若您处于离线环境或通过自定义脚本维护，可在 CC Switch 供应商设置中手动新增：
| 配置字段 | 建议填写值 | 说明 |
|---|---|---|
| 供应商名称 (Name) | Oplaude API | 标识名称 |
| API 请求地址 (Base URL) | https://api.oplaude.com/v1 | 标准中转地址（含 /v1） |
| API Key | Oplaude 控制台生成的活跃 Key | sk-xxxxxxxx... |
| 默认模型 (Default Model) | claude-3-7-sonnet-20250219 | 或 gpt-5.6-sol |
四、在不同 CLI 之间秒级切换
CC Switch 支持同时将 Oplaude 节点挂载至多个工具：
- Claude Code：自动在
~/.claude/config.json中更新 base url 与认证凭据。 - Codex：自动同步修改
~/.codex/config.toml中的[model_providers.oplaude]块。
五、常见问题与故障排查
1. 导入后测试延迟为 0ms 或 Timeout
确认本地代理软件没有拦截 api.oplaude.com。如有规则分流，建议将 *.oplaude.com 添加至直连（DIRECT）白名单。
2. 调用时返回 502 Bad Gateway
上游模型节点偶尔抖动触发了热切换，CC Switch 通常会在 3 秒内自动重试成功。
六、常见问答 (FAQ)
Q：一个 Oplaude 密钥可以在多台电脑的 CC Switch 上导入吗？
A：可以，但为了更清晰地追踪不同工作设备（如公司 iMac 与个人 MacBook）的 Token 消耗，建议在控制台分别为每台设备创建独立的 API 密钥。