【CC Switch】The All-in-One API Manager for AI Coding CLIs
文章目录
- 一、背景：为什么需要 CC Switch？
- 二、CC Switch 是什么？
- 🛡️ 本地 API 代理
- 🔌 MCP 服务器管理
- 📊 用量统计与计费
- 💾 备份与恢复
- 三、安装指南
- 四、快速上手
- 五、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
brew tap farion1231/ccswitch brewinstall--caskcc-switchLinux
| 发行版 | 安装命令 |
|---|---|
| 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 能让你的配置管理效率提升一个台阶。
参考
- https://github.com/farion1231/cc-switch/releases/tag/v3.15.0
- https://www.runoob.com/ai-agent/cc-switch.html
本文发布于 2026-05-23 | CC Switch 版本 v3.15.0