dieqiyun / uni-switch

# uni-switch
简洁的 Codex / Claude Code API 配置工具。填写 **API 地址、API Key**，点击 **添加并使用**；日常切换只需一次点击。
**当前版本：0.5.25 · Windows / Linux / macOS · AGPL-3.0-only**
下载安装包 · 使用教程 · 供应商赞助 · 更新记录 · 问题反馈 · 参与开发 · 开源许可
本版修复 Claude 模型被无差别改成 `claude-sonnet-4-6-uni-…` 别名、档位请求误选默认模型的问题，补齐 Fable 档位与 `[1m]` 上下文标记处理。旧 Claude 配置请点击「更新配置」后完全退出并重开对应客户端。详见 更新记录 和 Claude 模型路由说明。
## 供应商赞助名单
感谢 **蝶祈云 API** 对 uni-switch 的支持。目前供应商赞助名单仅列出蝶祈云。
 蝶祈云 API 
 蝶祈云为个人开发者、科研探索者及团队提供 AI API 渠道接入，官网展示 GPT、Claude、Gemini 与国内模型生态。其渠道建设涵盖 GPT 真官 Key 科研探索、国外机构合作定制、高质量渠道聚合 ，让不同模型与渠道在同一入口更方便地选择。 
 除个人使用外，也面向项目开发与长期使用需求提供机构定制渠道；官网提供用户社区和联系支持入口，并支持开具发票，团队采购或报销可向支持确认开票资料与办理方式。接入时，从控制台复制对应渠道的 API 地址与 API Key ，在 uni-switch 点击「添加并使用」，即可继续自动检测协议、同步模型和应用客户端配置。 
 访问蝶祈云官网 ↗ · 详细介绍与接入说明 · 首次配置教程 
介绍依据蝶祈云官网公开内容整理；模型权限、API 接入地址、价格和服务安排以实际控制台及服务方说明为准。
## 功能
- 管理 Codex 桌面端 / CLI、Claude Code 桌面端及 Claude CLI 的 API 配置，同一供应商可在客户端之间复用。
- 新增 ZCode、DSH（DeepSeek Harness）、WorkBuddy 一键配置；所有客户端可查看实际配置文件、手动编辑保存，校验与备份后提示重启。详见 多客户端配置与编辑说明。
- 自动检测协议、认证方式、上游模型和余额，无需选择站点类型或手填模型 ID。
- 模型详情展示上游、内置和手动能力资料，可调整思考模式；仅在明确确认后发送受限合成请求验证能力。签名资料更新基础设施已加入，当前生产签名源尚未配置。
- 默认启用全部适用模型。每个模型可设置上下文长度，默认 256k。
- 同步成功后移除上游已下架的模型，并为失效默认模型选择有效替代项；同步失败保留原列表。
- 双向协议转换：Codex 使用 Claude Messages 模型；Claude Code 使用 OpenAI 模型。
- ZCode、DSH、WorkBuddy 使用官网原始图标，可一键写入原生配置和手动编辑配置文件；写入后提示重启。详见 多客户端配置与兼容边界。
- 供应商列表直接切换默认模型、上下文、Fast 加速模式和协议转换；完整模型配置在弹窗中确认。
- Codex 配置写入时自动检查思考强度显示并保留有效用户选择。实际修改后提示重启和新开对话；Claude 未运行时也提示后续启动与新对话。
- 本地配置备份、外部修改冲突检测、确认覆盖及恢复原配置；后台协议转换与可选 Windows 登录启动。
- 左下角版本入口检查 GitHub 最新正式版，发现新版时持续显示提醒；每次选择手动下载或远程下载、校验后确认安装。
- 软件内提供可离线查看的分类教程，与 GitHub 使用教程共用内容。
## 使用
详细操作见 完整中文教程。软件左下角「使用说明」可离线阅读相同教程。
1. 在左侧选择 Codex 或 Claude Code；Claude Code 可分别选择桌面端和 CLI。
2. 点击 **添加供应商**，填写 API 地址和 API Key，点击 **添加并使用**。
3. 按提示重启对应客户端并新开对话，确认模型和思考强度。旧 Codex 会话或恢复的会话仍可能保留原选择。
4. 后续切换点击供应商行的 **使用**。点击 **管理模型**调整启用列表、默认模型和上下文。
模型弹窗中的同步和选择属于草稿，取消不会写入。当前供应商确认保存后立即应用；未使用供应商在下次使用时应用。余额查询范围由上游接口决定，密钥额度与账户余额会分别标注。
配置目录在 **设置** 中查看和修改，通常保留默认值即可。关闭窗口后应用驻留托盘，协议转换继续运行；升级前从托盘退出旧版。
## 下载与更新
从 GitHub Releases 下载对应系统的程序：
| 系统 / 文件 | 用途 |
| --- | --- |
| Windows x64：`uni-switch_0.5.25_x64-setup.exe` | 安装包，推荐 Windows 用户使用 |
| Windows x64：`uni-switch_0.5.25_x64-portable.zip` | 便携程序、说明和许可证 |
| Windows x64：`uni-switch_0.5.25_x64.exe` | 独立程序，需要系统已有 WebView2 |
| Linux x64：`uni-switch_0.5.25_amd64.deb` | Ubuntu 22.04+ / Debian 12+ 桌面系统 |
| Linux x64：`uni-switch_0.5.25_x86_64.AppImage` | 设置可执行权限后运行，需要桌面环境与 WebKitGTK 4.1 |
| macOS：`uni-switch_0.5.25_universal.dmg` | 通用安装包，同时包含 Intel 和 Apple Silicon 架构 |
| macOS：`uni-switch_0.5.25_universal.app.tar.gz` | 通用 app 归档 |
| `uni-switch_0.5.25_source.zip` | 与三平台程序对应的完整源码和构建文件 |
| `README-zh-CN.md` / `SHA256SUMS.txt` | 完整教程 / 附件校验值 |
继续提供完整源码及三平台程序，许可保持 AGPL-3.0-only，历史版本全部保留。每次更新选择「GitHub 手动下载」或「远程更新」，检测不会自动下载安装。远程更新下载并校验本系统安装包，仍需点击「安装更新」：Windows 启动向导并退出应用，macOS 打开 DMG 后拖入安装，Linux 使用系统安装程序或替换 AppImage。详情见 远程更新说明。
macOS 包使用 ad-hoc 签名，尚未经过 Apple Developer ID 签名与公证；首次打开如被阻止，请先核对发布来源和校验值，再到「系统设置 → 隐私与安全性」允许打开。Linux AppImage 如缺少 FUSE，可使用 `--appimage-extract-and-r