[控场AI]
· 8 分钟阅读· 4,293 字

CC-Switch全功能解析:一站式管理AI编程工具配置

CC-Switch全功能解析:一站式管理AI编程工具配置

CC-Switch把多款AI编程工具的供应商、MCP、Skills与用量统一到一个界面管理。

CC-Switch 是一款开源的多 AI 编程工具配置管理器,支持 Claude Code、Codex、OpenCode、WorkBuddy 等十几款工具,将供应商配置、MCP 服务、Skills、系统提示词和 Token 消耗统计收拢到同一界面。它为 Claude Code 等提供直连、路由、聚合三种接入模式:直连点对点最简单;路由模式在本机开启中转端口,解决协议转换、多供应商故障转移和 Token 精确计量三个问题,是作者推荐用法;聚合模式把多家模型写进模型选择列表,但仅支持 Claude Code 与 Codex。MCP、Skills 和系统提示词一次配置即可按勾选同步到多个工具。用量统计按供应商和模型两个维度展示成本、Token 与缓存命中率,并支持汇率换算和自定义定价。

如果你电脑上同时装着Claude Code、Codex、WorkBuddy等多款AI编程工具,每次接入新供应商都要手动翻找配置文件、逐项修改,这种体验确实够折腾。开源工具CC-Switch正是冲着这个痛点来的——它把不同AI工具的供应商配置、MCP服务、Skills、系统提示词乃至Token消耗统计,收拢到一个界面里统一管理。

据B站UP主的完整演示,这款工具目前支持十几款主流AI编程工具,包括Claude Code、Codex、OpenCode,以及国内常用的WorkBuddy等办公类工具。下面按功能模块逐一拆解。

三种路由模式:直连、路由与聚合

CC-Switch为Claude Code等工具提供了三种接入供应商的方式,理解它们的差异是上手的关键。

直连模式:点对点最简单

直连模式下,你在CC-Switch里选好供应商、填入API Key,请求就直接发往该供应商。演示中以DeepSeek广告为例:添加供应商时工具已预填好请求地址、官网链接和图标,用户只需粘贴API Key,并可根据需要把模型映射到Pro或Flash档位。配置完成后,CC-Switch会自动生成对应的JSON配置写入Claude Code。

这里有个前置操作容易被忽略:需要在设置中打开「跳过Claude Code初次安装确认」开关,否则Claude Code启动时会要求登录Claude账号。开启后即可在不登录官方账号的情况下使用第三方模型。

配置项自动填写示意

路由模式:多一层中转,解决三个问题

路由模式会在本机开启一个中转服务端口,请求先到CC-Switch,再由它转发给供应商。多出这一层,换来的是三个实际收益:

协议兼容。DeepSeek原生支持Anthropic的API格式,但如果供应商只提供OpenAI格式,直接在Claude Code里用就会碰壁。路由模式会在中转层完成协议转换——Claude Code发出Anthropic格式请求,CC-Switch转成OpenAI格式发给供应商,返回后再转回来。UP主在演示中修改了供应商的请求格式并去掉URL后缀,验证了这条链路可以打通。

故障转移。这是路由模式最实用的能力。你可以添加多个供应商作为备用线路,并在右上角开启故障转移开关,按P1、P2设置优先级。演示中主线路DeepSeek的Key被人为改坏后,请求自动降级路由到了OpenCode的Go套餐,对话没有中断。CC-Switch界面会同步显示DeepSeek处于降级状态。

修改Key触发故障转移

顺带一提,OpenCode的Go套餐订阅用户可以在CC-Switch里直接看到5小时、每周、每月的额度剩余情况以及刷新倒计时,不必再登录供应商网站查询。

Token计量更准。因为每次请求都经过中转,消耗的Token数量和对应成本能被实时记录。UP主注意到,安装完CC-Switch时左下角并没有金额显示,发起第一次对话后才开始出现额度统计。

Anthropic API 与 OpenAI API 的协议差异:Claude Code 原生调用的是 Anthropic 的 Messages API(请求体含 system、messages、max_tokens 等字段,返回内容以 content 块数组组织);而多数国产及第三方供应商(如部分聚合平台)只暴露 OpenAI 的 Chat Completions 格式(choices[].message.content)。两者在字段命名、角色表达、流式事件结构上都不兼容,直接用会报错。协议转换层需要做字段映射、把 Anthropic 的 system 参数提到消息序列首位、并转换流式 SSE 事件类型。CC-Switch 的路由模式就是在本地端口上承担这层转换,让 Claude Code 无感知地使用只支持 OpenAI 格式的供应商。

故障转移(Failover)的优先级机制:故障转移指主线路不可用时自动切换到备用线路。CC-Switch 用 P1、P2 标注优先级,请求默认走 P1;当 P1 返回鉴权失败、限流或超时等错误时,中转层捕获异常并重试 P2,对上层工具表现为一次正常响应。判定条件通常包括 HTTP 401/429/5xx 与连接超时,而非所有错误都触发切换。由于切换发生在本地中转层,对话上下文不会丢失,这也是它比手动改配置更实用的原因。

聚合模式:多家模型塞进一个菜单

聚合模式把多家供应商的模型直接写进AI编程工具的模型选择列表。演示中同时接入了DeepSeek、OpenCode和智谱GLM,在Claude Code里用/model就能随时切换,对话中途换模型写代码也没问题。

