为什么选择 CC Switch？

AI老猿博士
0 阅读6分钟

为什么选择 CC Switch？

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

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

核心优势

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

界面预览

主界面概览

主界面添加供应商界面
主界面
添加供应商

功能特性

完整功能列表：

  • 供应商管理 — 支持 8 个 AI 工具，50+ 预设供应商，复制 API Key 即可一键导入
  • 通用供应商配置 — 一份配置同步到 Claude Code、Codex 和 Gemini CLI
  • 一键切换与拖拽排序 — 快速切换供应商，支持拖拽自定义排序
  • 代理与故障转移 — 本地代理热切换、自动故障转移、熔断器、供应商健康监控
  • 应用级代理接管 — 独立为每个 AI 工具配置代理，精确到单个供应商

核心模块

MCP、Prompts 与 Skills

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

用量与成本追踪

  • 用量仪表盘 — 跨供应商追踪支出、请求数和 Token 用量
  • 趋势图表与详细日志 — 可视化数据展示，详细请求日志记录
  • 自定义模型定价 — 支持自定义模型价格配置

会话管理器与工作区

  • 会话管理 — 浏览、搜索和恢复支持的会话来源
  • 工作区编辑器 — 编辑 Agent 文件（AGENTS.md、SOUL.md 等），支持 Markdown 预览

系统与平台功能

  • 云同步 — 支持 Dropbox、OneDrive、iCloud、坚果云、NAS 及 WebDAV 服务器
  • Deep Link 支持 — 通过 ccswitch:// URL 一键导入供应商、MCP 服务器、提示词和技能
  • 主题与外观 — 深色/浅色/跟随系统主题切换
  • 系统集成 — 开机自启、自动更新、原子写入、自动备份
  • 国际化 — 支持简体中文、繁体中文、英文、日文

快速开始指南

基本使用

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

高级功能使用

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

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

下载与安装

系统要求

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

Windows 用户

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

macOS 用户

方式一：通过 Homebrew 安装（推荐）
brew install --cask cc-switch

更新：

brew upgrade --cask cc-switch
方式二：手动下载

从 Releases 页面下载 CC-Switch-v{版本号}-macOS.dmg（推荐）或 .zip。

**注意：**CC Switch macOS 版本已通过 Apple 代码签名和公证，可直接安装打开。

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（通用）

**Flatpak：**官方 Release 不包含 Flatpak 包。如需使用，可从 .deb 自行构建 — 参见 flatpak/README.md。

常见问题

  • CC Switch 支持哪些 AI 工具？ — 支持 Claude Code、Claude Desktop、Codex、Gemini CLI、Grok Build、OpenCode、OpenClaw 和 Hermes
  • 切换供应商后需要重启终端吗？ — 需要重启终端或对应的 CLI 工具（Claude Code 除外）
  • 切换供应商之后我的插件配置怎么不见了？ — 插件配置与供应商绑定，切换供应商时会自动切换对应的插件配置
  • macOS 安装问题 — 确保系统版本符合要求，如遇问题可查看官方文档
  • 为什么总有一个正在激活中的供应商无法删除？ — 当前激活的供应商需要先切换到其他供应商后才能删除
  • 如何切换回官方登录？ — 添加"官方登录"预设并启用，然后按照官方工具的登录流程操作
  • 我的数据存储在哪里？ — 数据存储在应用配置目录的 SQLite 数据库中
  • Linux（Wayland + NVIDIA）：网页内容点不动、缩放后黑屏 — 这是已知的图形驱动兼容性问题，建议使用 X11 会话或更新显卡驱动

文档与支持

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

架构总览与开发指南

了解项目结构、技术架构和开发指南，请参考项目文档中的相关章节。

avatar
文章
阅读
粉丝