资源分享 - CC Switch （Claude Code、Codex、Gemini CLI、OpenCode 和 OpenClaw 的全方位管理工具）

网盘资源
,
1

文章转载于 farion1231 (Jason Young)
原文来自：cc-switch/README_ZH.md at main · farion1231/cc-switch · GitHub

CC Switch — 五合一 AI CLI 配置管理器

一个桌面端工具，帮你统一管理 Claude Code、Codex、Gemini CLI、OpenCode、OpenClaw 的供应商配置、MCP 服务器、提示词和技能扩展。

它解决什么问题？

用过 AI 编程 CLI 的人都知道痛点：每个工具的配置格式不一样——Claude Code 用 JSON，OpenCode 用 TOML，有的靠 .env。想换个 API 供应商？手动改配置文件。想在几个工具之间统一 MCP 插件？逐个配置。

CC Switch 把这些事收到一个界面里完成。

核心能力一览

供应商切换

  • 内置 50+ 供应商预设（AWS Bedrock、NVIDIA NIM、各类社区中转等），填入 API Key 即可启用
  • 主界面一键切换，或直接从系统托盘菜单切换，无需打开完整窗口
  • Claude Code 支持热切换，其余工具切换后重启终端生效

统一插件管理

  • 一个面板管理四个应用的 MCP 服务器配置，支持双向同步
  • Prompts 编辑器跨应用同步（CLAUDE.md / AGENTS.md / GEMINI.md）
  • Skills 支持从 GitHub 仓库或 ZIP 包一键安装

本地代理与故障转移

  • 内置代理服务器，支持请求格式自动转换
  • 配置多个供应商时可启用自动故障转移和熔断机制
  • 可按应用、按供应商独立配置代理规则

数据与会话

  • 用量仪表盘追踪各供应商的花费、请求量和 Token 消耗
  • 会话管理器可浏览、搜索、恢复所有应用的对话历史
  • 所有数据存储在本地 SQLite 数据库，原子写入防损坏，自动备份

云同步

  • 支持通过 Dropbox、OneDrive、iCloud、WebDAV 在多台设备间同步配置
  • Deep Link（ccswitch://）支持通过 URL 一键导入供应商、MCP、提示词和技能

平台支持

平台 最低要求 安装方式
Windows Windows 10+ .msi 安装包 / .zip 绿色版
macOS macOS 12 Monterey+ Homebrew（推荐）/ .dmg
Linux Ubuntu 22.04+ / Debian 11+ / Fedora 34+ .deb / .rpm / .AppImage
Arch Linux — paru -S cc-switch-bin

macOS 版本已通过 Apple 代码签名和公证，下载后可直接打开。

Homebrew 安装（macOS）：

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

下载地址

所有平台的安装包均可在 GitHub Releases 页面获取：

Releases · farion1231/cc-switch · GitHub

上手步骤

  1. 安装并启动 CC Switch
  2. 点击「添加供应商」，从预设列表中选择或自定义配置，填入 API Key
  3. 点击「启用」即完成切换（Claude Code 立即生效，其余重启终端）
  4. 如需管理 MCP / Prompts / Skills，在对应面板中操作，开启同步开关即可同步到各应用

首次启动时可直接导入现有 CLI 工具的配置作为默认供应商。

常见疑问

切换供应商后原来的插件配置丢了？
在「编辑供应商」→「通用配置面板」中点击「从当前供应商提取」，将插件等通用数据保存下来。之后新建供应商时默认会勾选「写入通用配置」，自动带入这些数据。

为什么有一个供应商无法删除？
CC Switch 遵循「最小侵入」原则——始终保留一个活跃配置，确保即使卸载本工具，CLI 应用也能正常使用。

想切回官方账号登录？
添加一个「官方登录」预设供应商，切换后重新执行 Log out / Log in 流程即可。之后可在官方和第三方供应商之间自由切换。

数据存储位置

~/.cc-switch/
├── cc-switch.db          # SQLite 数据库（供应商、MCP、提示词、技能）
├── settings.json         # 本地 UI 偏好设置
├── backups/              # 自动备份（保留最近 10 个）
├── skills/               # 技能文件（软链接到各应用）
└── skill-backups/        # 技能备份（保留最近 20 个）

技术栈

  • 前端：React 18 + TypeScript + Vite + TailwindCSS + TanStack Query v5
  • 后端：Tauri 2.8 + Rust + SQLite
  • 构建：基于 Tauri 2 的跨平台原生桌面应用

基于 cc-switch 项目整理，详细功能文档见原仓库。

image
image1920×1003 74.4 KB