本文面向已经安装 Codex CLI / Codex App并希望在 Codex v0.81.0 及后续版本中使用 DeepSeek 模型的用户。教程以 CC Switch 作为配置工具分别演示接入DeepSeek 官方 API与claw-cn API两种方式。0. 本文最终效果配置完成后你可以在 Codex 中正常使用 DeepSeek 模型例如╭────────────────────────────────────────────────────────╮ │_ OpenAI Codex(v0.142.2)│ │ │ │ model: deepseek-v4-flash /model to change │ │ directory: ~/codex-project/demo │ ╰────────────────────────────────────────────────────────╯ Tip: New Build faster with the Codex App. Runcodex appor xxxx ⚠ MCP clientfornode_replfailed to start: MCP startup failed: No suchfileor directory(os error2)⚠ MCP startup incomplete(failed: node_repl)› 你好 • 你好有什么我可以帮你的吗最终效果包括Codex 可以正常调用 DeepSeek 模型Codex/model中可以看到配置好的模型可以正常完成代码生成、代码解释、项目修改、Agent 任务可以在 DeepSeek 官方 API 和 claw-cn 两种方案之间切换通过 CC Switch 管理 API Key、Base URL、模型映射和本地路由。注意本文统一使用deepseek-v4-flash作为示例模型 ID。如果你使用的平台实际模型 ID 不同请以平台控制台、模型列表或官方文档为准将文中的deepseek-v4-flash替换成真实模型 ID。整体调用链路如下Codex ↓ CC Switch 本地代理 / 路由转换 ↓ DeepSeek 官方 API 或 claw-cn API1. 为什么 Codex v0.81.0 接入 DeepSeek 需要特殊配置很多人一开始会以为只要有 API Key 和 Base URLCodex 就应该能直接调用第三方模型。但新版 Codex 并不是这么简单。1.1 Codex v0.81.0 的接口特点Codex v0.81.0 及后续版本只能使用OpenAI Responses API。在 Codex 配置文件中经常会看到类似配置wire_api responses这意味着 Codex 侧默认希望上游接口能够理解 Responses API 的请求格式。但问题是DeepSeek官方和很多第三方模型服务并不支持 Responses API而是更常见的OpenAI Chat Completions API也就是常见的/v1/chat/completions1.2 DeepSeek 类接口和 Codex 的协议差异简单理解角色常见协议Codex v0.81.0OpenAI Responses APIDeepSeek / 很多第三方平台OpenAI Chat Completions API两者虽然都属于 OpenAI 风格 API但请求格式、返回格式、流式输出、工具调用、reasoning 参数等细节并不完全一样。所以如果你直接把 DeepSeek 的接口地址填进 Codex可能会遇到404模型不可用model not found请求格式错误流式输出异常Codex 识别不到模型。这时候就需要 CC Switch 在中间做一层转换。1.3 CC Switch 在中间做什么CC Switch 的作用不只是“切换 API Key”。在 Codex 接第三方模型时它主要做几件事管理 Codex 的 API Key管理 Base URL管理模型 ID管理模型映射开启本地代理接管 Codex 请求把 Codex 的 Responses 请求转换成上游的 Chat Completions 请求把上游返回结果再转换回 Codex 能识别的格式。协议转换关系可以理解为Codex 发出 Responses 请求 ↓ CC Switch 本地代理接收请求 ↓ CC Switch 转换成 Chat Completions 请求 ↓ 发送给 DeepSeek / claw-cn ↓ 上游返回结果 ↓ CC Switch 转回 Responses 格式 ↓ Codex 正常展示结果2. 准备工作正式配置前需要准备三个东西Codex v0.81.0 或更高版本CC Switch对应平台的 API Key。2.1 检查 Codex 版本先在终端执行codex--version确认你的 Codex 版本是codex-cli0.142.2或更高版本。如果版本过低建议先升级 Codex再继续配置。2.2 安装或更新 CC SwitchCC Switch 是一个用于管理 Claude Code、Codex、Gemini CLI 等 AI 编程工具 API 配置的工具。它可以帮你避免手动改配置文件也能统一管理多个 Provider。安装完成后打开 CC Switch确认界面中能看到Codex入口。2.3 准备 API Key本文会演示两种接入方式因此你需要准备对应的 Key。第一种DeepSeek 官方 API Key第二种claw-cn API Key注意API Key 不要泄露截图时一定要打码不要把真实 Key 写到文章、笔记、Git 仓库中DeepSeek 官方 Key 和 claw-cn Key 不要混用。3. 核心配置概念Base URL、模型 ID、本地路由映射在正式配置前先把几个关键概念讲清楚。3.1 Base URL 是什么Base URL 就是 API 请求的基础地址。本文涉及两个 Base URL。DeepSeek 官方 API以 DeepSeek 官方文档 / 控制台为准如果官方文档给的是https://api.deepseek.com就按官方地址填写。claw-cn API 固定为https://api.claw-cn.org/v1注意claw-cn 这里要带/v1。3.2 模型 ID 是什么模型 ID 就是你实际调用的模型名称。本文统一使用deepseek-v4-flash后面无论是 DeepSeek 官方方案还是 claw-cn 方案都以这个模型 ID 作为示例。如果你的平台模型名称不同比如平台实际显示的是其他模型 ID需要替换成平台实际支持的模型名。3.3 为什么要配置模型映射Codex 需要知道当前 Provider 下有哪些模型可以选。CC Switch 的模型映射表作用就是告诉 Codex这个 Provider 下有 deepseek-v4-flash 这个模型。配置完成后你在 Codex 中输入/model就可以看到这个模型。如果不配置模型映射常见问题是/model中看不到模型Codex 仍然使用默认模型报model not found请求发出后上游不识别。所以使用自定义模型 ID 时模型映射非常关键。3.4 为什么要开启“需要本地路由映射”原因有三个第一deepseek-v4-flash不是 OpenAI 官方 GPT 模型名。第二DeepSeek官方是 Chat Completions 协议不支持Responses协议其他三方上游大概率也是。第三开启本地路由后CC Switch 可以自动帮 Codex 做协议转换。也就是说Codex Responses 请求会被 CC Switch 转成上游 Chat Completions 请求这样才适合新版 Codex。4. 方案一接入 DeepSeek 官方 API第一种方式是直接接入 DeepSeek 官方 API。这种方式的优点是链路更清晰账号、账单、额度都在 DeepSeek 官方控制台管理。4.1 方案说明DeepSeek 官方 API 适合下面这些用户只想使用 DeepSeek 模型希望使用官方通道希望账单和调用记录更清晰不想依赖第三方中转平台已经有 DeepSeek 官方 API Key。本文示例模型deepseek-v4-flash如果 DeepSeek 官方控制台中的模型 ID 和本文不同请以官方实际模型 ID 为准。4.2 配置参数总览DeepSeek 官方方案的核心配置如下Provider 名称DeepSeek Official Base URL以 DeepSeek 官方文档 / 控制台为准 模型 IDdeepseek-v4-flash 需要本地路由映射开启如果官方文档提供的 Base URL 是https://api.deepseek.com那么就填写https://api.deepseek.com4.3 在 CC Switch 中添加 DeepSeek 官方 Provider打开 CC Switch进入CC Switch → Codex → Add Provider / 添加供应商这里有两种方式。第一种如果 CC Switch 里有 DeepSeek 预设可以直接选择 DeepSeek 预设。第二种如果你想完全手动配置也可以选择自定义 Provider。建议新手优先使用预设。如果预设里的模型和你要用的模型 ID 不一致再手动修改模型映射。配置时填写名称DeepSeek Official API Key你的 DeepSeek 官方 API Key Base URLDeepSeek 官方 Base URL 需要本地路由映射开启4.4 配置模型映射接下来配置模型映射。模型映射表中填写模型 IDdeepseek-v4-flash 显示名称DeepSeek V4 Flash - Official 上下文窗口按实际支持填写其中最关键的是模型 IDdeepseek-v4-flash显示名称可以自定义建议带上来源比如DeepSeek V4 Flash - Official这样后面和 claw-cn 的模型区分更清楚。上下文窗口如果不确定可以先按平台说明填写如果 CC Switch 允许为空也可以先留空后续再补。4.5 开启本地代理和 Codex 接管配置完 Provider 后还需要开启 CC Switch 的本地代理。通常在 CC Switch 顶部或设置中可以看到代理开关。开启后默认本地代理地址一般是http://127.0.0.1:15721你需要确认两件事CC Switch 本地代理已开启 DeepSeek Official Provider已启用开启 Codex 接管后Codex 的请求会先发到 CC Switch 本地代理再由 CC Switch 转发到 DeepSeek 官方 API。这时候 Codex 配置文件里看到的 Base URL 可能不是 DeepSeek 官方地址而是本地代理地址例如http://127.0.0.1:15721/v1这是正常现象不要手动改回去。4.6 重启 Codex 并测试模型映射修改后需要重启 Codex。操作步骤关闭当前 Codex重新打开 Codex在 Codex 中输入/model如果配置正确应该能看到DeepSeek V4 Flash - Official然后可以输入一个简单问题提问hi如果 Codex 能正常返回代码说明 DeepSeek 官方 API 接入成功。5. 方案二接入 claw-cn第二种方式是通过 claw-cn 接入 DeepSeek。这种方式适合已经有 claw-cn API Key或者希望通过统一入口管理多个模型的用户。5.1 方案说明claw-cn 的 Base URL 固定为https://api.claw-cn.org/v1本文仍然统一使用模型 IDdeepseek-v4-flash这种方式适合已经有 claw-cn API Key希望使用统一 API 入口想通过一个平台管理多个模型希望在 Codex 中快速切换模型需要国内访问体验或更方便的中转服务。5.2 配置参数总览claw-cn 方案的核心参数如下Provider 名称Claw CN DeepSeek Base URLhttps://api.claw-cn.org/v1 模型 IDdeepseek-v4-flash API FormatOpenAI Chat Completions 需要本地路由映射开启这里注意https://api.claw-cn.org/v1不要写成https://api.claw-cn.org也不要额外拼成https://api.claw-cn.org/v1/chat/completions在 CC Switch 中填写 Base URL 时填https://api.claw-cn.org/v1即可。5.3 在 CC Switch 中添加 claw-cn 自定义 Provider打开 CC Switch进入CC Switch → Codex → Add Provider → Custom / 自定义填写以下内容名称Claw CN DeepSeek API Key你的 claw-cn API Key Base URLhttps://api.claw-cn.org/v1 需要本地路由映射开启因为 claw-cn 是自定义第三方入口所以建议使用自定义 Provider而不是套用其他平台预设。5.4 配置 claw-cn 模型映射claw-cn 方案同样需要配置模型映射。填写模型 IDdeepseek-v4-flash 显示名称DeepSeek V4 Flash - Claw CN 上下文窗口按 claw-cn 平台说明填写建议显示名称写成DeepSeek V4 Flash - Claw CN这样在 Codex/model中可以清楚区分eepSeek V4 Flash - Official DeepSeek V4 Flash - Claw CN如果你只配置 claw-cn 一种方式也可以简单写成DeepSeek V4 Flash但为了后续对比和排错建议加上来源。5.5 开启本地代理和 Codex 接管和官方 DeepSeek 方案一样claw-cn 方案也需要开启本地代理和 Codex 接管。确认以下状态CC Switch 代理服务开启 Claw CN DeepSeek Provider启用代理地址通常是http://127.0.0.1:15721开启后Codex 的请求链路会变成Codex ↓ CC Switch 本地代理 ↓ https://api.claw-cn.org/v1 ↓ deepseek-v4-flash5.6 重启 Codex 并测试 claw-cn配置完成后同样需要重启 Codex。步骤关闭当前 Codex重新打开 Codex输入/model检查是否能看到DeepSeek V4 Flash - Claw CN然后输入测试任务hi如果 Codex 能正常返回结果说明 claw-cn 方案配置成功。6. 两种方案配置对比下面把 DeepSeek 官方 API 和 claw-cn 两种方式做一个对比。6.1 配置项对比对比项DeepSeek 官方 APIclaw-cn接入地址DeepSeek 官方 Base URLhttps://api.claw-cn.org/v1API Key 来源DeepSeek 官方控制台claw-cn 平台示例模型deepseek-v4-flashdeepseek-v4-flashProvider 类型DeepSeek 预设或自定义自定义 ProviderAPI FormatOpenAI Chat CompletionsOpenAI Chat Completions是否开启本地路由映射开启开启是否开启 Codex 接管需要需要是否需要重启 Codex需要需要适合人群偏官方、偏稳定、账单清晰偏统一入口、多模型管理、国内接口体验7. Codex 配置文件说明使用 CC Switch 后一般不需要手动修改 Codex 配置文件。但了解一下配置文件位置有助于排错。7.1 Codex 配置文件位置Codex 主要涉及两个配置文件~/.codex/auth.json ~/.codex/config.toml其中auth.json主要保存 API Key 相关信息。config.toml主要保存模型、Provider、Base URL、协议类型等配置。7.2 CC Switch 会写入什么通过 CC Switch 配置 Codex 后它可能会写入API Key当前 Provider当前模型Base URLwire_api responsesmodel_catalog_json本地代理地址。其中模型映射通常会转换成 Codex 可识别的模型列表。所以你在 CC Switch 中添加的deepseek-v4-flash会被写入 Codex 的模型配置中这样 Codex/model才能看到它。7.3 配置效果示意开启 CC Switch 本地代理和 Codex 接管后Codex 配置里看到的 Base URL 可能是base_urlhttp://127.0.0.1:15721/v1wire_apiresponses而不是https://api.claw-cn.org/v1或者 DeepSeek 官方地址。这是正常的。因为 Codex 实际上是先请求本地代理http://127.0.0.1:15721/v1再由 CC Switch 转发到真正的上游接口。所以不要看到本地地址就以为配置错了。8. 常见问题与排错下面整理几个常见问题。8.1/model里看不到deepseek-v4-flash优先检查是否配置了模型映射模型 ID 是否填写为deepseek-v4-flashProvider 是否保存成功当前 Provider 是否已启用Codex 接管是否开启修改模型映射后是否重启 Codex。很多情况下问题出在最后一步改完模型映射后没有重启 Codex。Codex 的模型列表通常在启动时加载所以改完后建议重启。8.2 报 404如果出现 404重点检查 Base URL。claw-cn 方案必须填写https://api.claw-cn.org/v1不要写成https://api.claw-cn.org也不要写成https://api.claw-cn.org/v1/chat/completions另外还要检查是否开启“需要本地路由映射”是否开启 CC Switch 本地代理8.3 报model not found如果报model not found重点检查模型 ID。本文示例统一使用deepseek-v4-flash请确认模型映射里是这个名字当前选择的模型也是这个名字上游平台确实支持这个模型当前启用的是正确 ProviderDeepSeek 官方 Key 没有填到 claw-cn Providerclaw-cn Key 没有填到 DeepSeek 官方 Provider。8.4 报 unauthorized / invalid api key如果报认证失败通常是 API Key 问题。检查Key 是否复制完整Key 前后是否有空格Key 是否属于当前平台DeepSeek 官方 Key 不要填到 claw-cnclaw-cn Key 不要填到官方 DeepSeekKey 是否被禁用账号余额或额度是否正常。截图或分享配置时务必把 Key 打码。8.5 代理开启后仍然不生效检查CC Switch 本地代理是否真的运行中Codex 接管是否开启当前启用的是否是正确 ProviderCodex 是否已经重启是否有多个 Codex 配置目录当前终端读取的是否是旧配置是否存在手动修改配置导致冲突。可以尝试关闭 Codex → 确认 CC Switch Provider 启用 → 确认代理开启 → 重新打开 Codex8.6 输出中断或响应慢如果能连上但输出慢或中断可以检查上游服务是否限流网络是否稳定模型是否繁忙当前 API Key 是否额度不足CC Switch 请求日志中是否有错误换官方 DeepSeek 或 claw-cn 互相对比测试。如果官方 DeepSeek 正常、claw-cn 异常可能是 claw-cn 或其上游状态问题。如果 claw-cn 正常、官方 DeepSeek 异常可能是官方 API Key、官方额度或网络问题。9. 总结Codex v0.81.0 及后续版本接入 DeepSeek关键不是只填一个 API Key。真正要处理好的是这几个点Base URL 模型 ID API Format 模型映射 本地路由映射 Codex 接管本文演示了两种方式。第一种是 DeepSeek 官方 APIProviderDeepSeek Official 模型 IDdeepseek-v4-flash API FormatOpenAI Chat Completions 需要本地路由映射开启 Codex 接管开启第二种是 claw-cnProviderClaw CN DeepSeek Base URLhttps://api.claw-cn.org/v1 模型 IDdeepseek-v4-flash API FormatOpenAI Chat Completions 需要本地路由映射开启 Codex 接管开启如果你已经有 claw-cn Key或者想使用统一入口管理多个模型可以选择https://api.claw-cn.org/v1最后再强调一次配置完模型映射后一定要重启 Codex。否则/model中可能看不到新模型。