mirror of https://github.com/farion1231/cc-switch.git synced 2026-04-06 04:47:22 +08:00

Files

Jason 9336001746 feat(skills): auto-backup skill files before uninstall

Create a local backup under ~/.cc-switch/skill-backups/ before removing
skill directories. The backup includes all skill files and a meta.json
with original skill metadata. Old backups are pruned to keep at most 20.
The backup path is returned to the frontend and shown in the success
toast. Bump version to 3.12.3.

2026-03-15 23:26:50 +08:00

27 KiB

Raw Blame History

CC Switch

Claude Code、Codex、Gemini CLI、OpenCode 和 OpenClaw 的全方位管理工具

English | 中文 | 日本語 | 更新日志

❤️赞助商

点击折叠

MiniMax M2.5 在编程、工具调用与搜索、办公等核心生产力场景均达到或刷新行业 SOTA，拥有架构师级代码能力与高效任务拆解能力，推理速度较上一代提升 37%、token 消耗更优；100 token/s 连续工作一小时仅需 1 美金，让复杂 Agent 规模化部署经济可行，已在企业多职能场景深度落地，加速全民 Agent 时代到来。

点击即可领取 MiniMax Coding Plan 专属 88 折优惠！

	感谢 PackyCode 赞助了本项目！PackyCode 是一家稳定、高效的API中转服务商，提供 Claude Code、Codex、Gemini 等多种中转服务。PackyCode 为本软件的用户提供了特别优惠，使用此链接注册并在充值时填写"cc-switch"优惠码，首次充值可以享受9折优惠！
	感谢硅基流动赞助了本项目！硅基流动是一个高性能 AI 基础设施与模型 API 平台，一站式提供语言、语音、图像、视频等多模态模型的快速、可靠访问。平台支持按量计费、丰富的多模态模型选择、高速推理和企业级稳定性，帮助开发者和团队更高效地构建和扩展 AI 应用。通过此链接注册并完成实名认证，即可获得 ¥20 奖励金，可在平台内跨模型使用。硅基流动现已兼容 OpenClaw，用户可接入硅基流动 API Key 免费调用主流 AI 模型。
	感谢 AIGoCode 赞助了本项目！AIGoCode 是一个集成了 Claude Code、Codex 以及 Gemini 最新模型的一站式平台，为你提供稳定、高效且高性价比的AI编程服务。本站提供灵活的订阅计划，零封号风险，国内直连，无需魔法，极速响应。AIGoCode 为 CC Switch 的用户提供了特别福利，通过此链接注册的用户首次充值可以获得额外10%奖励额度！
	感谢 AICodeMirror 赞助了本项目！AICodeMirror 提供 Claude Code / Codex / Gemini CLI 官方高稳定中转服务，支持企业级高并发、极速开票、7×24 专属技术支持。 Claude Code / Codex / Gemini 官方渠道低至 3.8 / 0.2 / 0.9 折，充值更有折上折！AICodeMirror 为 CCSwitch 的用户提供了特别福利，通过此链接注册的用户，可享受首充8折，企业客户最高可享 7.5 折！
	感谢 Cubence 赞助本项目！Cubence 是一家可靠高效的 API 中继服务提供商，提供对 Claude Code、Codex、Gemini 等模型的中继服务，并提供按量、包月等灵活的计费方式。Cubence 为 CC Switch 的用户提供了特别优惠：使用此链接注册，并在充值时输入 "CCSWITCH" 优惠码，每次充值均可享受九折优惠！
	感谢 DMXAPI（大模型API）赞助了本项目！ DMXAPI，一个Key用全球大模型。为200多家企业用户提供全球大模型API服务。· 充值即开票 ·当天开票 ·并发不限制 ·1元起充 · 7x24 在线技术辅导，GPT/Claude/Gemini全部6.8折，国内模型5~8折，Claude Code 专属模型3.4折进行中！点击这里注册
	感谢优云智算赞助了本项目！优云智算是UCloud旗下AI云平台，提供稳定、全面的国内外模型API，仅一个key即可调用。主打包月、按量的高性价比 Coding Plan 套餐，基于官方2~5折优惠。支持接入 Claude Code、Codex 及 API 调用。支持企业高并发、7*24技术支持、自助开票。通过此链接注册的用户，可得免费5元平台体验金！
	感谢 Right Code 赞助了本项目！Right Code 稳定提供 Claude Code、Codex、Gemini 等模型的中转服务。主打极高性价比的Codex包月套餐，提供额度转结，套餐当天用不完的额度，第二天还能接着用！充值即可开票，企业、团队用户一对一对接。同时为 CC Switch 的用户提供了特别优惠：通过此链接注册，每次充值均可获得实付金额25%的按量额度！
	感谢 AICoding.sh 赞助了本项目！AICoding.sh —— 全球大模型 API 超值中转服务！Claude Code 1.9 折，GPT 0.1 折，已为数百家企业提供高性价比 AI 服务。支持 Claude Code、GPT、Gemini 及国内主流模型，企业级高并发、极速开票、7×24 专属技术支持，通过此链接注册的 CC Switch 用户，首充可享受九折优惠！
	感谢 Crazyrouter 赞助了本项目！Crazyrouter 是一个高性能 AI API 聚合平台——一个 API Key 即可访问 300+ 模型，包括 Claude Code、Codex、Gemini CLI 等。全部模型低至官方定价的 55%，支持自动故障转移、智能路由和无限并发。Crazyrouter 为 CC Switch 用户提供了专属优惠：通过此链接注册即可获得 $2 免费额度，首次充值时输入优惠码 `CCSWITCH` 还可获得额外 30% 奖励额度！
	感谢 SSSAiCode 赞助了本项目！SSSAiCode 是一家稳定可靠的API中转站，致力于提供稳定、可靠、平价的Claude、CodeX模型服务，提供高性价比折合0.5￥/$的官方Claude服务，支持包月、Paygo多种计费方式、支持当日快速开票，SSSAiCode为本软件的用户提供特别优惠，使用此链接注册每次充值均可享受10$的额外奖励！
	感谢米醋API 赞助了本项目！米醋API 是一家致力于提供极致性价比与高稳定性的全球大模型中转服务商。米醋API 背后有实体企业做核心保障，杜绝跑路风险，支持极速正规开票！我们主打“试错零成本”：1 元起充低门槛，0 手续费随时退款！米醋API 为本软件的用户提供了特别优惠，使用此链接注册并在充值时填写"ccswitch"优惠码可享九折优惠！
	感谢 XCodeAPI 赞助了本项目！XCodeAPI 为本软件的用户提供特别福利，使用此链接注册后首单加赠10%的额度!(联系站长领取)
	感谢 CTok.ai 赞助了本项目！CTok.ai 致力于打造一站式 AI 编程工具服务平台。我们提供 Claude Code 专业套餐及技术社群服务，同时支持 Google Gemini 和 OpenAI Codex。通过精心设计的套餐方案和专业的技术社群，为开发者提供稳定的服务保障和持续的技术支持，让 AI 辅助编程真正成为开发者的生产力工具。点击这里注册！

