先说个我自己的烦心事:日常要用 Claude Code 写代码,偶尔切 Codex 干别的活,为了省钱还想把一部分请求打到 DeepSeek。结果就是——三套配置文件、三种格式、三个地方存 key,每次换供应商都得手动改 JSON、TOML、YAML,改错一个字段就得排查半天。
后来用了 CC Switch,这事基本消停了。它是一个开源的桌面小工具,专门管这类 AI 编程工具的配置,15 万 star,MIT 协议。这篇就手把手说一下,我是怎么用它把 Claude Code、Codex 和 DeepSeek 串起来用的。

先装上
官网是 ccswitch.io(认准这个,作者特意强调是唯一官网)。三个平台都有原生桌面版,Tauri 2 写的,装上就能用。
# macOS(推荐 Homebrew)
brew install --cask cc-switch
# Arch Linux
paru -S cc-switch-bin
# Windows / 其他 Linux:去 Releases 下 msi、Portable zip、deb、rpm 或 AppImage
第一次启动它会做一件很贴心的事:把现有的 Claude Code、Codex、Gemini CLI、Grok Build 配置自动导入成一个叫 default 的供应商,同时给每个工具加一个官方供应商。所以你不会一打开就发现自己原来的配置没了。
第一步:把 DeepSeek 加进来
左边栏选你想管的工具,右上角点「+」,从预设里挑供应商,或者自己填一套自定义配置。预设有一百多个,包括各种中转站、AWS Bedrock、NVIDIA NIM 这些。
DeepSeek 就是在这步加的:选预设(或者自定义),填 API 端点、Key、模型名。
这里有个设计我很喜欢:切换只替换连接信息——端点、Key、模型,就这三样。你自己加的插件、hooks、MCP 配置、注释,统统原地不动。而且它在写入前会给你看切换后的配置文件长什么样,第一次改某个文件之前还会自动备份。
第二步:让 Claude Code 用上 DeepSeek
这里是很多人卡住的地方,得解释一下。
Claude Code 说的是 Anthropic Messages 格式,DeepSeek 给的是 OpenAI Chat Completions 格式。两边协议不一样,直接把 Key 填进去是跑不通的。
所以要用 本地路由(Routing):CC Switch 在你机器上起一个转发服务,把请求格式转过来再发出去。操作就三步:
- 在 Claude Code 页面顶部点「Routing」标签(注意:点标签只是切换视图,不会改配置)
- 点页面上的「Start routing」开始路由
- 选 DeepSeek 那个供应商,点「Enable」
然后回终端里用 Claude Code 就行了,不用重启。后面再切别的供应商,也就是点一下的事,对之后的请求立即生效。
路由还能配故障转移队列:某个供应商挂了,自动切到队列里的下一个,背后还有熔断和健康监测。这个功能在半夜跑长任务的时候特别救命。
顺带一提,路由还带一个「整流器」,会自动修一些上游处理不了的请求,比如 Thinking 签名问题、上游不支持图片时的降级。
第三步:反过来,在 Codex 里用 Claude
同样道理,Codex 说的是 OpenAI Responses 格式,想在 Codex 里用 Claude(或者 Gemini),也走路由。Codex 页面顶部同样有 Direct / Routing 两个标签,切换方式一样。
区别在于生效时机:Claude Code 不用重启,Codex、Gemini CLI、Grok Build 需要重启终端或 CLI。如果切供应商的同时换了模型,基本都得重启一下。
第四步:聚合模式(我最常用的)
路由是「一次用一个」,聚合是「同时用一堆」。

