CC Switch 一键切换 API
随着 Claude Code、OpenAI Codex、Gemini CLI 等 AI 编程工具的流行，开发者往往需要在多个 API 提供商之间频繁切换——官方 API、国内镜像、第三方代理……每次手动修改配置文件既繁琐又容易出错。
CC Switch 就是解决这个痛点的桌面工具，它提供一个统一的图形界面，让你可以：
功能
说明
🔄 一键切换 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
方式一：直接下载（推荐）
下载 CC-Switch-vX.X.X-macOS.zip
解压后将 CC Switch.app 拖入「应用程序」文件夹
首次启动时右键点击 → 打开，或前往「系统设置 → 隐私与安全性 → 仍要打开」
⚠️ 由于作者没有 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
在列表中点击目标 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 服务（如坚果云），实现多设备间的配置共享。内置大文件保护机制，防止误传。