简介ZSwitch(原名 z-switch)是真测 ztest.ai 开发、以 MIT 许可开源的桌面工具,支持 Windows、macOS 和 Linux。它让 Claude Code、Codex 和 Grok 在多个 API 中转站与官方账号之间一键切换:直连模式写配置前先备份,实验性的本地代理可以在客户端运行时热切换;每个供应商都能测连通性、测速和做真实流式测试。无广告、无遥测、无返利链接。
主要功能
- Claude Code、Codex、Grok 分区一键切换
- 官方账号卡片,不保存 API Key
- 原子写入,写前备份,可恢复原始配置
- 连通性、模型列表、HTTP 测速
- 真实流式测试,可模拟 CLI 请求
- 本地代理热切换(实验)
- 从 cc-switch 一键导入
- 同步 Claude 桌面版与 VS Code 扩展
接入中转站 4 步
- 添加供应商点右上角“添加”,填名称、地址和 API Key。Claude Code 填站点根地址;Codex 填到 /v1,中转站要提供 /v1/responses。
- 拉取模型并测速测连通性、拉取模型列表,Claude 可以分别给主模型和 Haiku、Sonnet、Opus、Fable 四档选模型。
- 做一次真实测试发一条最小的流式 Hi,看回复和首字耗时。返回 403 时勾选“模拟 CLI 请求”再试。
- 点“切换”生效直连模式立即写入配置。Claude Code 下一次请求生效,Codex 可能要重启。
界面截图
由真测开发
ZSwitch(原名 z-switch)是真测 ztest.ai 自己开发的开源工具,MIT 许可,代码和安装包都在 GitHub 公开。它在本目录里和其他工具一样展示,排序不因为是本站出品而靠前。
能做什么
用 Claude Code、Codex 或 Grok 的人,经常要在几个 API 中转站和官方账号之间来回换。手动改 ~/.claude/settings.json、~/.codex/auth.json 和 config.toml 容易改错,也容易把自己加过的配置覆盖掉。ZSwitch 把每个中转站存成一张卡片,点“切换”就写好对应客户端的配置。
- Claude Code、Codex、Grok 分区管理,各自的供应商互不影响。
- 内置 Claude 和 OpenAI 官方账号卡片,官方账号不保存 API Key,可以和中转站来回切。
- 第一次启动会保存本机原始配置,并把已经在用的中转配置导入成卡片。
两种工作方式
直连模式是默认方式:切换时原子改写客户端的配置文件,写之前先备份。Claude Code 一般在下一次请求时读到新配置,Codex 可能要重启。
本地路由模式还在实验阶段:ZSwitch 在 127.0.0.1:8899 起一个本地代理,客户端运行期间也能热切换。代理不改请求体、不做协议转换、不记录用量;模型名不会跟着改,所以只适合模型兼容的供应商之间切换。
供应商体检
每张卡片都可以测连通性、拉取模型列表、做 HTTP 层测速,还能发一条最小的流式 Hi 做真实测试,显示回复、首字耗时和总耗时。有的中转站只放行官方客户端,普通测试会返回 403,这时勾选“模拟 CLI 请求”再试。真实测试会产生极少量调用费用,测试内容、回复和 Key 不写入任何文件。
配置安全
- 原子写入,每次写入前留时间戳备份。
- 首次运行的原始配置单独保存在
~/.z-switch/original/,可以一键恢复。 - 切换前把当前生效的配置回填到上一张卡片,手动改过的内容不会丢。
- 配置文件不是合法 JSON 时中止写入并报错,不会覆盖。
Claude 生态联动
设置里有三个默认关闭的开关:让 Claude 桌面版(macOS、Windows)跟随切换、让 VS Code 的 Claude Code 扩展使用第三方供应商、跳过 Claude Code 初次运行的确认。它们只改单个字段,保留文件里的其他内容。
接入中转站时注意
- Claude Code 的地址一般填站点根地址,如
https://api.example.com。 - Codex 只支持
responses协议,地址填到/v1,中转站需要提供/v1/responses。只有/v1/chat/completions的中转站不能再用于 Codex。 - 不确定中转站返回的是不是声称的模型,可以先在真测免费检测一次,再把它加进 ZSwitch。
安装
在 GitHub Releases 下载:Windows 用 .exe,macOS 用 .dmg(按 Apple 芯片或 Intel 选择),Linux 用 .AppImage 或 .deb。安装包没有做代码签名和 Apple 公证,Windows 可能提示“已保护你的电脑”,点“更多信息 → 仍要运行”;macOS 提示“已损坏”时,把应用拖进“应用程序”后在终端执行 xattr -dr com.apple.quarantine /Applications/z-switch.app。
致谢
ZSwitch 的设计参考了同为 MIT 许可的 cc-switch,支持从 cc-switch 一键导入供应商。