CC Switch 安装教程:AI 编程工具配置一键切换
生命不息,折腾不止。上一篇写了 Sub2API 部署,这篇配套来一个桌面小工具:CC Switch —— 装好它,Claude Code、Codex 的 API 供应商配置就能像换壁纸一样一键切换。
这是什么
CC Switch 是一个开源的跨平台桌面工具(GitHub 上 127k+ stars),专为 AI 编程工具设计:
- 支持 Claude Code、Codex、OpenCode、OpenClaw、Grok Build、Hermes Agent 等主流工具
- 把多个 API 供应商配置(官方、各种中转站)存起来,点一下就能切换,不用再手动改配置文件
- 还带 MCP 服务器管理、配置导入导出、速度测试(测每个中转的延迟)、会话历史浏览等功能
简单说:你手里有 N 个中转站/Key,CC Switch 就是它们的遥控器。
技术栈:Tauri 2(Rust 后端 + React 前端)原生桌面应用,数据存在本地 SQLite(~/.cc-switch/cc-switch.db),轻量不占资源。
下载安装
最新版本 v3.19.2(2026-08-06 发布),下载地址:https://github.com/farion1231/cc-switch/releases
系统要求:Windows 10+ / macOS 12+ / Linux(Ubuntu 22.04+、Debian 11+、Fedora 34+)
🪟 Windows
二选一:
- 安装版:下载
CC-Switch-v3.19.2-Windows.msi,双击安装 - 绿色版:下载
CC-Switch-v3.19.2-Windows-Portable.zip,解压即用,免安装
🍎 macOS
方式一:Homebrew(推荐)
1 | brew install --cask cc-switch |
方式二:手动下载 CC-Switch-v3.19.2-macOS.dmg,拖进应用程序即可。
(macOS 版已通过苹果签名公证,不会提示”无法打开”)
🐧 Linux
1 | # Debian / Ubuntu |
基本使用
安装后打开,主界面长这样:

三步上手:
- 添加供应商:点”添加”,填入名称、API 地址、API Key(就是中转站给你的那串)

- 设为当前:选中要用的供应商点”切换”,CC Switch 会自动写入 Claude Code / Codex 的配置文件
- 随时切换:换供应商点一下就行;还能用内置的速度测试比较各中转站的延迟,挑快的用
常见问题
- 供应商和工具怎么对应? 每个供应商可以单独设置支持哪些工具(Claude Code / Codex / …),切换时只影响勾选的那些
- 数据存在哪? 本地 SQLite:
~/.cc-switch/cc-switch.db,支持配置导入导出,换电脑可以直接备份 - macOS 打不开? 到”系统设置 → 隐私与安全性”里允许”仍要打开”(新版已签名公证,一般不会遇到)
其他版本
- CLI 版:cc-switch-cli(4.6k stars)——终端党专用,纯命令行切换
- Web 版:cc-switch-web(500 stars)——可部署到服务器,浏览器访问
参考
本博客所有文章除特别声明外,均采用 CC BY-NC-SA 4.0 许可协议。转载请注明来源 空缺的博客!
评论