写代码一时爽，换模型火葬场。

如果你用过 Claude Code、Codex、Gemini CLI 中的任何一个，你一定懂我在说什么。

先说你正在经历的痛

每天都在用 AI 写代码的人，几乎都踩过这些坑：

• 想换个模型试试？先找到 ~/.claude/settings.json，小心翼翼改 JSON，一个逗号错了就崩
• 手上有好几个 API Key（官方的、中转的、国内模型的）？每次切换至少折腾 5 分钟
• MCP 服务器配置散落在不同工具里，这边配了那边忘
• 好不容易配好了一个供应商，改崩了想回滚？对不起，没备份
• 换台电脑？从头再来一遍

这些不是个例，是整个 AI 编程工具链的「最后一公里」问题。

而今天要聊的这个开源工具，就是专为这「最后一公里」而生的。

它到底是什么？

CC-Switch，一个开源的跨平台桌面应用。GitHub 上叫 farion1231/cc-switch，MIT 协议，完全免费。

它的定位非常清晰：AI 编程 CLI 工具的统一配置管理中心。

说人话就是：

你所有 AI 编程工具的 API Key、模型、路由、MCP、Skills，全部收到一个面板里，点一下就能切换。

它目前支持 7 个工具：

7 个工具，1 个面板，50+ 内置供应商预设。 体量却只有 9MB 左右。

最炸裂的 6 个能力

1. 一键切换供应商，告别手动改 JSON

这是 CC-Switch 最核心、最刚需的功能。

安装包里内置了 50 多个供应商预设——Anthropic 官方、DeepSeek、智谱 GLM、Kimi、通义千问、硅基流动、MiniMax……甚至 AWS Bedrock、NVIDIA NIM。

你只需要：

1. 点「添加供应商」
2. 从预设里选一个
3. 粘贴你的 API Key
4. 点保存

完事。

以后想换模型？在主界面点一下目标供应商，再点「启用」——Claude Code 立刻生效，不用重启终端，不用改任何配置文件。

下面这个图，就是一次完整的供应商切换全流程：

从「5 分钟手动改 JSON」到「1 秒一键切换」，这个体验的差距，谁用谁知道。

【配图建议：CC-Switch 供应商列表主界面截图，标注「添加」「启用」「系统托盘」等关键操作按钮】

2. 统一管理 MCP、Prompts 和 Skills

如果你用过 Claude Code，你一定知道 MCP 服务器配置有多麻烦——每个工具有自己的配置格式，每次新增一个 MCP 要写好几处。

CC-Switch 提供了一个 统一 MCP 面板：

• 可视化添加/编辑/删除 MCP 服务器
• 支持 stdio、HTTP、SSE 三种传输方式
• 双向同步
  ：在面板里改了，自动写入对应工具的 live 配置文件
• 支持 Deep Link 一键导入：别人分享的 MCP 配置，点个链接就能装

Skills 也一样：

• 从 GitHub 仓库一键安装
• 支持软链接和文件复制两种方式
• 自定义仓库管理

Prompts 管理面板更是实用：

• 用 Markdown 编辑器写预设提示词
• 跨应用同步（CLAUDE.md / AGENTS.md / GEMINI.md）
• 回填保护，不会覆盖你已有的内容

这三个能力堆在一起，CC-Switch 就不再是「切 API Key 的小工具」了，而是一个完整的 AI 编程工作台。

来看 MCP 服务器的添加与同步流程：

【配图建议：MCP 统一管理面板截图，展示多个 MCP 服务器的列表和每个应用的同步开关】

3. 路由服务 + 应用路由 + 故障转移

这是 CC-Switch 最有「工程感」的功能组合，也是很多人用了才知道有多香的东西。

CC-Switch 把这套能力分成了两层，逻辑非常清晰：

第一层：路由服务（Routing Service）

在电脑上启动一个本地服务（127.0.0.1:15721），所有 AI 编程工具的请求先发到这里，再由它转发到目标模型供应商。

第二层：应用路由（App Routing）

在路由服务基础上，为每个应用（Claude Code / Codex / Gemini CLI）单独开启路由开关。开启后，该应用的请求才会走路由转发，实现热切换、用量监控和故障转移。

两层加在一起，你的请求流转就变成了这样：

开启应用路由后，你能得到什么：

特别说明：应用路由 ≠ 路由服务。 路由服务是基础（必须先启动），应用路由是开关（决定哪些工具的请求走路由）。你完全可以只开路由服务但不开启任何应用路由——只是那样就没法热切换了。

