把 DeepSeek 模型接进 Codex：配置方法与能力差异说明

你手上有 Codex 或 Codex CLI，想让它在某些任务上换用 DeepSeek 模型，结果发现配置项填了不生效、能出话但不能改文件、或者干脆报模型不存在。这篇不推销哪个更强，只把接入方式、协议兼容点和能力差异摆出来，再给你一份从配置到验证的排查顺序，最后说清什么情况下这条路其实不建议走。

你手上有 Codex 或 Codex CLI，想在某些任务上换用 DeepSeek 模型，结果发现配置项填了不生效、能出话但不能改文件，或者干脆报模型不存在。这篇不比较谁更强，只把接入方式、协议兼容点和能力差异摆出来，再给一份从配置到验证的排查顺序。

先说清一个前提：Codex 这类客户端的能力分两层，一层是客户端自己提供的仓库读写、命令执行、多轮 Agent 循环，另一层是后端模型提供的理解和生成。换模型只换第二层，第一层不受影响。很多人以为换了 DeepSeek 就等于换了整个助手，实际不是。

先想清楚：为什么要换，什么情况下别换

换模型的动机通常有三种：省钱、避开限流、或者单纯想试试不同模型在代码任务上的风格。这三种动机对应的判断标准不一样。省钱和避限流的前提是 DeepSeek 一侧的协议和工具调用能被客户端认，不认就别硬接，接了也只是个聊天框。

• 单轮问答、写函数、解释报错、生成单元测试：换模型收益最直接，成本可控
• 重度依赖 Agent 循环、长工具链、多文件重构：先小范围试，别一上来就全量切换
• 只是为了省钱或避开限流：先确认协议与工具调用是否被客户端认，不认就不建议接
• 不确定部署口径：到 /models/deploy 核对当时的接入说明
• 不确定服务稳定性：到 /rankings 看可信度和历史表现再决定

三条配置路径：官方直连、中转兼容层、本地网关

接入 DeepSeek 到 Codex 本质上就是让客户端把请求发到一个它认识的接口上。客户端认的协议风格决定了你能走哪条路。三条路各有代价，选之前先确认你的 Codex 版本支持哪些协议格式。

三条路的环境变量和配置文件位置不同，改完必须重启客户端。重启前先用 /tools/speed-test 量一次延迟基线，出问题才好对照是哪一层变慢了。中转站的接入写法建议到 /sites 看对应站点的配置说明，别照搬别家的格式。

能力差异：能对话和能干活是两件事

很多人接完发现「它能回话但不能改文件」，这不是模型弱，而是工具调用链路没打通。纯文本补全和代码解释，两边差距最小，基本可以互换；需要读改多个文件、调用工具、按步执行的任务，取决于后端是否支持函数调用和流式返回，不支持就只能退化成问答。

函数调用

模型主动发起工具请求的能力，没打通就只剩纯文本回答

流式返回

逐步输出内容，客户端靠它做实时渲染和超时控制

上下文长度

一次能带进去多少内容，超出会被截断，表现为「它忘了文件」

推理型模型

复杂任务更稳但更慢更贵，简单补全用它属于浪费

上下文相关的口径到 /ai-dict/category/basics 对一遍，模型底层概念到 /ai-dict/category/tech 看。判断标准很简单：你的任务是否依赖模型记住前面说过的文件内容，如果依赖，就把上下文长度当作硬约束来选。

接进去之后：五步验证与常见不生效排查

配置改完不要只看能不能出字，按下面五步走一遍。每一步验证一个能力层，出问题能直接定位到是哪一层没通，而不是笼统地说「不生效」。

1. 第一步：短提示返回发一条固定短提示，确认能返回文本。只验证连通性，不验证能力。
2. 第二步：读真实文件让它读一个仓库里的真实文件并复述内容，验证文件读取链路是否通。
3. 第三步：改一行看 diff让它改一行并给出 diff，验证写文件能力，只出文字不给 diff 说明写链路没通。
4. 第四步：触发工具调用让它执行一条命令，看是否真的执行，而不是把命令编成文字念出来。
5. 第五步：多轮任务看上下文跑一个需要多轮的任务，看前面提到的文件信息是否还在，丢了就是上下文或缓存问题。

不生效的常见原因按顺序查：模型名是否与站点提供的别名一致、协议是否匹配、Key 是否有该模型权限、客户端是否真的重启。报错里的术语去 /ai-dict 对，接口类问题去 /ai-status 看是不是上游在抖，别一上来就怀疑自己配置写错了。