简介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 步

  1. 添加供应商点右上角“添加”,填名称、地址和 API Key。Claude Code 填站点根地址;Codex 填到 /v1,中转站要提供 /v1/responses。
  2. 拉取模型并测速测连通性、拉取模型列表,Claude 可以分别给主模型和 Haiku、Sonnet、Opus、Fable 四档选模型。
  3. 做一次真实测试发一条最小的流式 Hi,看回复和首字耗时。返回 403 时勾选“模拟 CLI 请求”再试。
  4. 点“切换”生效直连模式立即写入配置。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 一键导入供应商。

资料来源

GitHub 仓库 README 与 docs/USAGE.md(https://github.com/ZtestAi/z-switch),版本 0.4.0,2026-10-29 核对。本工具由真测开发。(核对于 2026-10-29)

价格和功能可能变化,以官网为准。

资料有误或已过时?反馈给编辑