【CC Switch】The All-in-One API Manager for AI Coding CLIs

文章目录

[一、背景：为什么需要 CC Switch？](#一、背景：为什么需要 CC Switch？)
[二、CC Switch 是什么？](#二、CC Switch 是什么？)
- [🛡️ 本地 API 代理](#🛡️ 本地 API 代理)
- [🔌 MCP 服务器管理](#🔌 MCP 服务器管理)
- [📊 用量统计与计费](#📊 用量统计与计费)
- [💾 备份与恢复](#💾 备份与恢复)
三、安装指南
四、快速上手
[五、v3.15.0 新版亮点（2026-05-16 发布）](#五、v3.15.0 新版亮点（2026-05-16 发布）)
六、总结
参考

CC Switch 使用指南：AI 编程 CLI 的多合一配置管理中心

还在为 Claude Code、Codex、Gemini CLI 各自维护一套 API 配置而头疼？CC Switch 帮你一键搞定。

一、背景：为什么需要 CC Switch？

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

更麻烦的是，每个工具的配置文件格式都不一样：

工具	配置文件格式
Claude Code	`claude.json / claude_desktop_config.json`
Codex	`.env / JSON`
Gemini CLI	`TOML`
OpenClaw	`openclaw.json`
OpenCode	`JSON`

CC Switch 正是为解决这个痛点而生------一个跨平台桌面应用，提供一个统一的图形界面，让你像遥控器一样切换 API 配置。

二、CC Switch 是什么？

⚠️ 注意：CC Switch 是完全免费的开源软件，如果有人向你收费，一定是假冒网站。请认准唯一官方网站：ccswitch.io ，源码仓库：github.com/farion1231/cc-switch

CC Switch 是一款跨平台的桌面端 AI 编程 CLI 统一管理工具，支持 Windows、macOS、Linux。它的核心能力包括：

🔄 一键切换 Provider

保存多套 API 配置，点一下即可切换，再也不用手动编辑 JSON 文件。支持 Provider 健康检查，一键验证 API Key 和网络连通性。

🖥️ 多应用统一管理

同时管理以下六款工具的配置：

🤖 Claude Code --- Anthropic 官方 CLI
⚡ Codex --- OpenAI 编程助手
✨ Gemini CLI --- Google 编程工具
🧩 OpenCode --- 开源 AI 编程 CLI
🦅 OpenClaw --- 本地 AI 网关
🏠 Claude Desktop (v3.15.0 新增)

🛡️ 本地 API 代理

内置高性能 HTTP 代理，支持自动故障转移与请求监控。Claude Desktop 切换第三方 Provider 也需要借助这个代理网关。

🔌 MCP 服务器管理

可视化添加、编辑和删除 MCP（Model Context Protocol）服务器，配置自动同步到对应 CLI 工具。

📊 用量统计与计费

实时查看 Token 消耗统计，支持自动刷新、缓存命中率分析，以及按模型和 Provider 分类查看费用。

💾 备份与恢复

定期自动备份数据库，支持重命名、删除和手动创建备份。防止误操作导致数据丢失。

三、安装指南

Windows

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

macOS

方式一：直接下载

下载 CC-Switch-vX.X.X-macOS.zip
解压后将 CC Switch.app 拖入「应用程序」文件夹
首次启动时右键点击 → 打开

⚠️ 因作者没有 Apple 开发者账号，macOS 会提示"未知开发者"。前往系统设置 → 隐私与安全性 → 仍要打开即可。

方式二：Homebrew

bash 复制代码

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

Linux

发行版	安装命令
Ubuntu / Debian	`sudo apt install ./CC-Switch-*.deb`
Fedora / RHEL	`sudo dnf install ./CC-Switch-*.rpm`
Arch / Manjaro	`chmod +x CC-Switch-.AppImage && ./CC-Switch-.AppImage`

四、快速上手

第一步：启动 CC Switch

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

第二步：添加 Provider

点击右上角的 + 按钮，可以从内置预设中选择（如 Anthropic 官方、DeepSeek、阿里百炼等），也可以手动填写：

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

第三步：切换 Provider

在列表中点击目标 Provider，再点击「启用」，CC Switch 会自动将配置写入对应 CLI 工具的配置文件。之后在终端直接运行 claude 命令时，即会使用新配置。

第四步：验证配置

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

五、v3.15.0 新版亮点（2026-05-16 发布）

v3.15.0 是一次重要更新，主要变化：

功能	说明
🏠 Claude Desktop 原生支持	第三方 Provider 通过内置代理网关接入 Claude Desktop，支持角色路由映射 (sonnet/opus/haiku)
🛡️ 反向代理加固	路由、生命周期、重试、故障转移全面增强，IPv6 监听支持
🗺️ 角色路由映射	支持 `supports1m` 长上下文标识，替代旧的 `[1M]` 后缀方案
🔍 Codex OAuth 实时模型列表	不再硬编码模型列表，从 ChatGPT 后端动态获取
📊 用量仪表盘升级	筛选驱动的 Hero 卡片，实时展示缓存命中和 Token 消耗
🤝 新增 Provider 预设	BytePlus、火山引擎 Agentplan、RunAPI、RelaxyCode、PatewayAI 等

六、总结

CC Switch 是目前最成熟的 AI 编程 CLI 配置管理工具，它解决了从 Claude Code 到 OpenClaw 几乎所有主流工具的多 Provider 管理难题。

适合人群：

🔹 经常切换 API 提供商（官方 ↔ 代理 ↔ 国内镜像）的开发者

🔹 同时使用多个 AI 编程 CLI 工具的重度用户

🔹 希望将非 Anthropic 模型接入 Claude Code/Desktop 的用户

🔹 需要集中管理 MCP 和 Skills 的团队

如果你也是 AI 编程的重度用户，CC Switch 能让你的配置管理效率提升一个台阶。

参考

本文发布于 2026-05-23 | CC Switch 版本 v3.15.0