tuzi-switch

面向 Claude Code、Codex、Gemini 与 OpenClaw 的兔子业务桌面助手

中文 | English | 日本語 | Releases

下载

最新安装包请前往 GitHub Releases。

推荐下载方式：

• Windows：下载 Windows 安装包
• Linux：根据发行版选择 .AppImage、.deb 或 .rpm
• macOS：下载 macOS arm64 .dmg

目前公开 Release 已支持 Windows、macOS 和 Linux 用户下载使用。

macOS / Linux 一键安装

直接安装最新版本：

curl -fsSL https://cdn.jsdelivr.net/gh/tuziapi/tuzi-switch@main/scripts/install_tuzi_switch.sh | bash

open "/Applications/兔子switch.app"

安装指定版本：

curl -fsSL https://cdn.jsdelivr.net/gh/tuziapi/tuzi-switch@v1.1.4/scripts/install_tuzi_switch.sh | TUZI_SWITCH_TAG=v1.1.4 bash

open "/Applications/兔子switch.app"

补充说明：

• App 内自动升级不执行安装脚本，安装脚本只作为手动安装兜底
• 需要安装其它版本时，可以改用 env TUZI_SWITCH_TAG=vX.Y.Z bash
• 这个脚本会自动按系统选择对应安装包，macOS 装 .dmg，Linux 装 .AppImage

macOS 未签名包打开方式

如果第一次打开时被系统拦截，可以用下面两种方式之一：

1. 对应用点右键，选择“打开”，然后在弹窗里再次确认“打开”
2. 或在终端执行：

xattr -dr com.apple.quarantine "/Applications/兔子switch.app"
open "/Applications/兔子switch.app"

如果你不是把应用放在 /Applications，把命令里的路径改成你自己的实际路径即可。

tuzi-switch 是什么

tuzi-switch 是基于 CC Switch 定制的兔子业务版本。它保留了成熟的多工具桌面管理基础能力，同时把产品重点放在兔子客户更容易上手的接入流程上。

当前版本主要围绕 4 个入口展开：

• Claude Code
• Codex
• Gemini
• OpenClaw

用户只需要输入一次兔子 Key，就可以更快完成线路接入和本地配置，不需要自己手动改配置文件。

当前版本更新

当前公开版本为 v1.1.4，这一轮更新重点包括：

Codex 新配置适配

• 适配 Codex 0.134+/0.135+：保留 model_provider、[model_providers.xxx]、env_key 与 wire_api = "responses" 的兔子线路模型
• 第三方线路不覆盖登录态：切换第三方 Codex Provider 时只写 config.toml，不覆盖用户 auth.json 中的 ChatGPT/OAuth 登录状态
• Provider 级 Token 注入：从现有 env_key 读取 API Key，写入对应 provider 的 experimental_bearer_token，同时保留 env_key 用于 UI 与迁移兼容
• 模型目录与本地路由：支持保存 Codex 模型目录、reasoning 能力和 Chat Completions 本地路由元数据，实际 Codex 配置仍保持 Responses 格式
• 配置读写更稳：支持 section-aware wire_api、experimental_bearer_token 清理、model_catalog_json 生成/移除和保留 tuziswitch 稳定 provider bucket

既有 Codex 配置能力

• 切换不再覆盖配置：切换线路时只修改顶层 model_provider / model / model_reasoning_effort，不再整套覆盖 config.toml，MCP、Projects 等用户自定义配置不会丢失
• 多线路共存：所有线路的 [model_providers.xxx] 在同一个 config.toml 中并存，切换只改指针
• API Key 安全存储：Key 主存储在环境变量或 shell rc 的 managed block 中（所有线路并存，切换不丢失）
• 同线路多 Key 支持：同一条线路可配置多个 Key（自动后缀 _2、_3）
• 对齐官方配置格式：兼容 Codex CLI 0.134.0+ 的新配置规范（不再使用已废弃的 [profiles.xxx]），同时向下兼容旧版本
• 版本自动检测：启动时检测 Codex CLI 版本，自动选择新旧配置策略
• 卡片 Key 实时显示：从 shell rc 实时读取 Key 显示在卡片上，不再依赖数据库存储
• 非兔子线路不显示充值/查询按钮：第三方线路卡片只显示 Key，不显示兔子业务按钮

其他改进

• 自动升级链路：原生能力走 Tauri 官方 updater，前端界面资源支持签名校验后的热更新
• 能力层接口：新增 Capability Facade v1，热更新前端可按 manifest 调用稳定后端能力
• Windows 环境变量支持：Windows 平台通过 setx 写入用户环境变量（注册表），macOS/Linux 通过 shell rc managed block，平台自动检测
• API Key 输入框提示文案更新为”填入 API Key，将自动写入环境变量”
• 编辑页面补充”获取 API Key”链接
• TOML 配置编辑器移除已废弃的 auth.json 编辑区和 Common Config 功能
• 模型名称显示兼容新配置格式
• 多语言翻译补充（充值/查询按钮、TOML 配置标题）
• 预设种子卡片配置格式对齐新逻辑

