CC Switch 实战:用 Claude Code、Codex 和 DeepSeek 的混合工作流,别再手改配置了

先说个我自己的烦心事:日常要用 Claude Code 写代码,偶尔切 Codex 干别的活,为了省钱还想把一部分请求打到 DeepSeek。结果就是——三套配置文件、三种格式、三个地方存 key,每次换供应商都得手动改 JSON、TOML、YAML,改错一个字段就得排查半天。

后来用了 CC Switch,这事基本消停了。它是一个开源的桌面小工具,专门管这类 AI 编程工具的配置,15 万 star,MIT 协议。这篇就手把手说一下,我是怎么用它把 Claude Code、Codex 和 DeepSeek 串起来用的。

CC Switch 主界面:左侧工具列表,右侧 Direct / Routing / Aggregation 标签和供应商卡片
左边选工具,右边管供应商,切换只替换端点、Key 和模型

先装上

官网是 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 在你机器上起一个转发服务,把请求格式转过来再发出去。操作就三步:

  1. 在 Claude Code 页面顶部点「Routing」标签(注意:点标签只是切换视图,不会改配置)
  2. 点页面上的「Start routing」开始路由
  3. 选 DeepSeek 那个供应商,点「Enable」

然后回终端里用 Claude Code 就行了,不用重启。后面再切别的供应商,也就是点一下的事,对之后的请求立即生效。

路由还能配故障转移队列:某个供应商挂了,自动切到队列里的下一个,背后还有熔断和健康监测。这个功能在半夜跑长任务的时候特别救命。

顺带一提,路由还带一个「整流器」,会自动修一些上游处理不了的请求,比如 Thinking 签名问题、上游不支持图片时的降级。

第三步:反过来,在 Codex 里用 Claude

同样道理,Codex 说的是 OpenAI Responses 格式,想在 Codex 里用 Claude(或者 Gemini),也走路由。Codex 页面顶部同样有 Direct / Routing 两个标签,切换方式一样。

区别在于生效时机:Claude Code 不用重启,Codex、Gemini CLI、Grok Build 需要重启终端或 CLI。如果切供应商的同时换了模型,基本都得重启一下。

第四步:聚合模式(我最常用的)

路由是「一次用一个」,聚合是「同时用一堆」。

CC Switch 聚合模式:一个默认供应商加若干附加供应商
聚合模式:一个模型列表,多个供应商

在 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」开一下,其他家还能自己写查询脚本。

第七步:会话也能读

CC Switch 会话阅读视图:每轮工作折叠成一行摘要,失败步骤标红
会话阅读视图:每轮工作折叠成一行摘要

左边栏点 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 目前还不支持

我这边的实际配置长这样

说个具体组合,可以直接照抄:

  1. Claude Code 页面:官方 Claude 作为默认(Direct 模式),日常任务走它
  2. 再加快捷中转 + DeepSeek 两个供应商,开 Routing,把它们排进故障转移队列
  3. Codex 页面:OpenAI Official 作默认,加一个 Claude 供应商走路由,需要时切
  4. MCP 只在一个地方维护:文件系统、GitHub、浏览器这几个常用服务器,同步给 Claude Code 和 Codex 两边
  5. 托盘常驻,看一眼就知道今天还剩多少额度

这样配完,切换就是托盘里点一下,或者模型选择器里选一下,再也不用碰配置文件。

最后

CC Switch 解决的是一个很具体的问题:多个 AI 编程工具的配置太碎、太散、格式还不统一。它没有试图替你做别的,就是把「换供应商」这件事变成一次点击,顺便把 MCP、Skills、提示词、用量、会话都收拢到一处。

如果你也在几个工具之间来回切,或者想试试用国模替代一部分昂贵请求,这个值得装。免费、MIT、不需要账号。

  • 官网:https://ccswitch.io
  • GitHub:https://github.com/farion1231/cc-switch
  • 下载:https://github.com/farion1231/cc-switch/releases
© 版权声明
THE END
喜欢就支持一下吧
点赞1.1W+ 分享