CC Switch 一键切换 API：让 Claude Code / Codex / Gemini 多套 API 配置告别手改 JSON

写在前面

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

CC Switch 就是解决这个痛点的桌面工具，它提供一个统一的图形界面，让你可以把多套 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 新增）

---

安装

前往 GitHub Releases 下载对应平台的安装包：

项目地址：https://github.com/farion1231/cc-switch/releases/latest

拉到网页最底部，资源包部分，下载对应平台的安装包。

系统要求

系统	最低版本	架构
Windows	Windows 10 及以上	x64
macOS	macOS 10.15 (Catalina) 及以上	Intel (x64) / Apple Silicon (arm64)
Linux	见下表	x64 / arm64

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 安装

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

1. 下载 CC-Switch-vX.X.X-macOS.zip
2. 解压后将 CC Switch.app 拖入「应用程序」文件夹
3. 首次启动时右键点击 → 打开，或前往「系统设置 → 隐私与安全性 → 仍要打开」

⚠️ 由于作者没有 Apple 开发者账号，macOS 可能提示"未知开发者"。关闭提示后，前往「系统设置 → 隐私与安全性」点击「仍要打开」，之后每次均可正常启动。

方式二：Homebrew

# 添加 tap 并安装
brew tap farion1231/ccswitch
brew install --cask cc-switch

# 更新
brew upgrade --cask cc-switch

Linux 安装

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

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

AppImage 使用方式：

chmod +x CC-Switch-*.AppImage
./CC-Switch-*.AppImage

---

快速上手

安装完成后，按以下步骤完成首次配置：

第一步：启动 CC Switch

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

第二步：选择要管理的应用

主界面顶部是应用切换栏，点击对应图标（Claude Code / Codex / Gemini CLI 等）即可切换当前管理的应用，你可以在设置中隐藏不需要的应用。

第三步：添加第一个 Provider

点击右上角的 +，从内置预设中选择（如官方 Anthropic API、DeepSeek、阿里百炼等），或手动填写以下信息：

• 名称：便于区分的备注名
• API Key：服务商提供的密钥
• Base URL（可选）：自定义代理地址
• 模型：指定默认使用的模型名称
• API 格式：Anthropic Messages 原生格式 或 OpenAI Chat Completions 兼容格式

💡 关于 Provider 选哪个：内置预设里有官方 Anthropic API、DeepSeek、阿里百炼这类常用源；如果你的官方账号不方便用（海外信用卡、网络环境、封号风险等），也可以手动填一个国内中转地址。比如 Code80 就是把真实订阅账号转 API，填好 Base URL 和 Key 就能直接在 Claude Code、Codex 里跑，体验和官方一样。

第四步：切换 Provider

在列表中点击目标 Provider，再点击「启用」，CC Switch 会自动将配置写入对应 CLI 工具的配置文件。

在终端直接运行 claude 命令时，即会使用新配置。

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

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

💡 按 Cmd/Ctrl + , 快速打开设置；按 ESC 关闭当前面板。

---

进阶功能

MCP 服务器管理

在「MCP」面板中，可视化添加、编辑和删除 MCP（Model Context Protocol）服务器。配置自动同步到对应 CLI 工具，支持从已安装的应用一键导入现有 MCP 配置。

Skills 管理

Skills 是 Claude Code 的提示词增强功能。CC Switch 支持：

• 从 GitHub 仓库安装 Skills（内置 baoyu-skills 等预设仓库）
• 从本地 ZIP 文件安装
• 管理 Claude Code 和 Codex 的 Skills

会话管理器（Session Manager）

在「会话」页面，可浏览全部五个应用的历史对话记录，支持目录导航和会话内搜索，并自动按当前应用过滤显示。

备份管理

CC Switch 会定期自动备份数据库，在数据库迁移前也会自动备份。在「设置 → 备份管理」中可以：查看所有备份、重命名、删除，以及手动创建备份。

用量统计与计费

「用量」页面展示 Token 消耗统计，支持自动刷新、缓存命中率分析，以及按模型和 Provider 分类查看费用，帮助掌控 API 开支。

Claude Rectifier（思考签名修复）

当使用某些第三方 API 网关时，Claude 的 thinking block 格式可能不兼容。开启 Rectifier 后，代理层会自动修复此问题。可在「设置 → 高级」中开关。

WebDAV 自动同步

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

---

写在最后

CC Switch 把"在多套 API 之间来回切换"这件本来很繁琐的事压缩成了一次点击。如果你同时在用 Claude Code、Codex、Gemini CLI 中的两个或以上，或者经常需要在不同 Provider 之间对比效果、控制成本，这工具几乎就是刚需。

开源、跨平台、有图形界面、还顺手把 MCP、Skills、备份、用量统计这些事也办了——值得装一个放在系统托盘里。

---

常见问题（FAQ）

Q1：CC Switch 是开源的吗？数据安全吗？

A：是开源项目，GitHub 地址在 https://github.com/farion1231/cc-switch。所有数据存储在本地，API Key 不会上传到任何服务器。本地 API 代理也是跑在你自己电脑上的，可以放心。

Q2：macOS 提示"未知开发者"怎么办？

A：作者没有 Apple 开发者账号，所以会提示"未知开发者"。关闭提示后，前往「系统设置 → 隐私与安全性」点击「仍要打开」即可。之后每次启动都不会再提示。

Q3：CC Switch 切换 Provider 后，需要重启 CLI 工具吗？

A：不需要。CC Switch 切换后会自动将配置写入对应 CLI 工具的配置文件，下次在终端运行 claude、codex 等命令时即使用新配置。

Q4：怎么知道当前 Provider 是不是好用的？

A：用「健康检查」按钮。它会发送一个测试请求验证 API Key 和网络连通性。如果失败，CC Switch 会给出错误信息，方便你排查。

Q5：用第三方 API 网关时 thinking block 报错怎么办？

A：开启 Claude Rectifier。某些第三方网关返回的 thinking block 格式跟 Claude 官方不完全一致，Rectifier 会在代理层自动修复。在「设置 → 高级」中开关。

Q6：内置预设里没有的 Provider 怎么加？比如我想用国内的转发服务。

A：点 + 按钮，选择"自定义"，填写 Base URL 和 API Key 即可。如果你用的是像 Code80 这种真实订阅账号转 API 的服务，按服务商给的 endpoint 配上就能直接跑，模型能力跟官方一致，省掉了海外信用卡和网络环境的折腾。