产品亮点

• 兔子优先的 Claude Code、Codex、Gemini、OpenClaw 快速入口
• 从主界面直接完成兔子业务线路的一键接入配置
• 独立的兔子品牌视觉、图标和接入卡片
• 支持从应用内切换供应商，并保留桌面版任务栏切换入口
• 保留 providers、MCP、prompts、skills 等基础管理能力
• 基于 Tauri 2 的桌面应用架构

当前改版方向

相比原始上游项目，这一版更偏向业务交付和客户使用效率，而不是通用型高级配置工具：

• 右上角入口区改成更适合兔子业务接入的结构
• Claude Code、Codex、Gemini、OpenClaw 各自拥有独立的安装或配置路径
• 兔子快速接入被提升为主流程入口
• 一些原本偏通用的设置与配置流程做了简化

快速开始

1. 从 Releases 下载最新安装包。
2. 打开 tuzi-switch。
3. 选择 Claude Code、Codex、Gemini 或 OpenClaw。
4. 在引导流程中输入你的兔子 Key。
5. 完成一键配置后开始使用对应工具。

如果你想查看 Claude / Codex / Gemini 当前的状态读取、一键配置、改版切换和 provider 联动逻辑，可直接阅读 docs/current-route-logic-zh.md。

主要能力

工具入口

• Claude Code、Codex、Gemini、OpenClaw 独立入口
• 支持对应工具的安装与升级引导
• 更强调业务接入，而不是先做通用供应商配置

供应商管理

• 支持新增、编辑、启用、停用、导入、导出供应商
• 在适用场景下同步一份配置到多个工具
• 可以在应用内或任务栏中切换当前供应商

MCP、Prompts 与 Skills

• 保留 MCP 的基础管理能力
• 同步各工具的提示词文件
• 沿用上游桌面基础能力中的 skills 安装与同步流程

补充说明：

• 不同工具的同步能力并不完全一致
• OpenClaw 的部分联动能力仍在持续完善中

数据与本地存储

当前本地数据存储路径：

• ~/.tuzi-switch/tuzi-switch.db
• ~/.tuzi-switch/settings.json
• ~/.tuzi-switch/backups/
• ~/.tuzi-switch/web-hot-update/（签名校验后的前端热更新资源）
• ~/.codex/config.toml（Codex 配置）
• ~/.codex/auth.json（Codex 认证）
• ~/.zshrc 或 ~/.bashrc（环境变量 managed block）

更新机制

tuzi-switch 当前有两条升级链路：

• 原生升级：Rust、Tauri 插件、权限、安装器等变化走 Tauri 官方 updater。更新清单通过 jsDelivr 分发，安装包仍来自 GitHub Release Assets，并由 Tauri 签名校验。
• 界面热更新：只更新 Vite/React 前端资源。资源包放在 release-web 分支，经 jsDelivr 分发；客户端下载后校验 sha256 和 minisign 签名，通过后下次重启生效。

安全边界：

• App 内不会执行 curl | bash。
• 不直接加载远程 JS。
• 热更新前端只能调用 Capability Facade v1 中声明且版本兼容的 native 能力。

维护细节见 docs/自动升级与能力层设计.md。

开发计划 / TODO List

• 已完成：Codex 配置逻辑重构（切换不覆盖、多线路共存、env_key 存储、版本兼容）
• 已完成：缺 Node.js/npm 时的确认弹窗、自动依赖安装与继续配置链路
• 已完成：OpenClaw 默认模型选择、primary/fallbacks 写入和配置成功后的默认模型同步
• 已完成：快速接入”已写入”状态语义与下方 provider 卡片存在性对齐
• 进行中：继续跟踪 Windows 客户机真实反馈，特别是 Node/npm、PATH、winget 与 CLI shim 命中差异
• 进行中：继续优化 OpenClaw 会话恢复、默认模型选择体验与业务线路表达
• 下一步：继续推进 macOS 签名分发与客户视角安装说明收口

说明

• 本仓库是面向兔子业务场景的定制分支。
• 部分文档和内部兼容路径仍保留上游技术约定。
• 安装包与后续版本通过本仓库的 GitHub Releases 分发。

致谢

tuzi-switch 构建在开源 CC Switch 的工程基础之上。本仓库在此基础上继续开发，并将产品体验调整为更适合兔子业务流程的版本。