CC Switch 自定义供应商：协议格式、模型映射与切换联调

管配置与提供模型是两件事

CC Switch 的官方用户手册按应用管理供应商，既有应用专属配置，也有统一供应商。 它负责配置和可选本地路由，不会为你的上游账户增加模型权限。本文从主仓库读回操作与协议说明；核验状态只指资料来源，本站未运行 CC Switch 或测通任何接口。

先选应用，再添加供应商

在主界面选择目标应用，点右上角加号，进入添加面板；应用专属供应商只影响当前应用。选择自定义预设后，按该应用的格式填写名称、地址、认证和模型。 初次验证不要同时同步多个应用，避免覆盖已有连接。

下面是纯占位字段清单，不是真实 API，也不代表本站已有控制台、Key 创建或充值服务。

API 基础地址：https://80321.cn/v1
API Key：YOUR_API_KEY
实际请求模型：YOUR_MODEL_ID

保存前确认表单面向 Claude Code、Codex 还是 Gemini CLI。同一组字段不能随意跨应用搬用，服务商名称相同也不代表提供相同协议。

Codex 的 Responses 与上游格式分开看

官方自定义 Codex 配置包含 model_provider、model 和供应商 base_url，其中 wire_api 固定为 responses。当前表单再用“上游格式”区分原生 Responses、Chat Completions 和 Anthropic Messages。

如果上游不是原生 Responses，必须开启本地路由，并为对应应用启用路由，由转换层处理请求和响应；单改 URL 不能完成格式转换。 Claude 与 Gemini 的认证和地址字段则有各自格式，不能把 Chat Completions 的 Key 名直接照搬。

Codex 模型映射中的“实际请求模型”应填真实 ID，“菜单显示名”仅用于选择界面。映射生成模型目录，官方要求重启 Codex 才能刷新列表。 窗口或思考选项不应超过上游公布的能力。

切换后到真实目标应用联调

保存供应商后点击卡片“启用”；官方流程会更新配置文件，再按目标应用的方式生效。 记录不含密钥的当前配置作为回退点，退出并重新打开目标客户端，在新会话里检查模型与短文本回复。

启用标记只是配置状态，不是调用成功。使用转换路径时还要确认本地路由持续运行，再单独验证流式结束和工具调用。延迟检测或模型列表刷新也不能替代实际会话的协议检查。

冲突与备份怎么处理

切换不生效时先排查旧进程、环境变量覆盖与未更新的模型目录；路径错误看最终请求是否重复版本号，转换失败则查所选上游格式。不要把多个服务商的模型映射混成一张可用列表。

配置数据库、导出备份和目标应用的配置都应按敏感文件处理，分享前清除 Key。未知深度链接或备份文件先审查再导入，不靠第三方配置来获取不属于自己的账号权限。本页只讨论你合法持有的 API 凭据，不提供绕过订阅或认证的方案。