为什么选择 CC Switch？

现代 AI 编程依赖于 Claude Code、Codex、Gemini CLI、OpenCode 和 OpenClaw 等 CLI 工具——但每个工具都有自己的配置格式。切换 API 供应商意味着手动编辑 JSON、TOML 或 .env 文件，而在多个工具之间缺乏一个统一管理 MCP, SKILLS 的方式。

CC Switch 为你提供一个桌面应用来管理所有五个 CLI 工具。无需手动编辑配置文件，你将获得一个可视化界面，一键将供应商导入应用，一键在不同的供应商之间进行切换，内置 50+ 供应商预设、统一的 MCP, SKILLS 管理以及系统托盘即时切换功能——所有操作都基于可靠的 SQLite 数据库和原子写入机制，保护你的配置不被损坏。

一个应用，五个 CLI 工具 — 在单一界面中管理 Claude Code、Codex、Gemini CLI、OpenCode 和 OpenClaw
告别手动编辑 — 50+ 供应商预设，包括 AWS Bedrock、NVIDIA NIM 和社区中转服务；一键即可切换
统一 MCP, SKILLS 管理 — 一个面板管理四个应用的 MCP, SKILLS, 支持双向同步
系统托盘快速切换 — 从托盘菜单即时切换供应商，无需打开完整应用
云同步 — 通过 Dropbox、OneDrive、iCloud 或 WebDAV 服务器在不同设备之间同步供应商数据
跨平台 — 基于 Tauri 2 构建的原生桌面应用，支持 Windows、macOS 和 Linux
小工具 - 内置了多种小工具来解决首次安装登录确认、禁止签名、插件拓展同步等多种功能

界面预览

主界面	添加供应商

功能特性

完整更新日志 | 发布说明

供应商管理

