Codex 接入 DeepSeek V4 教程:config.toml 官方配置与成本对比(2026)
按 DeepSeek 官方文档把 OpenAI Codex CLI、ChatGPT 桌面端和 Codex IDE 插件接入 DeepSeek V4:一键脚本、手动 config.toml、模型选择、哪些功能会变,以及和 GPT-6.1 Sol 的月度成本对比。
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 URL | https://api.deepseek.com/ |
| Wire API | responses |
| 模型 | 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 Sol | 10M × $2.00 = $20.00 | 90M × $0.10 = $9.00 | 2M × $10.00 = $20.00 | $49.00 |
| GPT-5.3-Codex | 10M × $1.75 = $17.50 | 90M × $0.175 = $15.75 | 2M × $14.00 = $28.00 | $61.25 |
| DeepSeek V4 Pro(高峰) | 10M × $1.32 = $13.20 | 90M × $0.044 = $3.96 | 2M × $3.96 = $7.92 | $25.08 |
| DeepSeek V4 Pro(闲时) | 10M × $0.66 = $6.60 | 90M × $0.022 = $1.98 | 2M × $1.98 = $3.96 | $12.54 |
| DeepSeek V4.1 Flash(高峰) | 10M × $0.30 = $3.00 | 90M × $0.006 = $0.54 | 2M × $1.20 = $2.40 | $5.94 |
| DeepSeek V4.1 Flash(闲时) | 10M × $0.15 = $1.50 | 90M × $0.003 = $0.27 | 2M × $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 |