本文中的环境信息如下:
cc switch版本:3.16.3
cc switch是什么?
cc-switch是一个AI工具配置管理中心。它可以一次性将你的api-key配置到你的codex、claude code等AI Agent工具中,并且在你手上有多个账号的情况下,能够快速切换到另一个账号上。不需要去手动编辑codex 或 claud code 或其它agent工具的配置文件 从而达到切换账号的目的。当然了,cc switch不仅仅只能是用来切换账号这种功能,还有很多功能。
更多内容可以在cc-switch官网进一步了解。
需要注意的一点是,正常登录使用AI工具,都是需要有对应厂商的账号,例如codex需要有openai的账号,这些账号并不是所有人都能轻易获取或者负担的起的。
而在cc-Switch中,路由(Routing)** 的主要的作用,就是让像 Codex CLI 这样的 AI 编程工具,能够无缝调用 DeepSeek、Kimi、GLM等任意第三方大模型,也同样能够接入各位大佬们辛苦维护的AI大模型公益站。
cc switch中路由的原理
AI工具无法接入其他这是因为 Codex 这类工具和很多第三方大模型的协议不同:
Codex原生只支持OpenAI的Responses API协议。
DeepSeek、Kimi 等普遍使用Chat Completions API协议。
这两种协议在请求格式、参数等方面完全不同,直接对接会导致请求失败。cc-switch通过以下四步解决这个问题:
接管请求:开启路由后,CC Switch会自动修改 Codex 等工具的配置文件,将其API地址指向本地 http://127.0.0.1:15721。这样,工具的所有请求都会先发给CC Switch。
识别来源:CC Switch接收到请求后,会识别出这是来自哪个应用(如Codex或Claude)的请求。
协议转换:识别出请求来源后,它会判断目标供应商的接口类型(apiFormat = “openai_chat”),然后将Codex标准的Responses API请求,实时改写成第三方模型能理解的Chat Completions API请求。
响应还原:当收到第三方模型返回的Chat格式响应后,CC Switch会再次进行反向转换,将响应还原成Codex能解析的Responses格式。
了解了cc-switch路由的原理,对于什么情况下需要使用路由,应该会有初步的判断(实在不清楚就是 纯试,打开不行就关上,再不行就改url试)。
如何使用路由?
主要分两步:
添加供应商:在 CC Switch 的对应应用标签页(如 Codex)下,点击“添加”,从预设列表中选择你的模型供应商或者自定义,填入API Key等参数,打开“需要本地路由映射”(以防有跟我一样,不带脑子的迷糊蛋,“API请求地址”后的完整url也需要打开)。
开启路由:进入“设置” → “路由”→本地路由 页面,“路由总开关”打开,然后在“应用路由”区域,为你想代理的应用(如 Codex)开启开关即可。
使用路由和不使用的区别
开启路由 :切换供应商不需重启AI工具 ,即时生效。原理是CC Switch 作为本地代理,动态转发请求。适用于想在在AI工具中接入三方API、多账号经常切换,需要在使用过程中一直启动cc-switch。
不开启路由 :切换供应商必须重启AI工具。原理是CC Switch 直接修改工具的配置文件。适用于账号相对固定单一且符合对应AI工具的协议,一次配置一直省事,配置完就再也不需要打开了。
路由功能总结
CC Switch 在本机充当一个 API 网关:接收 Claude Code、Codex 等客户端的请求 → 根据选择的模型和模型提供方,确定要使用的 API 协议 → 将客户端请求转换成模型提供方要求的数据格式 → 转发给模型提供方 → 收到响应后,再将响应转换成客户端能理解的格式 → 返回给客户端。
路由开启后,请求流程如下:
客户端(Codex、Claude Code 等) ↓ CC Switch ↓ 根据「选择的模型 + 模型提供方」 确定路由和协议 ↓ 将请求转换成模型提供方需要的协议/数据格式 ↓ 模型提供方 ↓ 返回响应 ↓ CC Switch 将响应转换成客户端需要的格式 ↓ 客户端
所以 cc switch路由功能最核心的一点就是:不只是负责“转发”,还会根据选择的模型和模型提供方,对请求和响应进行相应的协议/数据格式转换。
声明:禁止任何非法用途使用,凡因违规使用而引起的任何法律纠纷,本站概不负责。


精彩评论