生命不息,折腾不止。上一篇写了 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

二选一:

  1. 安装版:下载 CC-Switch-v3.19.2-Windows.msi,双击安装
  2. 绿色版:下载 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
2
3
4
5
6
7
8
9
10
11
12
13
# Debian / Ubuntu
wget https://github.com/farion1231/cc-switch/releases/download/v3.19.2/CC-Switch-v3.19.2-Linux-x86_64.deb
sudo dpkg -i CC-Switch-v3.19.2-Linux-x86_64.deb

# Fedora / RHEL
sudo dnf install CC-Switch-v3.19.2-Linux-x86_64.rpm

# 通用 AppImage(任何发行版)
chmod +x CC-Switch-v3.19.2-Linux-x86_64.AppImage
./CC-Switch-v3.19.2-Linux-x86_64.AppImage

# Arch Linux
paru -S cc-switch-bin

基本使用

安装后打开,主界面长这样:

CC Switch 主界面

三步上手:

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

添加供应商

  1. 设为当前:选中要用的供应商点”切换”,CC Switch 会自动写入 Claude Code / Codex 的配置文件
  2. 随时切换:换供应商点一下就行;还能用内置的速度测试比较各中转站的延迟,挑快的用

常见问题

  • 供应商和工具怎么对应? 每个供应商可以单独设置支持哪些工具(Claude Code / Codex / …),切换时只影响勾选的那些
  • 数据存在哪? 本地 SQLite:~/.cc-switch/cc-switch.db,支持配置导入导出,换电脑可以直接备份
  • macOS 打不开? 到”系统设置 → 隐私与安全性”里允许”仍要打开”(新版已签名公证,一般不会遇到)

其他版本

  • CLI 版cc-switch-cli(4.6k stars)——终端党专用,纯命令行切换
  • Web 版cc-switch-web(500 stars)——可部署到服务器,浏览器访问

参考