在 Claude Code 或 Codex 页面切到「Aggregation」,加几个供应商进去。它们的模型会一起出现在客户端自己的模型选择器里——你在 Claude Code 里选哪个模型,请求就发到哪个供应商,不用回 CC Switch 点来点去。
几个注意点,都是实际踩出来的:
- 要指定一个默认供应商,没点名模型的请求都走它
- Codex 的 OpenAI Official 只能当默认供应商;Claude 官方订阅目前不支持聚合
- Claude Code 需要 2.1.243 或更高版本
- Codex 改了聚合列表要重启,Claude Code 不用
- 同一个会话里换模型,新模型得重建 prompt 缓存,第一轮会贵一点
- 聚合不提供故障转移,要容灾还是用路由
第五步:MCP、Skills、提示词收口
这部分是顺手福利,但用起来很省事。
- MCP:左边栏点 MCP,用模板或自定义配置加服务器,也可以从各工具导入现有配置,然后逐个工具打开同步开关
- Skills:点 Skills → Discover Skills,搜 skills.sh 或浏览 GitHub 仓库,一键装到指定工具;可以选软链接还是复制,也能统一放
~/.agents/skills - Prompts:Markdown 编辑器写提示词,启用后写到对应工具的文件里——Claude Code 写 CLAUDE.md,Codex 写 AGENTS.md,Gemini CLI 写 GEMINI.md。写入前会先把原文件内容存回库里,不会覆盖丢东西
第六步:看一眼花了多少钱
这个功能不用开路由也能用:它默认扫描各工具的本地会话日志,统计请求数、token、缓存命中率、输出速度,按供应商和模型分类,还有趋势图、全年热力图和逐条请求日志。
额度也直接显示在供应商卡片和系统托盘上,比如「5h 94% left」这种。官方订阅额度(Claude、ChatGPT、Gemini、SuperGrok)、各家 Coding Plan 的 5 小时/周/月额度、DeepSeek 这类账户余额都能读——有些要在供应商卡片上点「Configure usage query」开一下,其他家还能自己写查询脚本。
第七步:会话也能读

左边栏点 Sessions,它把各工具的会话日志解析成结构化内容:文本、思考、工具调用、工具结果、图片分开显示;每一轮工作折叠成一行摘要,告诉你走了几步、改了几个文件、失败几次,失败的那一步标红。右边有对话大纲,支持会话内搜索、导出 Markdown、复制单轮或整段对话,还能复制恢复命令接着聊。
排查「它到底在哪一步跑偏了」的时候,这个视图比翻原始日志舒服太多。
几个必须知道的坑
- 开路由后退出 CC Switch,它会先把直连配置写回去,下次启动再重连。所以别在跑任务的时候把它完全退掉
- 官方供应商走不了路由(Codex 的 OpenAI Official 例外)
- 项目切换器默认是隐藏的,要去「Settings → General」打开「Show project switcher」,才能在页面顶部一键切整套配置(供应商 + MCP + Skills + 提示词)
- Accounts 是 Beta:可以登录多个 GitHub Copilot / ChatGPT / xAI 账号当供应商用,但在官方客户端之外使用订阅可能违反厂商条款,风险自担
- Linux 需要 glibc 2.35+ 和 WebKitGTK 4.1,RHEL / Rocky / Alma 8–9 目前还不支持
我这边的实际配置长这样
说个具体组合,可以直接照抄:
- Claude Code 页面:官方 Claude 作为默认(Direct 模式),日常任务走它
- 再加快捷中转 + DeepSeek 两个供应商,开 Routing,把它们排进故障转移队列
- Codex 页面:OpenAI Official 作默认,加一个 Claude 供应商走路由,需要时切
- MCP 只在一个地方维护:文件系统、GitHub、浏览器这几个常用服务器,同步给 Claude Code 和 Codex 两边
- 托盘常驻,看一眼就知道今天还剩多少额度
这样配完,切换就是托盘里点一下,或者模型选择器里选一下,再也不用碰配置文件。
最后
CC Switch 解决的是一个很具体的问题:多个 AI 编程工具的配置太碎、太散、格式还不统一。它没有试图替你做别的,就是把「换供应商」这件事变成一次点击,顺便把 MCP、Skills、提示词、用量、会话都收拢到一处。
如果你也在几个工具之间来回切,或者想试试用国模替代一部分昂贵请求,这个值得装。免费、MIT、不需要账号。
- 官网:https://ccswitch.io
- GitHub:https://github.com/farion1231/cc-switch
- 下载:https://github.com/farion1231/cc-switch/releases











