一个基于 Tauri 2 开发的现代化桌面应用,专为 AI 开发者打造
CC Switch 是一个用于管理和切换 Claude Code 与 Codex 不同供应商配置的桌面应用。支持一键切换 API 供应商,无需手动编辑配置文件,大大提升开发效率。
从 Electron 完全迁移到 Tauri 2.0,应用体积显著降低(仅几 MB),启动性能大幅提升。采用 Rust 后端,内存占用更低,运行更流畅。
完美支持 Windows 10+、macOS 10.15+ 和主流 Linux 发行版。提供原生安装包(MSI、DMG、DEB、AppImage),确保在各平台上都有最佳体验。
v3.5.0 版本带来的强大功能
完整的 Model Context Protocol 服务器配置管理系统。支持 stdio 和 http 服务器类型,内置常用 MCP 服务器模板,实时启用/禁用,原子文件写入防止配置损坏。
一键导出所有配置到 JSON 文件,支持配置导入时自动验证并备份。自动轮换备份(保留最近 10 个),带有详细状态反馈的进度模态框。
测试 API 端点响应时间,测量不同供应商端点的延迟,可视化连接质量指示器,帮助用户选择最快的供应商。
完整的 i18next 国际化覆盖,默认显示中文,可在设置中快速切换到英文,界面文案自动实时刷新。
内置按钮可一键应用或恢复 Claude 插件配置,切换供应商后立即生效。支持多种预设供应商(Longcat、kat-coder 等)。
窗口关闭可最小化到托盘,macOS 支持托盘模式下隐藏/显示 Dock。托盘切换时同步 Claude/Codex/插件状态,单实例运行避免冲突。
现代化的技术栈,确保最佳性能和开发体验
跨平台桌面应用框架,集成 updater/process/opener/log/tray-icon。相比 Electron 体积更小、性能更优、安全性更高。
现代化的用户界面库,配合 TypeScript 提供类型安全。使用 Vite 作为构建工具,开发体验极佳,热重载速度快。
系统级编程语言,提供高性能和内存安全。负责配置文件管理、供应商切换逻辑、原子写入与回滚等核心功能。
选择适合你的安装方式
从 GitHub Releases 页面下载最新版本的安装包或绿色版。
方式一:安装包(推荐)
下载:CC-Switch-v{版本号}-Windows.msi
双击安装即可
方式二:绿色版
下载:CC-Switch-v{版本号}-Windows-Portable.zip
解压后直接运行 CC-Switch.exe
推荐使用 Homebrew 安装,也可以手动下载。
# 方式一:Homebrew 安装(推荐)
brew tap farion1231/ccswitch
brew install --cask cc-switch
# 更新
brew upgrade --cask cc-switch
# 方式二:手动下载
# 从 Releases 下载 CC-Switch-v{版本号}-macOS.zip
# 解压后拖入应用程序文件夹
⚠️ 注意:首次打开可能出现"未知开发者"警告,请前往"系统设置" → "隐私与安全性" → 点击"仍要打开"
支持 Ubuntu 22.04+、Debian 11+、Fedora 34+ 等主流发行版。
# Debian/Ubuntu 系统
# 下载 CC-Switch-v{版本号}-Linux.deb
sudo dpkg -i CC-Switch-v{版本号}-Linux.deb
# 或使用 AppImage(通用)
# 下载 CC-Switch-v{版本号}-Linux.AppImage
chmod +x CC-Switch-v{版本号}-Linux.AppImage
./CC-Switch-v{版本号}-Linux.AppImage
简单几步,轻松管理你的 API 供应商配置
点击"添加供应商"按钮,填写供应商名称、API 端点、API Key 等信息。支持从预设模板快速创建,也可以自定义配置。
在主界面选择目标供应商后点击切换,或通过系统托盘直接选择。切换会自动写入配置文件(Claude: settings.json,Codex: auth.json + config.toml)。
切换完成后,重启或新开终端即可生效。若需切回官方登录,选择"官方登录"预设并切换,然后按官方流程登录即可。
~/.claude/settings.json(优先)或 claude.jsonenv.ANTHROPIC_AUTH_TOKEN~/.cc-switch/config.json~/.codex/auth.json(必需)+ config.toml(可选)OPENAI_API_KEY~/.cc-switch/config.json清晰的代码组织,易于理解和扩展
├── 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/ # 界面截图
为开发者提供完整的开发环境配置和命令
JavaScript 运行时环境
快速的包管理器
系统编程语言
Tauri 命令行工具
# 安装依赖 pnpm install # 开发模式(热重载) pnpm dev # 类型检查 pnpm typecheck # 代码格式化 pnpm format # 检查代码格式 pnpm format:check # 构建应用 pnpm build # 构建调试版本 pnpm tauri build --debug
cd src-tauri # 格式化 Rust 代码 cargo fmt # 运行 clippy 检查 cargo clippy # 运行测试 cargo test
持续迭代,不断完善