1. 为什么要在 Codex 里接 DeepSeek 纯 APICodex 是一个给 Codex 桌面版做增强的启动器它把原本锁在 ChatGPT 账号体系里的模型选择、插件入口解锁出来让你可以塞进任意兼容 Chat Completions 协议的服务。DeepSeek 的 API 正好是标准 Chat Completions 格式价格便宜、代码能力够用很适合拿来做本地代码补全。但真正动手时很多人卡在两个地方一是 Key 和 Base URL 到底填哪个、末尾要不要带/v1二是 Codex 的供应商配置和 Codex 本体之间怎么衔接。如果你同时还要接别的模型每个供应商配一套 Key、一套地址改起来很烦。这篇就聚焦一个思路用 TaoToken 做统一 Key 和 API 通道在 Codex 里只维护一份配置把 DeepSeek 纯 API 的代码补全一次性打通。适合谁看本地用 Codex 桌面版 Codex 做开发的同学想用 DeepSeek 省钱、又不想每次换模型都重配 Key 的人。下面给的是可复制的config.toml/settings.json骨架以及连通性验证动作照着填就能跑。2. TaoToken 前置统一 Key 与 API 地址TaoToken 在这里扮演的角色是「一个 Key 走多个模型」的通道。你不需要为 DeepSeek 单独记一套密钥而是用 TaoToken 的 Key 和 API 地址在 Codex 里配一次后面换模型只改模型名。官网入口https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentAPI 基地址注意这个不带 UTM直接用于配置https://taotoken.net/api你需要提前准备的东西一个 TaoToken 账号登录后在控制台创建 API Key本地已安装 Codex 桌面版并保持后台运行已安装 Codex 增强启动器桌面有 Codex 和 Codex Manager 两个图标。创建 Key 的入口在控制台路径是 console 下的 api-keys 页面。拿到 Key 之后先别急着填下面配置里会用到两个值base_url和api_key。注意Codex 必须通过 Codex 图标启动直接开 Codex 本体不会加载增强配置供应商列表里也看不到你新增的项。如果你还想先确认模型通道是否正常可以先用模型对话页面发一条测试消息确认 Key 有效再进 Codex 配置能省掉后面排查的功夫。3. 可复制配置config.toml 与 settings.json 骨架Codex 的供应商配置有两种落地方式一种是在 Manager 的图形界面里填另一种是直接改配置文件。图形界面适合第一次配配置文件适合批量或版本管理。下面两份骨架你按需取用。3.1 config.toml 骨架Codex 侧Codex 本体读取的是 TOML 配置重点是model_provider指向你自定义的供应商base_url用 TaoToken 的 API 地址。# ~/.codex/config.toml model deepseek-v4-pro model_provider taotoken [model_providers.taotoken] name taotoken base_url https://taotoken.net/api env_key TAOTOKEN_API_KEY wire_api chat几个参数说明参数值说明modeldeepseek-v4-pro实际调用的模型名按你账号可用模型填model_providertaotoken自定义供应商标识和下面段名一致base_urlhttps://taotoken.net/apiTaoToken API 地址末尾不要加/v1env_keyTAOTOKEN_API_KEY从环境变量读 Key避免明文写进文件wire_apichat走 Chat Completions 协议DeepSeek 不支持 Responses APIKey 建议放环境变量不要直接写进 TOML# macOS / Linux export TAOTOKEN_API_KEY你的TaoToken Key # Windows PowerShell $env:TAOTOKEN_API_KEY你的TaoToken Key3.2 settings.json 骨架Codex 侧Codex 的供应商管理读的是它自己的 settings.json字段和图形界面一一对应。手动改之前先关掉 Codex改完再启动。{ providers: [ { name: taotoken-deepseek, mode: pure_api, test_model: deepseek-v4-pro, mix_api_key: true, base_url: https://taotoken.net/api, api_key: 你的TaoToken Key, upstream_protocol: chat_completions } ] }字段对照mode选pure_api即纯 API 模式不依赖账号登录mix_api_key勾选后才会把 Key 混入请求头upstream_protocol必须是chat_completions选错会找不到模型base_url末尾同样不要带/v1带了会拼成/v1/v1/...直接 404。提示图形界面里「接入模式」选纯 API、「上游协议」选 Chat Completions和上面 JSON 是同一套东西。第一次配建议先用界面点一遍确认字段名再决定要不要转成文件管理。4. 验证请求与成功结果配置写完重启 Codex一定从 Codex 图标进然后做三步验证。第一步看模型列表。Codex 的模型选择列表里应该出现taotoken-deepseek / deepseek-v4-pro这一项。如果只有默认模型说明供应商没加载回到第 5 节排查。第二步发一条最小请求。在对话里输入一句让它补全的代码比如# 用 Python 写一个读取 JSON 文件并返回字典的函数正常返回时你会看到 DeepSeek 直接给出函数实现顶部菜单栏同时出现 Codex 选项原本 API 模式下灰掉的插件入口也会解锁。第三步命令行侧验证通道。如果你习惯用 curl 先确认 Key 和地址没问题可以这样测curl https://taotoken.net/api/chat/completions \ -H Authorization: Bearer $TAOTOKEN_API_KEY \ -H Content-Type: application/json \ -d { model: deepseek-v4-pro, messages: [{role: user, content: print hello}] }返回里有choices字段和正常内容就说明 Key、地址、模型名三者都对。这一步过了Codex 里再报错基本就是配置字段的问题不是通道问题。实测下来代码补全场景建议把test_model和model保持一致避免测试用一个、实际调用用另一个出问题时定位会绕远。5. 本篇常见错排查找不到模型选项。九成是upstream_protocol没选chat_completions或者base_url末尾多了/v1。DeepSeek 当前不支持 Responses API协议选错模型列表就是空的。改完记得从 Codex 图标重启。502 / 404 网络错误。先确认base_url拼写https://taotoken.net/api后面不要再接路径。404 多半是地址拼错502 多半是 Key 无效或环境变量没生效。用第 4 节的 curl 单独测一次能快速区分是通道问题还是 Codex 配置问题。Codex 卡在 Logo 界面。Codex 启动时会请求一些默认域名如果本地网络对这些域名不通就会卡住。检查你的网络环境是否能正常访问配置里写的地址必要时把相关域名加入本地网络规则。Key 明明填了却提示未授权。检查mix_api_key是否勾选以及环境变量名是否和env_key一致。TOML 里写的是TAOTOKEN_API_KEY环境变量就必须叫这个名大小写敏感。改了配置不生效。Codex 和 Codex 本体都要重启且必须从 Codex 图标启动。只重启其中一个配置不会重新加载。6. 后续怎么用这套配置这套配置的核心价值是「一份 Key 走多模型」。以后你想在 Codex 里换别的模型做补全只需要改model和test_model两个字段base_url和 Key 都不用动。长期做编码或跑 Agent 任务的话可以了解下 Coding Plan 的额度方式比按次调用更适合高频补全场景。接入文档里有更细的字段说明和不同客户端的配置示例遇到本文没覆盖的字段可以去对照。如果你只是想先验证某个模型能不能用直接用模型对话发一条消息最快不用每次都进 Codex 折腾配置。最后留一个我踩过的坑base_url到底带不带/v1不同客户端要求不一样。Codex 这套走的是不带/v1的写法你从别处抄配置时一定要核对抄错这一处能让你排查半小时。