DevTk.AI
CodexDeepSeek V4Codex CLIAI 编程DeepSeek API

Codex 接入 DeepSeek V4 教程:config.toml 官方配置与成本对比(2026)

按 DeepSeek 官方文档把 OpenAI Codex CLI、ChatGPT 桌面端和 Codex IDE 插件接入 DeepSeek V4:一键脚本、手动 config.toml、模型选择、哪些功能会变,以及和 GPT-6.1 Sol 的月度成本对比。

作者 发布于 12 分钟阅读

Codex 可以直接接入 DeepSeek V4,不需要任何代理。DeepSeek API 原生支持 Codex 使用的 Responses API,DeepSeek 也发布了官方的 Codex 接入文档。一个配置文件同时对 Codex CLI、ChatGPT 桌面端和 VS Code 的 Codex 插件生效。

本文按 DeepSeek 的 Codex 接入文档 和 Codex 的高级配置文档整理,核对日期 2026-11-16。价格来自 DeepSeek 官方价格页,与本站 DeepSeek V4.1 Flash 和 DeepSeek V4 Pro 页面一致。

先看结论

配置项值
配置文件~/.codex/config.toml,外加模型目录 ~/.codex/models.json
Base URLhttps://api.deepseek.com/
Wire APIresponses
模型deepseek-flash(DeepSeek V4.1 Flash,支持图片输入)或 deepseek-v4-pro(仅文本)
Codex 版本0.164 及以上(DeepSeek 配置脚本 1.5.0 的要求)
计费从 DeepSeek API 余额扣费,不占 ChatGPT 套餐额度

第一步:安装 Codex 并运行一次

先安装 Codex CLI 或 ChatGPT 桌面端,并至少启动一次,让 ~/.codex 目录生成出来。然后在 DeepSeek 开放平台 创建 API Key(以 sk- 开头)。

第二步(方式一):DeepSeek 官方一键脚本

脚本会先把原有配置备份到 ~/.codex/backup-deepseek/,再写入模型目录、更新 config.toml,并保留 MCP 服务器和项目信任设置。

macOS / Linux:

