JuAPI Switch
JuAPI Switch / v4.1.1

先装好，再把切换交给它。

这份文档面向第一次使用 JuAPI Switch 的 Windows 用户。当前下载页提供的是 v4.1.1 Windows x64 测试版。

安装

安装版（推荐）

  1. 下载 Windows x64 安装版。
  2. 运行安装程序，按向导选择安装位置。
  3. 从开始菜单或桌面快捷方式启动 JuAPI Switch。
首次运行提示：当前测试包未进行代码签名，Windows SmartScreen 可能显示发布者未知。确认文件来自本页面并完成 SHA256 校验后，再选择继续运行。

便携版

下载 便携版 ZIP，解压到你有写入权限的目录，再运行其中的 JuAPI Switch 程序。需要把配置和程序一起移动时，便携版更方便。

首次启动

  1. 在侧栏选择要管理的工具，例如 Claude Code、Codex 或 Gemini CLI。
  2. 点击添加供应商，选择预设，或填写自定义供应商地址、Key 和模型。
  3. 点击启用或切换，让 JuAPI Switch 写入对应工具的连接配置。
  4. 按页面提示重启终端或对应工具。Claude Code 通常可以直接生效；Codex、Gemini CLI 和 Grok Build 在部分切换场景需要重启。

JuAPI Switch 只修改切换所需的连接字段。你自己添加的 MCP、Hook、插件和注释会被保留；第一次改写前会自动备份原配置。

路由与聚合

在 Claude Code、Codex、Gemini CLI 或 Grok Build 页面，可以按需选择直连或路由。路由由本机转发请求并转换接口格式；聚合模式则把多家供应商的模型放进同一个模型列表。

下载包说明

文件适合谁说明
Windows-x64-Setup.exe大多数用户标准安装版，包含开始菜单入口和卸载项。
Windows-x64-Portable.zip临时或移动使用解压后运行，不需要安装到系统目录。
Windows-x64.msi集中部署适合系统管理员和企业软件分发工具。
SHA256SUMS.txt所有用户下载完成后核对文件完整性。

v4.1.1 是测试版，当前只提供 Windows x64 包。macOS 和 Linux 测试包暂未放在本页面。

在 PowerShell 中校验

Get-FileHash .\JuAPI-Switch-v4.1.1-Windows-x64-Setup.exe -Algorithm SHA256

把命令输出的哈希值与 SHA256SUMS.txt 中对应文件的值比较，完全一致后再运行安装程序。

常见问题

为什么 Windows 显示“未知发布者”？

当前 v4.1.1 测试包尚未进行代码签名，因此 SmartScreen 可能提示未知发布者。请先从本页面下载，并按文档中的 SHA256 步骤校验文件。

切换后为什么工具没有立即变化？

不同工具读取配置的时机不同。Claude Code 多数情况下无需重启；Codex、Gemini CLI 和 Grok Build 通常需要重启终端或 CLI。Claude Desktop 需要完全退出后重新打开。

便携版能不能覆盖安装版？

建议把两种版本放在不同目录。便携版会把运行所需文件保存在自己的目录中，移动前请先退出 JuAPI Switch。

自动更新现在可用吗？

本页面提供下载入口，自动更新签名公钥和完整更新通道仍在准备中。请以下载页列出的版本和文件为准。

服务状态

公告和更新服务由 JuAPI Switch 的独立服务提供。下面的地址可以用于快速检查公网服务是否在线：

GET https://www.hejuapi.click/health
GET https://www.hejuapi.click/v1/announcements

健康检查返回 {"status":"ok"} 时，表示服务进程和 HTTPS 反向代理均可访问。管理接口不对公网开放。