🚀 跨平台桌面应用

CC Switch

Claude Code & Codex 供应商切换器 - 轻量、快速、现代化的配置管理工具

2.6k+ GitHub Stars
Tauri 2 技术框架
3 平台 跨平台支持
MIT 开源协议

项目概述

一个基于 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 版本带来的强大功能

🔧

MCP 管理

完整的 Model Context Protocol 服务器配置管理系统。支持 stdio 和 http 服务器类型,内置常用 MCP 服务器模板,实时启用/禁用,原子文件写入防止配置损坏。

💾

配置导入/导出

一键导出所有配置到 JSON 文件,支持配置导入时自动验证并备份。自动轮换备份(保留最近 10 个),带有详细状态反馈的进度模态框。

端点速度测试

测试 API 端点响应时间,测量不同供应商端点的延迟,可视化连接质量指示器,帮助用户选择最快的供应商。

🌐

国际化支持

完整的 i18next 国际化覆盖,默认显示中文,可在设置中快速切换到英文,界面文案自动实时刷新。

🔌

Claude 插件同步

内置按钮可一键应用或恢复 Claude 插件配置,切换供应商后立即生效。支持多种预设供应商(Longcat、kat-coder 等)。

🎨

系统托盘集成

窗口关闭可最小化到托盘,macOS 支持托盘模式下隐藏/显示 Dock。托盘切换时同步 Claude/Codex/插件状态,单实例运行避免冲突。

技术架构

现代化的技术栈,确保最佳性能和开发体验

🦀

Tauri 2

跨平台桌面应用框架,集成 updater/process/opener/log/tray-icon。相比 Electron 体积更小、性能更优、安全性更高。

⚛️

React 18

现代化的用户界面库,配合 TypeScript 提供类型安全。使用 Vite 作为构建工具,开发体验极佳,热重载速度快。

🔧

Rust 后端

系统级编程语言,提供高性能和内存安全。负责配置文件管理、供应商切换逻辑、原子写入与回滚等核心功能。

安装指南

选择适合你的安装方式

📦 Windows 安装

从 GitHub Releases 页面下载最新版本的安装包或绿色版。

下载选项
方式一:安装包(推荐)
下载:CC-Switch-v{版本号}-Windows.msi
双击安装即可

方式二:绿色版
下载:CC-Switch-v{版本号}-Windows-Portable.zip
解压后直接运行 CC-Switch.exe

🍎 macOS 安装

推荐使用 Homebrew 安装,也可以手动下载。

bash
# 方式一:Homebrew 安装(推荐)
brew tap farion1231/ccswitch
brew install --cask cc-switch

# 更新
brew upgrade --cask cc-switch

# 方式二:手动下载
# 从 Releases 下载 CC-Switch-v{版本号}-macOS.zip
# 解压后拖入应用程序文件夹

⚠️ 注意:首次打开可能出现"未知开发者"警告,请前往"系统设置" → "隐私与安全性" → 点击"仍要打开"

🐧 Linux 安装

支持 Ubuntu 22.04+、Debian 11+、Fedora 34+ 等主流发行版。

bash
# 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 供应商配置

1️⃣

添加供应商

点击"添加供应商"按钮,填写供应商名称、API 端点、API Key 等信息。支持从预设模板快速创建,也可以自定义配置。

2️⃣

切换供应商

在主界面选择目标供应商后点击切换,或通过系统托盘直接选择。切换会自动写入配置文件(Claude: settings.json,Codex: auth.json + config.toml)。

3️⃣

重启生效

切换完成后,重启或新开终端即可生效。若需切回官方登录,选择"官方登录"预设并切换,然后按官方流程登录即可。

配置说明

Claude Code 配置

  • 📁 配置目录:~/.claude/
  • 📄 主配置文件:settings.json(优先)或 claude.json
  • 🔑 API Key 字段:env.ANTHROPIC_AUTH_TOKEN
  • 💾 配置统一保存在:~/.cc-switch/config.json

Codex 配置

  • 📁 配置目录:~/.codex/
  • 📄 主配置文件:auth.json(必需)+ config.toml(可选)
  • 🔑 API Key 字段: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/          # 界面截图

开发指南

为开发者提供完整的开发环境配置和命令

环境要求

📦

Node.js 18+

JavaScript 运行时环境

📦

pnpm 8+

快速的包管理器

🦀

Rust 1.75+

系统编程语言

🔧

Tauri CLI 2.0+

Tauri 命令行工具

开发命令

bash
# 安装依赖
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

版本更新

持续迭代,不断完善

v3.5.0 (2025-01-15)

  • ✨ 新增 MCP 管理功能
  • ✨ 新增配置导入/导出功能
  • ✨ 新增端点速度测试
  • 🌐 完善国际化覆盖
  • 📦 新增 Longcat、kat-coder 预设
  • 🔧 标准化发布文件命名

v3.4.0 (2025-10-01)

  • 🌐 新增 i18next 国际化
  • 🔌 新增 Claude 插件同步
  • 🤖 支持新模型(qwen-3-max, GLM-4.6, DeepSeek-V3.2-Exp)
  • 🔒 单实例守护
  • 📱 托盘最小化优化

v3.0.0 (重大更新)

  • 🚀 从 Electron 迁移到 Tauri 2.0
  • 📦 应用体积显著降低
  • ⚡ 启动性能大幅提升
  • 🔧 全新的架构设计