Skip to content

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),按下表填写:

CLIBase URL默认模型备注
Codexhttps://api.tokone.ai/v1gpt-5.5wire 协议选 responses
Claude Codehttps://api.tokone.aiclaude-opus-4-7注意:不带 /v1,Claude Code 自己拼路径
Gemini CLIhttps://api.tokone.ai/v1betagemini-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

下一步