cc swtich工具的一些使用经验

本文中的环境信息如下:

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路由功能最核心的一点就是:不只是负责“转发”,还会根据选择的模型和模型提供方,对请求和响应进行相应的协议/数据格式转换。



声明:禁止任何非法用途使用,凡因违规使用而引起的任何法律纠纷,本站概不负责。

小周博客
扫码打赏,你说多少就多少

打开支付宝扫一扫,即可进行扫码打赏哦

精彩评论

全部回复 0人评论 7,777人参与

loading