CC Switch(推荐)
CC Switch 是一个开源(MIT)的桌面 App,用一个图形界面统一管理 Claude Code / Codex / Gemini CLI 等命令行工具的供应商配置,支持 Windows / macOS / Linux,自带系统托盘一键切换。
为什么单独推荐
不同 CLI 的配置文件路径、格式(JSON / TOML / shell env)在 macOS、Linux、Windows 上各不相同,手动改容易踩坑——特别是 Windows 上 export 不工作、%APPDATA% 路径与 Unix 不一样。CC Switch 把这些差异都封装掉了。
安装
去 ccswitch.io 或 GitHub Releases 下载对应平台的安装包:
| 平台 | 安装包格式 |
|---|---|
| macOS | .dmg(含 Intel / Arm) |
| Windows | .exe 安装程序 |
| Linux | .AppImage / .deb |
安装后启动,会常驻系统托盘。
添加 TokOne
顶部切到你要配置的 CLI 标签(如「Codex」「Claude Code」「Gemini CLI」),点「添加供应商」(Add Provider),按下表填写:
| CLI | Base URL | 默认模型 | 备注 |
|---|---|---|---|
| Codex | https://api.tokone.ai/v1 | gpt-5.5 | wire 协议选 responses |
| Claude Code | https://api.tokone.ai | claude-opus-4-7 | 注意:不带 /v1,Claude Code 自己拼路径 |
| Gemini CLI | https://api.tokone.ai/v1beta | gemini-3.5-flash | 走 Google 协议 |
- 名称:
TokOne - API Key:你在 TokOne 控制台对应分组生成的
sk-xxx
保存后从托盘菜单或主界面一键切到 TokOne。
切换 / 回滚
主界面或托盘菜单里点一下即可切换供应商,对应 CLI 的配置文件会被自动改写。想换回官方账号?切到原来那条预设即可,CC Switch 会把对应的配置文件回写。
验证
切到 TokOne 后,在终端跑对应 CLI 的简单命令:
bash
codex "回复 OK" # Codex
claude "回复 OK" # Claude Code
gemini "回复 OK" # Gemini CLI能正常拿到回复 = 配置生效。
常见问题
切换后 CLI 仍然走旧账号
CC Switch 切换时会改写 CLI 的配置文件,但已经打开的终端会话仍持有旧环境变量。关掉终端重开即可。
我想直接手撸配置文件,不用 GUI
直接看对应客户端页:Codex CLI · Claude Code · Gemini CLI。