5 个 CLI 工具，50+ 预设 — Claude Code、Codex、Gemini CLI、OpenCode、OpenClaw；复制 key 即可一键导入
通用供应商 — 一份配置同步到多个应用（OpenCode、OpenClaw）
一键切换、系统托盘快速访问、拖拽排序、导入导出

代理与故障转移

本地代理热切换 — 格式转换、自动故障转移、熔断器、供应商健康监控和整流器
应用级代理接管 — 独立为 Claude、Codex 或 Gemini 配置代理，具体到单个供应商

MCP、Prompts 与 Skills

统一 MCP 面板 — 管理 4 个应用的 MCP 服务器，双向同步，支持 Deep Link 导入
Prompts — Markdown 编辑器，跨应用同步（CLAUDE.md / AGENTS.md / GEMINI.md），回填保护
Skills — 从 GitHub 仓库或 ZIP 文件一键安装，自定义仓库管理，支持软连接和文件复制

用量与成本追踪

用量仪表盘 — 跨供应商追踪支出、请求数和 Token 用量，趋势图表、详细请求日志和自定义模型定价

会话管理器与工作区

浏览、搜索和恢复全部应用对话历史
工作区编辑器（OpenClaw）— 编辑 Agent 文件（AGENTS.md、SOUL.md 等），支持 Markdown 预览

系统与平台