需要留意的是,据UP主说明,聚合模式目前只支持Claude Code和Codex,其他平台仅提供直连和路由模式。日常使用他更推荐路由模式,功能覆盖面更广。

MCP、Skills与提示词的统一管理

这三项是跨工具复用的通用配置,配一次就能映射到多个AI编程工具。

MCP服务

如果本机已有MCP配置,可以直接「从应用导入」。全新环境则手动添加——以顺序思考类MCP为例,CC-Switch会预填名称、连接方式和启动命令,需要环境变量的服务可在此添加。关键在于勾选同步目标:把这套MCP同步到哪些AI编程工具。勾选后重启对应工具,输入MCP命令即可看到服务处于可用状态;取消勾选再重启,该工具里就不再加载这个服务。界面还提供连通性检查,测试不通过的服务会显示为灰色,无法使用。

选择MCP同步目标

MCP(Model Context Protocol) 是 Anthropic 于 2024 年底提出的开放协议,用于让 AI 应用以统一方式连接外部工具与数据源。一个 MCP Server 通过 stdio(本地子进程)或 SSE/HTTP(远程服务)暴露若干「工具」「资源」「提示模板」,客户端(如 Claude Code)启动时读取配置、拉起对应进程并列出可用能力,模型再按需调用。这解释了文中「重启对应工具后输入 MCP 命令才能看到服务可用」的现象——MCP 服务是在客户端启动时加载的,改配置必须重启才生效。不同 AI 编程工具的 MCP 配置文件位置和字段格式各异,CC-Switch 的价值就在于维护一份源配置,再按勾选同步写入各工具各自的配置文件。

Skills市场

Skills模块内置了一个发现市场,来源标注为skills.sh。搜索关键词即可浏览市面上的Skill,列表会显示安装量和发布作者。UP主提醒,列表排序并非按安装量排列,具体排序逻辑他也没完全看明白,挑选时建议以安装量作参考。安装时同样要勾选目标工具,且勾选动作需要在安装前完成,装完再勾不会自动同步。另外要注意目录名冲突——演示中安装的Excel类Skill与已有Skill同名,会触发目录占用的提示。

系统提示词

提示词功能用于给AI编程工具配置全局系统提示词。演示中创建了「严谨回答」和「活泼简短」两套风格,按需启用其一,重启Claude Code后回答风格随之改变。Codex等其他工具也能各自绑定不同的提示词配置。

对话记录与用量统计

「会话」页面汇总了当前电脑上与各AI工具的对话内容,按项目路径分组。展开单条记录,可以看到完整的对话内容、提问时间、所用模型、Token消耗和成本,思考过程也能展开查看。重要对话可导出为Markdown文档分享。如果想知道这些记录存在哪里,设置里有入口直接告诉你对应文件夹路径。

用量统计页面默认展示当天数据,可切换最近24小时、7天、14天、30天或全部。演示中当天共消耗7美分、发起14次请求、消耗Token 14.1万、缓存命中7.2万。页面下方提供柱状图查看各时段消耗分布,每条请求日志包含发起时间、应用、供应商、模型、成本、Token输入输出和缓存命中率。统计支持按供应商和按模型两个维度查看,后者能直观看出哪个模型用得最多。

币种可以改为人民币,汇率支持自动获取。定价管理里能编辑每个模型的每百万Token单价(填写美元),新模型定价更新不及时也可以手动新增。

按项目展示的对话记录

Token 与缓存命中计费:大模型按 Token 计费,输入与输出单价通常不同,且多数供应商对「命中提示缓存的输入 Token」给予大幅折扣(如 Anthropic 的缓存读取价格约为普通输入的十分之一)。文中「缓存命中 7.2 万」正是指这部分享受折扣的输入量,缓存命中率越高,同等对话的实际成本越低。因此准确的成本统计必须区分普通输入、缓存写入、缓存读取和输出四类 Token,按各自单价累加。这也是为什么只有在路由模式下 Token 计量才准确——直连时请求不经过 CC-Switch,它只能读取供应商返回的 usage 字段或根本无法获取,而中转模式可以在转发前后自行记账。

一键安装与授权中心

「应用」模块支持一键安装AI编程工具,省去逐个跑官网下载的麻烦。演示中Codex安装成功并进入已安装列表,但DeepSeek Harness的安装点击后没有报错却始终停在未安装状态,属于演示中遇到的个案,实际使用中可能需要换用其他安装方式。

授权中心是v4版本的新功能,面向使用官方账号登录而非API Key的用户。添加多个账号后,可以在同一界面查看各账号订阅的套餐、剩余额度并进行状态切换。

小结

CC-Switch的核心价值在于把散落在各处的配置收拢成一份可复用的资产:供应商配置一次、MCP和Skills同步一次,就能覆盖多款AI编程工具。路由模式带来的协议转换和故障转移,是它区别于简单配置切换器的实质差异。聚合模式的工具支持范围有限、Skills市场排序逻辑不透明、个别工具一键安装失败,是目前能看到的小瑕疵,但不影响它作为多工具用户效率工具的定位。

#CC-Switch#AI编程工具#MCP管理#Skills管理#Token成本统计#Claude Code配置#AI供应商管理
分享:

相关推荐