概述

随着 Claude Code 和 Codex 等 LLM 编程助手的普及，越来越多开发者会用到不同供应商（如 OpenAI、Anthropic、DeepSeek 等）的 API 或插件。在多供应商共存与频繁切换需求下，手动维护配置繁琐且容易出错。为此，社区涌现了各类「配置切换」工具，而 cc-switch 正是一款专为此场景开发的开源跨平台桌面应用。

---

一、项目简介

cc-switch 是一个用于管理和切换 Claude Code 及 Codex 不同供应商配置的桌面应用，支持 Windows、macOS 和主流 Linux 发行版。本项目采用 Tauri 2 框架构建，前端基于 React + TypeScript，后端由 Rust 驱动，兼具体积小、性能优与现代化 UI。

---

二、核心功能与亮点

• MCP（Model Context Protocol）管理
  提供标准的 MCP 服务器配置管理，支持 stdio/http 两种类型，内置模板与命令校验，便于一键添加或切换 LLM 服务。

• 一键导入/导出与备份恢复
  配置可一键导出为 JSON 文件，导入时自动验证与轮换备份（保留最近10个），安全无忧。
• 端点速度测试
  支持对所有 API 端点进行延迟测量，结果可视化，助你选择最快供应商。
• 完整国际化支持
  基于 i18next 框架实现，默认中文，随时切换英文界面。
• 插件与预设扩展
  内置 Longcat、kat-coder 等新模型预设，主流 Claude/Codex 插件一键同步。
• 托盘与窗口管理
  macOS 可隐藏 Dock、最小化到托盘、与主窗口状态同步。
• 标准化命名与多平台绿色分发
  所有平台统一发布规范，便于用户选择和升级。

---

三、下载安装 & 快速上手

1. Windows

• 访问 Releases 页面，下载最新的 .msi 安装包或绿色版 .zip。

2. macOS

推荐使用 Homebrew：

brew tap farion1231/ccswitch
brew install --cask cc-switch

或手动下载 zip 包，初次打开请在「隐私与安全性」设置允许。

3. Linux

下载 .deb 或 .AppImage 包，兼容 Ubuntu、Debian、Fedora 等主流发行版。

---

四、核心用法说明

1. 添加供应商
   主界面点击“添加供应商”，填写 API Key、端点等信息即可。
2. 一键切换
   在主界面选择目标供应商点击“切换”，或通过系统托盘菜单操作，自动写入 live 配置。
3. 配置同步与备份
   支持导入现有配置，应用自动归档、去重与合并，方便长期管理和迁移。
4. MCP 高级管理
   MCP 配置集中于 ~/.cc-switch/config.json，按照客户端类别区分，支持字段校验与回滚。

---

五、技术选型与架构实现

• 技术栈：
  • Tauri 2 + Rust：负责桌面端底层、系统集成、配置文件写入与回滚；
  • React 18 + TypeScript + TailwindCSS：前端界面、数据联动与国际化；
  • TanStack Query：统一前端数据访问、缓存与状态管理；
  • i18next：国际化核心；
• 设计思路：
  • 配置集中管理，单一事实源（SSOT）；
  • 原子写入与事务回滚防止配置损坏；
  • 前后端分离，可靠性与可维护性兼具。

---

六、适用人群与场景

• 需要同时切换、对比多个 Claude Code/Codex 供应商的开发者
• 构建 AI 工具链、集成多模型编程助手的场景
• 希望批量管理和备份 API 密钥、Endpoint、插件配置的团队或个人

---

七、开源与参与

项目已在 GitHub 开源，采用 MIT 许可证，欢迎提交 Issue 与 PR。更多详细用法和更新可查阅 项目主页 和 [CHANGELOG.md]。

---

通过 cc-switch，开发者可以极大简化日常多供应商 LLM 编程助手的配置、切换和管理流程，从而更专注于代码本身与创新应用的开发。 1