cae625dab1
- Changed from solid emerald button to bordered style for better visual hierarchy - Apply action: gray border, blue on hover (consistent with theme color) - Remove action: gray border, red on hover (indicates destructive action) - Better distinction between apply/remove states while maintaining Linear's minimalist aesthetic
Claude Code & Codex 供应商切换器
一个用于管理和切换 Claude Code 与 Codex 不同供应商配置的桌面应用。
v3.2.0 重点：全新 UI、macOS系统托盘、内置更新器、原子写入与回滚、改进暗色样式、单一事实源（SSOT）与一次性迁移/归档（详见下文“迁移与归档 v3.2.0”）。
v3.1.0 ：新增 Codex 供应商管理与一键切换，支持导入当前 Codex 配置为默认供应商，并在内部配置从 v1 → v2 迁移前自动备份（详见下文“迁移与归档”）。
v3.0.0 重大更新：从 Electron 完全迁移到 Tauri 2.0，应用体积显著降低、启动性能大幅提升。
功能特性（v3.2.0）
- 全新 UI：感谢 TinsFox 大佬设计的全新 UI
- 系统托盘（菜单栏）快速切换：按应用分组（Claude / Codex），勾选态展示当前供应商
- 内置更新器：集成 Tauri Updater，支持检测/下载/安装与一键重启
- 单一事实源（SSOT）：不再写每个供应商的“副本文件”，统一存于
~/.cc-switch/config.json - 一次性迁移/归档：首次升级自动导入旧副本并归档原文件，之后不再持续归档
- 原子写入与回滚：写入
auth.json/config.toml/settings.json时避免半写状态 - 深色模式优化：Tailwind v4 适配与选择器修正
- 丰富预设与自定义：Qwen coder、Kimi、GLM、DeepSeek、PackyCode 等；可自定义 Base URL
- 本地优先与隐私：全部信息存储在本地
~/.cc-switch/config.json
界面预览
主界面
添加供应商
下载安装
系统要求
- Windows: Windows 10 及以上
- macOS: macOS 10.15 (Catalina) 及以上
- Linux: Ubuntu 20.04+ / Debian 11+ / Fedora 34+ 等主流发行版
Windows 用户
从 Releases 页面下载最新版本的 CC-Switch-Setup.msi 安装包或者 CC-Switch-Windows-Portable.zip 绿色版。
macOS 用户
从 Releases 页面下载 CC-Switch-macOS.zip 解压使用。
注意：由于作者没有苹果开发者账号，首次打开可能出现"未知开发者"警告，请先关闭，然后前往"系统设置" → "隐私与安全性" → 点击"仍要打开"，之后便可以正常打开
Linux 用户
从 Releases 页面下载最新版本的 .deb 包。
使用说明
- 点击"添加供应商"添加你的 API 配置
- 切换方式：
- 在主界面选择供应商后点击切换
- 或通过“系统托盘（菜单栏）”直接选择目标供应商，立即生效
- 切换会写入对应应用的“live 配置文件”（Claude：
settings.json；Codex：auth.json+config.toml） - 重启或新开终端以确保生效
- 若需切回官方登录，在预设中选择“官方登录”并切换即可；重启终端后按官方流程登录
检查更新
- 在“设置”中点击“检查更新”，若内置 Updater 配置可用将直接检测与下载；否则会回退打开 Releases 页面
Codex 说明（v3.2.0 SSOT）
- 配置目录：
~/.codex/- live 主配置：
auth.json（必需）、config.toml（可为空）
- live 主配置：
- API Key 字段：
auth.json中使用OPENAI_API_KEY - 切换行为（不再写“副本文件”）：
- 供应商配置统一保存在
~/.cc-switch/config.json - 切换时将目标供应商写回 live 文件（
auth.json+config.toml） - 采用“原子写入 + 失败回滚”，避免半写状态；
config.toml可为空
- 供应商配置统一保存在
- 导入默认：当该应用无任何供应商时，从现有 live 主配置创建一条默认项并设为当前
- 官方登录：可切换到预设“Codex 官方登录”，重启终端后按官方流程登录
Claude Code 说明（v3.2.0 SSOT）
- 配置目录：
~/.claude/- live 主配置：
settings.json（优先）或历史兼容claude.json
- live 主配置：
- API Key 字段：
env.ANTHROPIC_AUTH_TOKEN - 切换行为（不再写“副本文件”）：
- 供应商配置统一保存在
~/.cc-switch/config.json - 切换时将目标供应商 JSON 直接写入 live 文件（优先
settings.json） - 编辑当前供应商时，先写 live 成功，再更新应用主配置，保证一致性
- 供应商配置统一保存在
- 导入默认：当该应用无任何供应商时，从现有 live 主配置创建一条默认项并设为当前
- 官方登录：可切换到预设“Claude 官方登录”，重启终端后可使用
/login完成登录
迁移与归档（v3.2.0）
- 一次性迁移：首次启动 3.2.0 会扫描旧的“副本文件”并合并到
~/.cc-switch/config.json- Claude：
~/.claude/settings-*.json（排除settings.json/ 历史claude.json） - Codex：
~/.codex/auth-*.json与config-*.toml（按名称成对合并）
- Claude：
- 去重与当前项：按“名称（忽略大小写）+ API Key”去重；若当前为空，将 live 合并项设为当前
- 归档与清理：
- 归档目录：
~/.cc-switch/archive/<timestamp>/<category>/... - 归档成功后删除原副本；失败则保留原文件（保守策略）
- 归档目录：
- v1 → v2 结构升级：会额外生成
~/.cc-switch/config.v1.backup.<timestamp>.json以便回滚 - 注意：迁移后不再持续归档日常切换/编辑操作，如需长期审计请自备备份方案
开发
环境要求
- Node.js 18+
- pnpm 8+
- Rust 1.75+
- Tauri CLI 2.0+
开发命令
# 安装依赖
pnpm install
# 开发模式（热重载）
pnpm dev
# 类型检查
pnpm typecheck
# 代码格式化
pnpm format
# 检查代码格式
pnpm format:check
# 构建应用
pnpm build
# 构建调试版本
pnpm tauri build --debug
Rust 后端开发
cd src-tauri
# 格式化 Rust 代码
cargo fmt
# 运行 clippy 检查
cargo clippy
# 运行测试
cargo test
技术栈
- Tauri 2 - 跨平台桌面应用框架（集成 updater/process/opener/log/tray-icon）
- React 18 - 用户界面库
- TypeScript - 类型安全的 JavaScript
- Vite - 极速的前端构建工具
- Rust - 系统级编程语言（后端）
项目结构
├── src/ # 前端代码 (React + TypeScript)
│ ├── components/ # React 组件
│ ├── config/ # 预设供应商配置
│ ├── lib/ # Tauri API 封装
│ └── utils/ # 工具函数
├── src-tauri/ # 后端代码 (Rust)
│ ├── src/ # Rust 源代码
│ │ ├── commands.rs # Tauri 命令定义
│ │ ├── config.rs # 配置文件管理
│ │ ├── provider.rs # 供应商管理逻辑
│ │ └── store.rs # 状态管理
│ ├── capabilities/ # 权限配置
│ └── icons/ # 应用图标资源
└── screenshots/ # 界面截图
更新日志
查看 CHANGELOG.md 了解版本更新详情。
Electron 旧版
Releases 里保留 v2.0.3 Electron 旧版
如果需要旧版 Electron 代码，可以拉取 electron-legacy 分支
贡献
欢迎提交 Issue 和 Pull Request！
Star History
License
MIT © Jason Young