/cc-switch
CC Switch
用 CC Switch 桌面应用管理 OpenToken 配置：安装、一键导入深链、多中转站切换，以及它到底改了哪些文件。
CC Switch 是一个开源的桌面应用，用来管理多个 AI 客户端的供应商配置并一键切换。它不是 CLI，也不是插件——是一个装在本机的图形程序，帮你读写那些配置文件。
它和手动改配置做的是同一件事，结果落到同样的文件里。区别只是谁来编辑 JSON 和 TOML。
装它
macOS 取 .dmg，Windows 取 .msi（注意区分 x64 和 arm64），Linux 取 .AppImage / .deb / .rpm。
ccswitch.io 是唯一官方站点。安装说明、完整用户手册都在这里。
支持 Windows 10+、macOS 12 (Monterey)+、以及主流 Linux 发行版。
一键导入 OpenToken
装好之后，点下面对应的按钮，CC Switch 会弹出确认框，把 OpenToken 的接入地址填进去：
ccswitch://v1/import?resource=provider&app=claude&name=OpenToken&endpoint=https%3A%2F%2Fotokapi.com&homepage=https%3A%2F%2Fotokapi.com链接里没有密钥——你可以自己核对上面这串。导入后在 CC Switch 里填入自己的 sk- 密钥即可。点了没反应说明还没装 CC Switch，见 下载页。
ccswitch://v1/import?resource=provider&app=codex&name=OpenToken&endpoint=https%3A%2F%2Fotokapi.com%2Fv1&homepage=https%3A%2F%2Fotokapi.com链接里没有密钥——你可以自己核对上面这串。导入后在 CC Switch 里填入自己的 sk- 密钥即可。点了没反应说明还没装 CC Switch，见 下载页。
导入流程是：浏览器问你是否打开 CC Switch → CC Switch 弹出确认框，显示要导入的内容 → 你确认 → 它先备份自己的数据库再写入。
导入后还需要你做一件事：填密钥。链接里不带密钥（你可以自己核对上面那两串 URL），在 CC Switch 的供应商编辑界面里填上你的 sk- 密钥，然后点启用。
它到底改了哪些文件
这是最值得搞清楚的一点。CC Switch 自己的数据存在 ~/.cc-switch/ 下（一个 SQLite 数据库作为唯一可信源），但它同时会把当前启用的配置写进各客户端的真实配置文件：
| 你在 CC Switch 里切换 | 它实际写的文件 |
|---|---|
| Claude Code 的供应商 | ~/.claude/settings.json |
| Codex 的供应商 | ~/.codex/config.toml 和 ~/.codex/auth.json |
也就是说，你手动改过的那些文件，会被 CC Switch 的切换动作覆盖。两条路不要混着用——要么一直手动，要么一直用 CC Switch。
在多个中转站之间切换
这是 CC Switch 的主要用途。在同一个客户端下配置多个供应商（OpenToken、其他中转、官方账号），需要谁就点谁。切换是即时的，下次启动 claude 或 codex 就走新的配置。
Codex 用户也可以不装 CC Switch，用它自带的 profile 机制达到类似效果，见 Codex 页的多站切换。
关于深链的两条提醒
别公开分享带密钥的链接。 ccswitch:// 协议支持在 URL 里带 apiKey 参数，官方文档明确提醒过不要公开分享这种链接。本站的按钮不带密钥，就是这个原因。你自己生成分享链接时也注意这一点。
官方文档里的在线生成器链接是失效的。 用户手册里给的 farion1231.github.io/cc-switch/deplink.html 会返回 404，可用的地址是 ccswitch.io/zh/deeplink。