ARTICLE DETAIL

资讯详情

深耕郑州网站建设与运营推广的一线实战洞察。

如何用 CC Switch 在 Codex 中接入 DeepSeek 这类 Chat 格式 API 供应商

如何用 CC Switch 在 Codex 中接入 DeepSeek 这类 Chat 格式 API 供应商 如何用 CC Switch 在 Codex 中接入 DeepSeek 这类 Chat 格式 API 供应商【免费下载链接】cc-switchA cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Grok Build Hermes Agent. Only official website: ccswitch.io项目地址: https://gitcode.com/GitHub_Trending/cc/cc-switch新版 Codex CLI 面向的是 OpenAI Responses API而 DeepSeek3.19.1 之前保存的供应商、Kimi、智谱 GLM、SiliconFlow、ModelScope 等大量供应商实际暴露的是 OpenAI Chat Completions 接口也就是/chat/completions。两种协议的请求体、流式事件和返回结构不同把 Chat 接口直接填进 Codex 配置常见结果是模型列表不对、请求 404/400或流式响应无法被 Codex 解析。CC Switch 的本地路由解决这个问题让 Codex 始终连本机路由、仍以 Responses API 发请求由路由把请求改写成 Chat Completions 发给上游再把响应转回 Responses 形态。本文适用 CC Switch 3.19.1 及以上版本走通后 Codex 终端即可使用这类 Chat 格式供应商的模型。先判断你是否需要走路由转换3.19.1 起 DeepSeek 预设已改为原生 Responses 直连不再是所有 DeepSeek 用户的必经路径。判断方法只有一个看 Codex 供应商卡片上的徽章。带需要路由徽章该供应商走 Chat 格式本文全部步骤适用。没有徽章已是 Responses 原生直连路由步骤对它没有意义直接可用。带不支持路由徽章官方供应商CC Switch 会阻止它走本地路由。徽章由供应商保存时记录的 API 格式决定升级 CC Switch不会改变已有供应商的行为。具体到 DeepSeek3.19.1 之后有三种情况你的情况是否需要路由说明3.19.1 之前保存的 DeepSeek 供应商需要仍带徽章预设改动只影响新建供应商已保存配置原样保留3.19.1 之后用预设新建的 DeepSeek不需要直连api.deepseek.com并使用 DeepSeek 官方模型目录想用deepseek-v4-pro需要DeepSeek 尚未为该模型开通 Codex 集成官方预计 2026 年 8 月初直连会上游报错必须走 Chat 路由除 DeepSeek 外Kimi、智谱 GLM 等仍是 Chat 格式本文对它们完全适用——把下文中的 DeepSeek 换成对应预设即可。本地路由如何转换协议这条链路分四步Codex 接管时本地配置被写成http://127.0.0.1:15721/v1并强制保持wire_api responses。供应商的meta.apiFormat openai_chat告诉路由真实上游是 Chat Completions。路由把/responses或/v1/responses改写到/chat/completions并把 Responses 请求体转换成 Chat 请求体。上游返回后路由把 Chat 的 JSON 或 SSE 转回 Codex 能理解的 Responses JSON/SSE。供应商原生就是 Responses 的如现在的 DeepSeek 预设第 24 步不发生请求直接发往上游。转换同时支持流式和非流式请求思考/推理参数也由 CC Switch 按供应商名称与端点自动适配无需手动配置。准备条件开始之前准备三样东西已安装并能启动的 CC Switch已安装 Codex CLI并至少运行过一次让~/.codex/config.toml目录结构存在目标供应商的 API Key。以 DeepSeek 为例其 OpenAI 兼容 base URL 是https://api.deepseek.comChat API 路径是/chat/completions其他供应商常见带/v1或更长路径的 base URL例如智谱 GLM 是https://open.bigmodel.cn/api/coding/paas/v4。CC Switch 预设已按这些信息配好优先使用预设不需要手动拼接口路径。第一步添加 Codex 供应商打开 CC Switch切到顶部Codex标签点击右上角加号添加供应商。用预设推荐在预设列表选中目标供应商填入 API Key保存即可。预设已内置请求地址、默认模型、模型菜单并会自动设好上游格式Chat 格式的预设保存后卡片上会出现需要路由徽章。思考参数预设已自动配置不需要手动填。用自定义配置按对方文档填 API Key 和 base URL展开表单底部的高级选项把上游格式选为Chat Completions需开启路由。这个下拉共有三个选项Responses原生——上游原生支持 Responses API直连不转换无需路由Chat Completions需开启路由——本文讲的情况Anthropic Messages需开启路由——上游只提供原生 Anthropic 协议同样由路由转换。只有Responses原生不需要路由接管另外两个都需要。自定义供应商的思考参数由 CC Switch 按名称与地址自动推断识别不准时才需要展开思考能力手动覆盖。改造已有的 DeepSeek 供应商可选分支想改走直连把上游格式改成Responses原生即可不必删掉重建。注意 3.19.1 之前存下的上下文窗口1000000会盖掉官方声明的1048576介意可在高级选项 → 模型映射中把该行的上下文窗口改为1048576。反过来想用deepseek-v4-pro就把上游格式改回Chat Completions。直连所用的官方模型目录要求 Codex CLI 0.144.0 或更新CC Switch 不会替你校验。第二步开启本地路由并接管 Codex进入设置里的路由页面展开本地路由完成两个开关打开路由总开关启动本地服务默认地址127.0.0.1:15721在路由启用中打开Codex。如果只想让 Codex 走路由保持 Claude、Gemini 关闭即可。接管后CC Switch 会把 Codex 的 live 配置指向本机路由。Codex 侧的配置变更是# 路由前 base_url https://api.openai.com/v1 # 路由后 base_url http://127.0.0.1:15721/v1认证由占位符管理真实 API Key 仍保存在 CC Switch 的 Provider 配置里由本地路由在转发时注入不需要暴露在 Codex 的 live 配置中。开启路由前 CC Switch 会备份原始配置关闭时恢复。第三步启用供应商并验证回到 Codex 供应商列表点击目标供应商的启用。如果它带需要路由标记而路由没有启动CC Switch 会弹出“需要路由服务才能正常使用”的提示先回到第二步把开关打开。切换后建议重启当前 Codex 终端会话原因有二Codex 进程可能已经读取过旧的config.tomlmodel_catalog_json生成后/model菜单通常需要新进程才能刷新。验证方式进入 Codex用/model查看当前模型是否来自对应预设发一个小问题确认路由面板的请求数增长或在「设置 → 用量」的请求日志里看到这条 Codex 请求如仍怀疑配置未生效检查~/.codex/config.toml是否指向http://127.0.0.1:15721/v1。主界面出现两个状态指示可以辅助判断路由 Logo 从无色变为绿色当前路由活跃的供应商卡片显示绿色边框。常见报错排查Codex 报 404 或找不到/responses通常是没有开启 Codex 接管或手动把上游 Chat base URL 直接写给了 Codex。检查~/.codex/config.toml是否指向http://127.0.0.1:15721/v1。上游报 404用内置预设时先确认当前供应商确实来自预设并且 Codex 路由已启用。只有自定义供应商才需要额外检查 base URL它应该是对方文档给出的服务端点而不是带/chat/completions的完整接口路径。切到deepseek-v4-pro后上游报错DeepSeek 尚未为该模型开通 Codex 集成。把该供应商的上游格式改回Chat Completions需开启路由并开启路由接管即可——这正是 3.19.1 之前 DeepSeek 走的路径路由的 Responses→Chat 转换照常支持 pro。或者改用deepseek-v4-flash它是预设默认值不受影响。/model看不到供应商的模型保存供应商后重启 Codex。CC Switch 会生成cc-switch-model-catalog.json并把路径写入model_catalog_json但正在运行的 Codex 进程不一定会热加载模型目录。另外目前 Codex app 不支持多模型选择默认使用配置的第一个模型。开了路由但请求仍走错供应商确认三处状态一致Codex 标签下当前供应商正确本地路由服务正在运行路由启用里 Codex 开关已打开。端口被占用Address already in use在代理配置中更换端口如 5001或关闭占用端口的程序修改监听地址或端口前必须先停止代理服务保存后再重新启动。直连后用量归属的变化如果供应商后来改走直连例如把 DeepSeek 的上游格式改成原生 Responses它的请求不再经过本地路由按请求计费的代理用量统计就看不到它了。用量本身不会丢——Codex 会话日志导入照常记录——但这条路径不携带供应商身份所有没走本地代理的 Codex 用量会一起归入名为Codex (Session)的条目要区分它们看每条记录自带的模型 ID用量面板的「模型统计」按模型逐行列出费用与 token 分开。如果确实需要按供应商维度对账比如比较多个聚合商上的同一个模型保持上游格式为 Chat 并开着路由接管。官方 OpenAI Codex 账号不建议走本地路由CC Switch 会在接管模式下阻止切到官方供应商因为用代理访问官方 API 可能带来账号风险。路由主要用于第三方、聚合或协议转换场景。更多细节可参考仓库中的 Codex DeepSeek 路由攻略、应用路由说明、代理服务说明 和 添加供应商。【免费下载链接】cc-switchA cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Grok Build Hermes Agent. Only official website: ccswitch.io项目地址: https://gitcode.com/GitHub_Trending/cc/cc-switch创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表