云同步 — 自定义配置目录（Dropbox、OneDrive、iCloud、坚果云、NAS）及 WebDAV 服务器同步
Deep Link (ccswitch://) — 通过 URL 一键导入供应商、MCP 服务器、提示词和技能
深色 / 浅色 / 跟随系统主题、开机自启、自动更新、原子写入、自动备份、国际化（中/英/日）

常见问题

CC Switch 支持哪些 AI CLI 工具？

CC Switch 支持五个工具：Claude Code、Codex、Gemini CLI、OpenCode 和 OpenClaw。每个工具都有专属的供应商预设和配置管理。

切换供应商后需要重启终端吗？

大多数工具需要重启终端或 CLI 工具才能使更改生效。例外的是 Claude Code，它目前支持供应商数据的热切换，无需重启。

切换供应商之后我的插件配置怎么不见了？

CC Switch 使用“通用配置片段”功能，在不同的供应商之间传递 Key 和请求地址之外的通用数据，您可以在“编辑供应商”菜单的“通用配置面板”里，点击“从当前供应商提取”，把所有的通用数据提取到通用配置中，之后在新建“供应商”的时候，只要勾选“写入通用配置”（默认勾选），就会把插件等数据写入到新的供应商配置中。您的所有配置项都会保存在运行本软件的时候，第一次导入的默认供应商里面，不会丢失。

macOS 提示"未知开发者"警告 — 如何解决？

这是由于作者没有苹果开发者账号（正在注册中）。关闭警告后，前往系统设置 → 隐私与安全性 → 仍要打开。之后应用即可正常打开。

为什么总有一个正在激活中的供应商无法删除？

本软件的设计原则是“最小侵入性”，即使卸载本软件，也不会影响应用的正常使用。

所以系统总会保留一个正在激活中的配置，因为如果将所有配置全部删除，该应用将无法正常使用。如果你不经常使用某个对应的应用，可以在设置中关掉该应用的显示。如果你想切换回官方登录，可以参考下条。

如何切换回官方登录？

可以在预设供应商里面添加一个官方供应商。切换过去之后，执行一遍 Log out / Log in 流程，之后便可以在官方供应商和第三方供应商之间随意切换。CodeX 可以在不同官方供应商之间进行切换，方便多个 Plus 或者 Team 账号之间切换。

我的数据存储在哪里？

数据库：~/.cc-switch/cc-switch.db（SQLite — 供应商、MCP、提示词、技能）
本地设置：~/.cc-switch/settings.json（设备级 UI 偏好设置）
备份：~/.cc-switch/backups/（自动轮换，保留最近 10 个）
SKILLS：~/.cc-switch/skills/（默认通过软链接连接到对应应用）
技能备份：~/.cc-switch/skill-backups/（卸载前自动创建，保留最近 20 个）

文档

如需了解各项功能的详细使用方法，请查阅 用户手册 — 涵盖供应商管理、MCP/Prompts/Skills、代理与故障转移等全部功能。

快速开始

基本使用

添加供应商：点击"添加供应商" → 选择预设或创建自定义配置
切换供应商：
- 主界面：选择供应商 → 点击"启用"
- 系统托盘：直接点击供应商名称（立即生效）
生效方式：重启终端或对应的 CLI 工具以应用更改（CLaude Code 无需重启）
恢复官方登录：添加"官方登录"预设，重启 CLI 工具后按照其登录/OAuth 流程操作

MCP、Prompts、Skills 与会话

MCP：点击"MCP"按钮 → 通过模板或自定义配置添加服务器 → 切换各应用同步开关
Prompts：点击"Prompts" → 使用 Markdown 编辑器创建预设 → 激活后同步到 live 文件
Skills：点击"Skills" → 浏览 GitHub 仓库 → 一键安装到全部应用
会话：点击"Sessions" → 浏览和搜索和恢复全部应用对话历史

注意：首次启动可以手动导入现有 CLI 工具配置作为默认供应商。

下载安装

系统要求

Windows：Windows 10 及以上
macOS：macOS 10.15 (Catalina) 及以上
Linux：Ubuntu 22.04+ / Debian 11+ / Fedora 34+ 等主流发行版

Windows 用户

从 Releases 页面下载最新版本的 CC-Switch-v{版本号}-Windows.msi 安装包或 CC-Switch-v{版本号}-Windows-Portable.zip 绿色版。

macOS 用户

方式一：通过 Homebrew 安装（推荐）

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

更新：

brew upgrade --cask cc-switch

方式二：手动下载

从 Releases 页面下载 CC-Switch-v{版本号}-macOS.zip 解压使用。

注意：由于作者没有苹果开发者账号，首次打开可能出现"未知开发者"警告，请先关闭，然后前往"系统设置" → "隐私与安全性" → 点击"仍要打开"，之后便可以正常打开。

Arch Linux 用户

通过 paru 安装（推荐）

paru -S cc-switch-bin

Linux 用户

从 Releases 页面下载最新版本的 Linux 安装包：

CC-Switch-v{版本号}-Linux.deb（Debian/Ubuntu）
CC-Switch-v{版本号}-Linux.rpm（Fedora/RHEL/openSUSE）
CC-Switch-v{版本号}-Linux.AppImage（通用）
CC-Switch-v{版本号}-Linux.flatpak（Flatpak）

Flatpak 安装与运行：

flatpak install --user ./CC-Switch-v{版本号}-Linux.flatpak
flatpak run com.ccswitch.desktop

架构总览

设计原则

┌─────────────────────────────────────────────────────────────┐
│                    前端 (React + TS)                         │
│  ┌─────────────┐  ┌──────────────┐  ┌──────────────────┐    │
│  │ Components  │  │    Hooks     │  │  TanStack Query  │    │
│  │   （UI）     │──│ （业务逻辑）   │──│   （缓存/同步）    │    │
│  └─────────────┘  └──────────────┘  └──────────────────┘    │
└────────────────────────┬────────────────────────────────────┘
                         │ Tauri IPC
┌────────────────────────▼────────────────────────────────────┐
│                  后端 (Tauri + Rust)                         │
│  ┌─────────────┐  ┌──────────────┐  ┌──────────────────┐    │
│  │  Commands   │  │   Services   │  │  Models/Config   │    │
│  │ （API 层）   │──│  （业务层）    │──│    （数据）       │    │
│  └─────────────┘  └──────────────┘  └──────────────────┘    │
└─────────────────────────────────────────────────────────────┘

核心设计模式

SSOT（单一事实源）：所有数据存储在 ~/.cc-switch/cc-switch.db（SQLite）
双层存储：SQLite 存储可同步数据，JSON 存储设备级设置
双向同步：切换时写入 live 文件，编辑当前供应商时从 live 回填
原子写入：临时文件 + 重命名模式防止配置损坏
并发安全：Mutex 保护的数据库连接避免竞态条件
分层架构：清晰分离（Commands → Services → DAO → Database）

核心组件

ProviderService：供应商增删改查、切换、回填、排序
McpService：MCP 服务器管理、导入导出、live 文件同步
ProxyService：本地 Proxy 模式，支持热切换和格式转换
SessionManager：Claude Code 对话历史浏览
ConfigService：配置导入导出、备份轮换
SpeedtestService：API 端点延迟测量

开发指南

环境要求

Node.js 18+
pnpm 8+
Rust 1.85+
Tauri CLI 2.8+

开发命令

# 安装依赖
pnpm install

# 开发模式（热重载）
pnpm dev

# 类型检查
pnpm typecheck

# 代码格式化
pnpm format

# 检查代码格式
pnpm format:check

# 运行前端单元测试
pnpm test:unit

# 监听模式运行测试（推荐开发时使用）
pnpm test:unit:watch

# 构建应用
pnpm build

# 构建调试版本
pnpm tauri build --debug

Rust 后端开发

cd src-tauri

# 格式化 Rust 代码
cargo fmt

# 运行 clippy 检查
cargo clippy

# 运行后端测试
cargo test

# 运行特定测试
cargo test test_name

# 运行带测试 hooks 的测试
cargo test --features test-hooks

测试说明

前端测试：

使用 vitest 作为测试框架
使用 MSW (Mock Service Worker) 模拟 Tauri API 调用
使用 @testing-library/react 进行组件测试

运行测试：

# 运行所有测试
pnpm test:unit

# 监听模式（自动重跑）
pnpm test:unit:watch

# 带覆盖率报告
pnpm test:unit --coverage

技术栈

前端：React 18 · TypeScript · Vite · TailwindCSS 3.4 · TanStack Query v5 · react-i18next · react-hook-form · zod · shadcn/ui · @dnd-kit

后端：Tauri 2.8 · Rust · serde · tokio · thiserror · tauri-plugin-updater/process/dialog/store/log

测试：vitest · MSW · @testing-library/react

项目结构

├── src/                        # 前端 (React + TypeScript)
│   ├── components/
│   │   ├── providers/          # 供应商管理
│   │   ├── mcp/                # MCP 面板
│   │   ├── prompts/            # Prompts 管理
│   │   ├── skills/             # Skills 管理
│   │   ├── sessions/           # 会话管理器
│   │   ├── proxy/              # Proxy 模式面板
│   │   ├── openclaw/           # OpenClaw 配置面板
│   │   ├── settings/           # 设置（终端/备份/关于）
│   │   ├── deeplink/           # Deep Link 导入
│   │   ├── env/                # 环境变量管理
│   │   ├── universal/          # 跨应用配置
│   │   ├── usage/              # 用量统计
│   │   └── ui/                 # shadcn/ui 组件库
│   ├── hooks/                  # 自定义 hooks（业务逻辑）
│   ├── lib/
│   │   ├── api/                # Tauri API 封装（类型安全）
│   │   └── query/              # TanStack Query 配置
│   ├── locales/                # 翻译 (zh/en/ja)
│   ├── config/                 # 预设 (providers/mcp)
│   └── types/                  # TypeScript 类型定义
├── src-tauri/                  # 后端 (Rust)
│   └── src/
│       ├── commands/           # Tauri 命令层（按领域）
│       ├── services/           # 业务逻辑层
│       ├── database/           # SQLite DAO 层
│       ├── proxy/              # Proxy 模块
│       ├── session_manager/    # 会话管理
│       ├── deeplink/           # Deep Link 处理
│       └── mcp/                # MCP 同步模块
├── tests/                      # 前端测试
└── assets/                     # 截图 & 合作商资源

贡献

欢迎提交 Issue 反馈问题和建议！

提交 PR 前请确保：

通过类型检查：pnpm typecheck
通过格式检查：pnpm format:check
通过单元测试：pnpm test:unit

新功能开发前，欢迎先开 Issue 讨论实现方案，不适合项目的功能性 PR 有可能会被关闭。

27 KiB

Raw Blame History

CC Switch

Claude Code、Codex、Gemini CLI、OpenCode 和 OpenClaw 的全方位管理工具

❤️赞助商

为什么选择 CC Switch？

界面预览

功能特性

供应商管理

代理与故障转移

MCP、Prompts 与 Skills

用量与成本追踪

会话管理器与工作区

系统与平台

常见问题

文档

快速开始

基本使用

MCP、Prompts、Skills 与会话

下载安装

系统要求

Windows 用户

macOS 用户

Arch Linux 用户

Linux 用户

设计原则

环境要求

开发命令

Rust 后端开发

测试说明

技术栈

贡献

Star History

License

27 KiB Raw Blame History Unescape Escape

CC Switch

Claude Code、Codex、Gemini CLI、OpenCode 和 OpenClaw 的全方位管理工具

❤️赞助商

为什么选择 CC Switch？

界面预览

功能特性

供应商管理

代理与故障转移

MCP、Prompts 与 Skills

用量与成本追踪

会话管理器与工作区

系统与平台

常见问题

文档

快速开始

基本使用

MCP、Prompts、Skills 与会话

下载安装

系统要求

Windows 用户

macOS 用户

Arch Linux 用户

Linux 用户

设计原则

环境要求

开发命令

Rust 后端开发

测试说明

技术栈

贡献

Star History

License

27 KiB

Raw Blame History