用 CC Switch 管理 OpenApi 配置
如果你会在多个供应商或多套配置之间频繁切换,手动改环境变量会很麻烦。CC Switch 是一个开源桌面工具,专门用来集中保存多套服务商配置,并在它们之间一键切换 —— 很适合把 OpenApi 作为其中一套配置纳入管理。
CC Switch 是第三方开源项目(MIT 许可),与 OpenRealm 无从属关系,本页内容为原创整理。请以其官方资料为准: 官网 ccswitch.io · GitHub 仓库 。
在 CC Switch 中,把 OpenApi 存成一套配置,关键就是这两栏:
给配置起名「OpenApi-主站」,方便和其他供应商区分
它是什么
- 一个跨平台(基于 Rust / Tauri 构建)的桌面应用,用于管理 Claude Code、Codex 等工具的供应商配置。
- 核心价值是一键切换:把每个服务商存成一套配置,需要时点一下就切过去,免去反复修改环境变量或配置文件。
- 开源、本地运行,配置保存在你自己的机器上。
接入思路
CC Switch 负责「保存与切换配置」,真正的接入参数还是 OpenApi 那两样:
- Base URL:
https://api.openrealm.cn(海外用https://global.api.openrealm.cn) - API Key:你的
sk-...令牌
把这两个值在 CC Switch 里存成一套指向 OpenApi 的配置即可。
安装 CC Switch
从 官网 或 GitHub Releases 下载对应平台的安装包并安装。
新建一套指向 OpenApi 的配置
在 CC Switch 中新增一个供应商 / 配置项,把地址填为 OpenApi 站点根、密钥填为你的令牌:
- 地址(Base URL):
https://api.openrealm.cn - 密钥(Token / Key):
sk-... - 取个好认的名字,例如「OpenApi-主站」「OpenApi-Global」,方便区分线路。
用于 Claude Code 的配置,地址填到站点根(不带 /v1);Claude Code 会自行拼接 /v1/messages。这与 Claude Code 接入 里手动设环境变量是同一套参数,只是改由 CC Switch 托管。
切换并启动
在 CC Switch 中把当前配置切到刚建的「OpenApi」,然后正常启动你的工具(如 claude)。验证方法与 Claude Code 接入 一致。
小技巧:为两条线路各存一套
把主站和 Global 各存成一套配置(名字带上线路),网络环境变化时直接切换,比改地址快得多。哪条线路更快,可在 首页测速 处就地测一下。
CC Switch 的界面与功能可能随版本更新而变化,具体操作请以 官方文档 为准。