tuzi-switch

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

中文 | English | 日本語 | Releases

下载

最新安装包请前往 GitHub Releases。

推荐下载方式：

• Windows：下载 .msi 安装版
• Windows 便携版：如当前版本提供，再下载对应的 Windows-Portable.zip
• Linux：根据发行版选择 .AppImage、.deb 或 .rpm
• macOS：下载 macOS-unsigned.dmg 或 macOS-unsigned.zip

目前公开 Release 已支持 Windows 和 Linux 用户下载使用。macOS 当前提供的是未签名测试包。

一键安装

直接安装当前推荐版本 v3.12.16：

curl -fsSL https://raw.githubusercontent.com/tuziapi/tuzi-switch/main/scripts/install_tuzi_switch.sh | env TUZI_SWITCH_TAG=v3.12.16 bash

补充说明：

• 当前 Release workflow 仍使用 prerelease 发布策略
• GitHub releases/latest 不能稳定命中当前最新测试版本
• 当前 README 默认固定到 v3.12.16，这样可以确保安装到我们当前推荐版本
• 需要安装其它版本时，可以改用 env TUZI_SWITCH_TAG=vX.Y.Z bash

macOS 未签名包打开方式

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

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

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

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

tuzi-switch 是什么

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

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

• Claude Code
• Codex
• Gemini
• OpenClaw

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

当前版本更新

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

• Claude、Codex、Gemini 三个入口的状态读取进一步收口到真实命中的 CLI、安装包元数据与 current provider，而不是只依赖 installer 记录
• Quick Access 与下方 ProviderList 在真实切线后改成同轮原子刷新，顶部 当前线路 / Base URL / CLI 变体 与下方当前卡片不再长期分叉
• Claude provider 切换后新增后端收口，会同步 route file、shell rc、~/.claude/settings.json 与 current provider，减少跳线与来源冲突
• Codex / Gemini 的改版安装补了 launcher 冲突清理、安装后复核和真实变体校验；Codex 测试模型链路也按真实 model / reasoning effort / endpoint 执行
• 改版切换统一记录并恢复 last original route / provider，进入改版时清空原版 current provider，退出改版时按真实记录恢复
• 新增三模块当前线路逻辑梳理文档，并继续保持一键安装命中当前推荐版本

产品亮点

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

当前改版方向

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

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

界面预览

Claude

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 的部分联动能力仍在持续完善中

数据与本地存储

为了兼容上游生态，当前本地数据仍沿用原有 CC Switch 存储路径：

• ~/.cc-switch/cc-switch.db
• ~/.cc-switch/settings.json
• ~/.cc-switch/backups/
• ~/.cc-switch/skills/

开发计划 / TODO List

• 已完成：Claude / Codex / Gemini 当前线路、CLI 变体、Base URL、provider 当前态的显示优先级与刷新联动收口
• 已完成：Claude provider 切换后的 route file / shell rc / settings.json / current provider 收口，以及改版状态误报修正
• 已完成：Codex / Gemini 改版安装冲突清理、安装后复核、真实变体校验与测试模型链路修正
• 已完成：README 一键安装命令与安装脚本示例固定到 v3.12.16，并补充三模块当前线路逻辑文档入口
• 进行中：继续统一深色 / 浅色主题下的路线卡、状态区、列表高亮与各入口文案密度
• 进行中：继续梳理并消除 provider / proxy / openclaw 相关的顺序依赖型 Rust flaky tests
• 下一步：继续梳理会话管理与恢复策略
• 下一步：继续推进 release workflow 向更稳定的 latest / 签名分发体验收口

说明

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

致谢

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