bash <(curl -fsSL https://cdn.deepseek.com/api-docs/codex-deepseek-setup.sh)

Windows PowerShell:

irm https://cdn.deepseek.com/api-docs/codex-deepseek-setup-en.ps1 | iex

菜单里选 1 使用 deepseek-flash,选 2 使用 deepseek-v4-pro,选 9 恢复 Codex 默认配置。首次运行会让你输入 API Key。

和所有”管道执行”的安装脚本一样,运行前最好先看一下脚本内容。想清楚看到每一行改动,就用下面的手动配置。

第二步(方式二):手动配置

先创建 ~/.codex/models.json,它告诉 Codex 每个模型的上下文长度、思考档位和工具调用格式。这个文件很长(里面包含 Codex 的指令模板),请直接从 DeepSeek 官方页面 复制,不要手敲。

然后在 ~/.codex/config.toml 中加入以下内容(文件不存在就新建):

model = "deepseek-flash"
model_provider = "deepseek"
preferred_auth_method = "apikey"
forced_login_method = "api"
model_reasoning_effort = "high"
show_raw_agent_reasoning = true
suppress_unstable_features_warning = true
model_catalog_json = "~/.codex/models.json"

[features]
standalone_web_search = true

[model_providers.deepseek]
name = "deepseek"
base_url = "https://api.deepseek.com/"
wire_api = "responses"
experimental_bearer_token = "<你的 DeepSeek API Key>"
supports_standalone_web_search = true

[desktop]
enabled-reasoning-efforts = ["low", "medium", "high", "xhigh", "ultra", "max"]

如果是在已有文件上修改,DeepSeek 要求:删掉顶层的 web_search 设置;suppress_unstable_features_warning 放在顶层、第一个 [section] 之前;其余配置加到对应的 section 里,不要重复创建 section。

API Key 以明文写在这个文件里。不要提交到 git,也不要把 ~/.codex/ 同步到共享网盘。

想默认用 V4 Pro,把第一行改成 model = "deepseek-v4-pro"。

第三步:启动 Codex

cd /path/to/my-project
codex

切换模型提供方后,ChatGPT 桌面端需要重启才会读到新配置。

接入 DeepSeek 后有哪些变化

方面变化
登录方式forced_login_method = "api" 会跳过 ChatGPT 登录。用量从 DeepSeek 账户扣费,不消耗 ChatGPT 套餐额度。
云端功能Codex 定价页写明,用 API key 而不是 ChatGPT 登录时,没有 Codex 云端任务、GitHub 代码审查、Slack 等云端功能。按本地 CLI、桌面端和 IDE 使用来规划。
图片只有 deepseek-flash 支持图片输入,deepseek-v4-pro 只支持文本。
思考过程show_raw_agent_reasoning 只在 Codex CLI 生效,按 Ctrl + T 查看。
联网搜索1.5.0 脚本默认开启 DeepSeek Alpha Search,按 Search 请求和 Fetch 请求单独计费,另加 token 费用。在顶层加 web_search = "disabled" 可关闭。
历史会话会话按登录方式分开存储,切换后旧会话看起来不见了,但并没有删除。
恢复原状重新运行脚本选 9,或从 ~/.codex/backup-deepseek/ 恢复备份。

成本:DeepSeek 对比 Codex 自家模型

用 ChatGPT 登录的 Codex 走套餐额度,而 OpenAI 不公布套餐的 token 额度,所以有意义的对比是 API 对 API:同样一个月的 Agent 工作量,走 DeepSeek 和走 OpenAI API 各要多少钱。

假设用量: 每月 1 亿(100M)输入 token、200 万(2M)输出 token。编程 Agent 会反复发送同一份仓库上下文,所以假设 90% 的输入命中缓存(90M 命中、10M 未命中)。不计长上下文加价和 OpenAI 缓存写入费用。

模型未命中输入缓存命中输入输出每月合计
GPT-6.1 Sol10M × $2.00 = $20.0090M × $0.10 = $9.002M × $10.00 = $20.00$49.00
GPT-5.3-Codex10M × $1.75 = $17.5090M × $0.175 = $15.752M × $14.00 = $28.00$61.25
DeepSeek V4 Pro(高峰)10M × $1.32 = $13.2090M × $0.044 = $3.962M × $3.96 = $7.92$25.08
DeepSeek V4 Pro(闲时)10M × $0.66 = $6.6090M × $0.022 = $1.982M × $1.98 = $3.96$12.54
DeepSeek V4.1 Flash(高峰)10M × $0.30 = $3.0090M × $0.006 = $0.542M × $1.20 = $2.40$5.94
DeepSeek V4.1 Flash(闲时)10M × $0.15 = $1.5090M × $0.003 = $0.272M × $0.60 = $1.20$2.97

DeepSeek 高峰时段是工作日 UTC 01:00-04:00 和 06:00-10:00(北京时间 09:00-12:00 和 14:00-18:00)。周末、工作日其他时段和中国法定节假日都按闲时价计费。

用人民币结算的话,DeepSeek 官方人民币价格是:V4.1 Flash 高峰每百万 token 缓存命中 ¥0.04、未命中 ¥2、输出 ¥8(闲时减半);V4 Pro 高峰 ¥0.3 / ¥9 / ¥27(闲时减半)。

在这个用量下,deepseek-flash 高峰价约为 GPT-6.1 Sol 的 12%($5.94 对 $49.00),V4 Pro 高峰价约为一半($25.08)。实际比例取决于你的缓存命中率和 Agent 输出量,以上只是粗略估算,用几天后请到 DeepSeek 控制台看真实用量。也可以用价格计算器按自己的数字算。

价格不是全部。Codex 是围绕 OpenAI 模型调优的,DeepSeek 的模型目录沿用了 Codex 的指令模板。团队整体切换前,先用你平时的任务两边都跑一下。

常见问题

现象处理方法
Codex 仍然要求登录 ChatGPT确认 preferred_auth_method 和 forced_login_method 写在 config.toml 顶层、所有 [section] 之前
找不到模型或上下文长度不对确认 model_catalog_json 指向 ~/.codex/models.json,且是 DeepSeek 当前版本(旧目录里叫 deepseek-v4-flash,现在是 deepseek-flash)
401 错误检查 [model_providers.deepseek] 里的 experimental_bearer_token
图片没被识别换成 deepseek-flash,V4 Pro 只支持文本
出现意外的搜索费用加上 web_search = "disabled" 并重启 Codex

相关阅读

下一步

相关文章