CC Switch 一键切换 API 工具文档

项目简介

随着 Claude Code、OpenAI Codex、Gemini CLI 等 AI 编程工具的流行，开发者往往需要在多个 API 提供商之间频繁切换——官方 API、国内镜像、第三方代理……每次手动修改配置文件既繁琐又容易出错。

CC Switch 正是解决这个痛点的桌面端统一管理工具，通过可视化图形界面，实现多 AI 工具、多 API 配置的一键管理与切换。

核心功能

功能	说明
🔄 一键切换 Provider	保存多套 API 配置，点击即可切换，无需手动编辑 JSON 配置文件
🖥️ 多应用统一管理	同时管理 Claude Code、Codex、Gemini CLI、OpenCode、OpenClaw 五款工具
🛡️ 本地 API 代理	内置高性能 HTTP 代理，支持自动故障转移与请求监控
🔌 MCP 服务器管理	可视化添加、编辑和同步 MCP 服务器配置
📊 用量统计	实时查看 Token 消耗与 API 费用明细
💾 备份与恢复	自动备份配置，防止误操作导致数据丢失

支持管理的应用

🤖 Claude Code（Anthropic）

⚡ Codex（OpenAI）

✨ Gemini CLI（Google）

🧩 OpenCode（开源）

🦅 OpenClaw（v3.11.0 新增）

系统要求

系统	最低版本	支持架构
Windows	Windows 10 及以上	x64
macOS	macOS 10.15 (Catalina) 及以上	Intel (x64) / Apple Silicon (arm64)
Linux	各主流发行版	x64 / arm64

安装指南

下载地址

前往 GitHub Releases 下载对应平台安装包：
https://github.com/farion1231/cc-switch/releases/latest

拉取页面至底部资源包区域，选择对应系统文件下载。

Windows 安装

安装文件	说明
CC-Switch-vX.X.X-Windows.msi	✅ 推荐，MSI 安装包，支持自动更新
CC-Switch-vX.X.X-Windows-Portable.zip	便携版，解压即用，不写入注册表

安装步骤：

双击 MSI 文件，按照向导完成安装

开始菜单搜索「CC Switch」启动程序

⚠️ 注意：Windows 版本已禁用「一键安装」功能，需手动安装 Claude Code 等工具后，再使用 CC Switch 管理。

macOS 安装

方式一：直接下载（推荐）

下载 CC-Switch-vX.X.X-macOS.zip 并解压

将 CC Switch.app 拖入「应用程序」文件夹

首次启动：右键 → 打开，或前往系统设置 → 隐私与安全性 → 仍要打开

⚠️ 提示：因无 Apple 开发者账号，系统会提示「未知开发者」，按上述步骤授权后即可正常使用。

方式二：Homebrew

Linux 安装

根据发行版选择对应格式：

发行版	推荐格式	安装命令
Ubuntu / Debian / Mint	.deb	`sudo apt install ./CC-Switch-*.deb`
Fedora / RHEL / Rocky	.rpm	`sudo dnf install ./CC-Switch-*.deb`
openSUSE	.rpm	`sudo zypper install ./CC-Switch-*.rpm`
Arch / Manjaro / 其他	.AppImage	见下方

AppImage 使用方式：

快速上手（5 步完成首次配置）

第一步：启动 CC Switch

首次启动自动检测已安装的 CLI 工具并导入现有配置，系统托盘会显示 CC Switch 图标。

第二步：选择管理应用

主界面顶部为应用切换栏，点击对应图标（Claude Code / Codex 等）切换管理对象，可在设置中隐藏无需管理的应用。

第三步：添加第一个 Provider

点击右上角 + 号，支持两种方式：

从内置预设选择（官方 Anthropic API、DeepSeek、阿里百炼等）

手动填写配置：

名称：自定义备注名

API Key：服务商提供的密钥

Base URL（可选）：自定义代理地址

模型：指定默认使用模型

API 格式：Anthropic 原生格式 / OpenAI 兼容格式

第四步：切换 Provider

在列表中选中目标 Provider

点击「启用」，程序自动写入对应 CLI 配置文件

终端直接运行 claude 等命令，即可使用新配置

第五步：验证配置（可选）

点击 Provider 旁的健康检查按钮，发送测试请求验证 API Key 与网络连通性。

💡 快捷操作：Cmd/Ctrl + , 打开设置；ESC 关闭当前面板

进阶功能详解

1. MCP 服务器管理

在「MCP」面板中，可视化增删改查 MCP（Model Context Protocol）服务器配置，自动同步到对应 CLI 工具，支持一键导入现有配置。

2. Skills 管理

专为 Claude Code 设计的提示词增强功能：

从 GitHub 仓库安装（内置 baoyu-skills 等预设）

从本地 ZIP 文件安装

统一管理 Claude Code + Codex 的 Skills

3. 会话管理器（Session Manager）

「会话」页面可浏览全部五款应用的历史对话，支持目录导航、会话搜索，自动按当前应用过滤内容。

4. 备份管理

程序定期自动备份数据库，迁移前自动备份

支持手动创建备份、查看/重命名/删除备份

路径：设置 → 备份管理

5. 用量统计与计费

「用量」页面展示 Token 消耗、缓存命中率、按模型/服务商分类的费用统计，实时掌控 API 开支。

6. Claude Rectifier（思考签名修复）

解决第三方 API 网关导致的 Claude thinking block 格式不兼容问题，在设置 → 高级中开启/关闭。

7. WebDAV 自动同步

支持将配置数据库同步到 WebDAV 服务（如坚果云），实现多设备配置共享，内置大文件保护机制，防止误传。

总结

CC Switch 是AI 编程工具 API 配置一站式管理工具，解决多平台、多镜像手动切换的痛点；

支持 Windows/macOS/Linux 全平台，一键安装/便携版双选择，上手门槛极低；

cc-switch

CC Switch 一键切换 API 工具文档#

项目简介#

核心功能#

支持管理的应用#

系统要求#

安装指南#

下载地址#

Windows 安装#

macOS 安装#

方式一：直接下载（推荐）#

方式二：Homebrew#

Linux 安装#

快速上手（5 步完成首次配置）#

第一步：启动 CC Switch#

第二步：选择管理应用#

第三步：添加第一个 Provider#

第四步：切换 Provider#

第五步：验证配置（可选）#

进阶功能详解#

1. MCP 服务器管理#

2. Skills 管理#

3. 会话管理器（Session Manager）#

4. 备份管理#

5. 用量统计与计费#

6. Claude Rectifier（思考签名修复）#

7. WebDAV 自动同步#

总结#