另外还有一个核心场景：Codex Chat Completions 路由。通过这个功能，你可以把 Codex 的 API 请求路由到 DeepSeek、Kimi、GLM 等第三方模型。CC-Switch 会自动做模型映射和格式转换，让 Codex 原生使用国产大模型。v3.16.0 之后这个功能已经成为一等公民，v3.16.1 进一步修复了 OAuth 保留、模型目录丢失等问题。

【配图建议：一张路由架构示意图——左侧三个工具（Claude Code / Codex / Gemini CLI），中间路由开关，右侧路由服务引擎 + 目标模型供应商】

4. 用量仪表盘 + 成本追踪

对于重度用户来说，这个功能简直是刚需中的刚需。

再也不用等到月底看账单才发现花超了。

【配图建议：用量仪表盘截图，展示跨供应商的 Token 用量趋势图和月度费用统计】

5. 云同步 + 多设备无缝衔接

开发者基本都不止一台电脑——办公室主力机、家里笔记本、出差用的轻薄本。

在一台电脑上配好，其他设备自动同步。 换了电脑也不用从头折腾配置。

6. Deep Link 一键导入

这是一个非常「开发者友好」的设计。

CC-Switch 注册了 ccswitch:// 协议，别人分享的供应商配置、MCP 服务器、甚至是 Skills，点一下链接就能自动导入。

想象一下这种场景：

你在群里看到有人说「这个 MCP 服务器写代码巨好用」，然后发了一个 ccswitch://mcp/xxx 的链接。你点了一下，CC-Switch 自动打开，配置已经在那里了。你只需要点一下「启用」。

全程不到 10 秒。

5 分钟上手教程·完整路线图

说了这么多，到底怎么用？下面这张图是你从零开始的完整路线图，跟着走就行。

下面是每个步骤的具体操作：

第一步：安装

macOS（推荐 Homebrew）：

brew install --cask cc-switch

或者直接从 GitHub Releases 下载 .dmg 文件。

好消息：CC-Switch macOS 版已通过 Apple 代码签名和公证，不再有「无法验证开发者」的弹窗了。

Windows： 下载 .msi 安装包，双击安装即可。如果想免安装，下载 Portable 版解压即用。

Linux： 根据发行版选择 .deb / .rpm / .AppImage。

第二步：添加第一个供应商

打开 CC-Switch 后，按这个流程操作：

第三步：启用

在供应商列表中点击你刚添加的供应商，然后点击「启用」。

打开终端，输入 claude——它已经在用你选的模型了。

第四步：开启路由服务 + 应用路由（最关键的一步）

这是解决 90% 连接问题的关键操作。 开启应用路由后，切换供应商时实时生效，无需重启终端。CC-Switch 会自动备份原始配置，关闭路由时自动恢复。

第五步：安装 MCP 和 Skills（按需）

进入 MCP 面板，从模板或自定义配置添加你需要的 MCP 服务器。进入 Skills 面板，浏览 GitHub 上的热门 Skills，一键安装。

常见问题排查流程图

实际操作中你可能会遇到几个高频问题，这张图帮你快速定位：

更多高频问题

官方登录和第三方供应商冲突？

CC-Switch v3.16.1 新增了「Codex 官方认证保留」设置，开启后，第三方供应商的 Key 写入 config.toml，而官方 OAuth 登录继续保留在 auth.json，两者互不干扰。

配置会不会丢？

CC-Switch 采用原子写入机制（先写临时文件，再重命名），即使写入过程中断电或崩溃，也不会损坏现有配置。

而且自动保留最近 10 个备份，手滑了也能轻松恢复。

它和同类工具有什么不同？

市面上也有一些 AI 配置管理工具，但 CC-Switch 有几个明显的差异点：

简单说：它不是「切 API Key 的小工具」，而是一个 AI 编程工作台。

写在最后

2026 年的今天，AI 编程工具已经不是一个「要不要用」的问题，而是「怎么用得更好」的问题。

Claude Code、Codex、Gemini CLI……这些工具各自都很强，但它们之间的配置管理，一直是个被忽视的盲区。

CC-Switch 填补的正是这个盲区。

它不是那种「可有可无的锦上添花」，而是实实在在解决痛点的工具。如果你每天用 AI 写代码，只用一个模型还好，但一旦开始尝试不同模型、不同供应商——CC-Switch 就会从「好像可以试试」变成「没了它真不行」。

项目地址：github.com/farion1231/cc-switch

官网：ccswitch.io

最新版下载：GitHub Releases

如果你已经在用 CC-Switch，评论区分享一下你最常用的供应商组合？

还没用的，装一个试试，回来告诉我真香。👇