# CC Switch 使用教程：一键切换 Claude Code / Codex 的 API 供应商

> 开源桌面工具 CC Switch 怎么装、怎么用？如何把多个中转站的 key 存成供应商配置，在 Claude Code、Codex 之间一键切换？国内用户实操教程。
> 更新于 2026-08-04 · 难度 进阶 · 来源 https://aicdks.com/guides/cc-switch-tutorial

用过[中转额度](/guides/what-is-api-relay)的人都懂这个痛点：手里攒了好几家中转站的 key，Claude Code 要改 `~/.claude/settings.json`，Codex 要改 `~/.codex/auth.json` 和 `config.toml`，每换一家就手动改一遍文件，改错一个字段就跑不起来。**CC Switch** 就是解决这个问题的开源桌面工具：把每家供应商存成一条配置，点一下就切换。

> 项目地址：[github.com/farion1231/cc-switch](https://github.com/farion1231/cc-switch)（截至 2026‑08 约 12 万+ star，最新版 v3.19.x，更新非常活跃），官网 [ccswitch.io](https://ccswitch.io)。具体功能以官方 README 为准。

## CC Switch 是什么

- 基于 Tauri 2 的**跨平台桌面应用**（Windows / macOS / Linux），图形界面，不用记命令；
- 一个界面管理多个 AI 工具的供应商配置：Claude Code、Claude Desktop、Codex、Gemini CLI 等（新版本还支持 OpenCode 等更多工具）；
- 内置 50+ 供应商预设（官方登录、各家中转、AWS Bedrock 等），也可以完全自定义 Base URL + Key；
- 支持系统托盘直接切换、多设备云同步（WebDAV 等）、统一管理 MCP 与 skills 配置。

## 第一步：下载安装

到 [GitHub Releases](https://github.com/farion1231/cc-switch/releases) 下载对应平台的安装包（Windows 是 `.exe`/`.msi`，macOS 是 `.dmg`，Linux 有 `.AppImage`/`.deb`）。macOS 首次打开如果提示无法验证开发者，在「系统设置 → 隐私与安全性」里允许即可。

## 第二步：添加供应商

以「给 Claude Code 添加一个中转站」为例：

1. 打开 CC Switch，顶部切到 **Claude Code** 标签；
2. 点「添加供应商」，选一个预设或选择自定义；
3. 填入中转站给你的 **Base URL** 和 **API Key**（买[中转额度](/category/api-中转与额度-claude-额度)后商品页/卡密里会给这两样）；
4. 保存。Codex 同理，在 **Codex** 标签下添加（Codex 的配置会写入 `auth.json` + `config.toml`，工具会帮你处理格式）。

如果你之前已经手动配置过，CC Switch 首次使用时可以把当前的 live 配置**导入为默认供应商**，不会丢现有配置。

## 第三步：一键切换

- 在主界面选中目标供应商，点切换；或直接从**系统托盘菜单**选择，立即生效；
- 切换的本质是把目标供应商的配置写入对应工具的 live 配置文件（Claude Code 是 `settings.json`；Codex 是 `auth.json` + `config.toml`）；
- **切换后新开一个终端**再运行 `claude` / `codex`，确保新配置生效；
- 想切回官方账号登录，选择内置的「官方登录」预设，重启终端后按官方流程 `/login` 即可。

## 实用建议

- **额度用尽秒切备用**：主力中转限流或维护时，托盘一点就切到备用家，任务不中断——建议常备两家以上[中转额度](/category/api-中转与额度)；
- **官方订阅 + 中转混用**：日常用官方订阅（Pro/Max），跑批量任务前切到便宜的按量中转；
- **改前备份**：CC Switch 有配置迁移与备份机制，但手动改过大量配置的建议先自己备份 `~/.claude/` 和 `~/.codex/`；
- key 属于敏感信息，只存在本地配置里，不要截图外传。

## 和 Claude Code Router 怎么选

CC Switch 是「切换器」：改的是本地配置文件，一次只用一家。如果你想要**自动路由**（按任务把请求分发给不同模型、失败自动切换），要用的是网关类工具（如 Claude Code Router），两类工具的对比见 [开源 API 切换与管理工具对比](/guides/api-switching-tools-compared)。

## 相关教程

- [API 中转是什么](/guides/what-is-api-relay)
- [Claude Code 安装教程](/guides/install-claude-code-china) / [Codex 安装教程](/guides/install-codex-cli-china)
- [国内常见报错排错指南](/guides/codex-claude-code-troubleshooting)