e92d99b758
- Add normalize_server_keys() to ensure MCP server map keys match internal id fields - Auto-normalize on all read/write operations (get, upsert, delete, import, sync) - Handle edge cases: empty/whitespace ids, key renaming, conflict resolution - Auto-save config when normalization detects changes - Apply cargo fmt for code formatting consistency This enhancement improves data integrity by automatically fixing inconsistencies between server entry keys and their id fields, especially after manual config edits.
Claude Code & Codex 供应商切换器
一个用于管理和切换 Claude Code 与 Codex 不同供应商配置的桌面应用。
v3.4.0 ：新增 i18next 国际化（还有部分未完成）、对新模型（qwen-3-max, GLM-4.6, DeepSeek-V3.2-Exp）的支持、Claude 插件、单实例守护、托盘最小化及安装器优化等。
v3.3.0 ：VS Code Codex 插件一键配置/移除（默认自动同步）、Codex 通用配置片段与自定义向导增强、WSL 环境支持、跨平台托盘与 UI 优化。（该 VS Code 写入功能已在 v3.4.x 停用）
v3.2.0 ：全新 UI、macOS系统托盘、内置更新器、原子写入与回滚、改进暗色样式、单一事实源（SSOT）与一次性迁移/归档。
v3.1.0 ：新增 Codex 供应商管理与一键切换，支持导入当前 Codex 配置为默认供应商，并在内部配置从 v1 → v2 迁移前自动备份（详见下文“迁移与归档”）。
v3.0.0 重大更新：从 Electron 完全迁移到 Tauri 2.0，应用体积显著降低、启动性能大幅提升。
功能特性（v3.4.0）
- 国际化与语言切换：内置 i18next，默认显示中文，可在设置中快速切换到英文，界面文文案自动实时刷新。
- Claude 插件同步：内置按钮可一键应用或恢复 Claude 插件配置，切换供应商后立即生效。
- VS Code Codex 设置停用：由于新版 Codex 插件无需修改
settings.json，应用不再写入 VS Code 设置，避免潜在冲突。 - 供应商预设扩展：新增 DeepSeek--V3.2-Exp、Qwen3-Max、GLM-4.6 等最新模型。
- 系统托盘与窗口行为：窗口关闭可最小化到托盘，macOS 支持托盘模式下隐藏/显示 Dock，托盘切换时同步 Claude/Codex/插件状态。
- 单实例：保证同一时间仅运行一个实例，避免多开冲突。
- UI 与安装体验优化：设置面板改为可滚动布局并加入保存图标，按钮宽度与状态一致性加强，Windows MSI 安装默认写入 per-user LocalAppData 并改进组件跟踪，Windows 便携版现在指向最新 release 页面，不再自动更为为安装版。
界面预览
主界面
添加供应商
下载安装
系统要求
- 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 包或者 AppImage安装包。
使用说明
- 点击"添加供应商"添加你的 API 配置
- 切换方式：
- 在主界面选择供应商后点击切换
- 或通过“系统托盘（菜单栏）”直接选择目标供应商，立即生效
- 切换会写入对应应用的“live 配置文件”（Claude：
settings.json；Codex：auth.json+config.toml） - 重启或新开终端以确保生效
- 若需切回官方登录，在预设中选择“官方登录”并切换即可；重启终端后按官方流程登录
检查更新
- 在“设置”中点击“检查更新”，若内置 Updater 配置可用将直接检测与下载；否则会回退打开 Releases 页面
Codex 说明（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 说明（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