一、先安装 Codex CLI
macOS / Linux
官方一键安装脚本：
[crayon-6a82316e40a46731374793/]
Windows
在 PowerShell 中执行：
[crayon-6a82316e40a54584845283/]
使用 npm 安装
如果你的电脑已经安装 Node.js，也可以使用：
[crayon-6a82316e40a57903932882/]
使用 Homebrew 安装（macOS）
[crayon-6a82316e40a5a895573032/]
安装完成后，新开一个终端窗口，检查是否安装成功：
[crayon-6a82316e40a5d467634117/]
如果能正常输出版本号，说明 Codex 已经安装完成。
二、准备 DeepSeek API Key
- 打开 DeepSeek 开放平台：https://platform.deepseek.com/
- 登录后进入「API Keys」页面。
- 创建一个新的 API Key，并保存好。
- 后面配置里的
sk-*******要替换成你自己的真实 Key。
三、创建 .codex 配置目录
Codex 默认读取用户目录下的 ~/.codex/config.toml。
macOS / Linux
[crayon-6a82316e40a60919935446/]
Windows
在资源管理器或终端中创建：
[crayon-6a82316e40a63368901376/]
然后在 .codex 目录下新建 config.toml 文件，写入下面的内容。
四、写入 DeepSeek 配置
[crayon-6a82316e40a65234204028/]
保存后，重新启动 Codex 即可。
五、关键字段说明
model
这里使用 DeepSeek 的模型 ID。deepseek-v4-pro 就是 V4 Pro 模型的调用名称；如果你想用轻量模型，也可以改成 deepseek-v4-flash。
model_provider
指定使用哪个 Provider，必须和下面 [model_providers.deepseek] 中的 deepseek 对应。
[model_providers.deepseek]
定义一个名为 deepseek 的自定义供应商。
base_url
DeepSeek 的 API 地址，这里使用：
[crayon-6a82316e40a68119922557/]
注意不要照搬某些教程里的 /v1，除非你使用的网关或中转服务明确要求加上。
experimental_bearer_token
填你的 DeepSeek API Key，也就是替换掉示例中的 sk-*******。
如果你不想把 Key 明文写在配置文件里，也可以改用环境变量：
[crayon-6a82316e40a6a063627755/]
然后在终端中设置：
[crayon-6a82316e40a6d229438456/]
wire_api
responses 表示使用 OpenAI Responses API。DeepSeek V4 Pro 现在支持这个接口，Codex 用起来会更顺。
requires_openai_auth
false 表示不需要 OpenAI 登录。这就是为什么可以跳过 OpenAI 账号，直接连接 DeepSeek。
六、验证是否配置成功
在终端中运行：
[crayon-6a82316e40a6e570379078/]
进入 Codex 后，确认它使用的是 deepseek 这个 Provider 和 deepseek-v4-pro 模型。如果能看到模型信息，或者可以正常对话，就说明直连成功了。
你也可以先做一次简单测试：
[crayon-6a82316e40a70087948528/]
七、常见问题
1. 提示 command not found: codex
通常是安装后没有新开终端，或者终端环境变量没有刷新。可以先关闭终端重新打开，再执行 codex --version。
2. 提示 401 或鉴权失败
检查 experimental_bearer_token 是否写成了真实 Key，以及 DeepSeek 账户是否还有余额。
3. 提示找不到 deepseek-v4-pro
确认模型名没有拼错，同时把 Codex 升级到较新版本。旧版本可能对 Responses API 或自定义 Provider 支持不完整。
4. 配置没有生效
确认文件路径是用户目录下的 ~/.codex/config.toml，而不是项目目录里的 .codex/config.toml。供应商和认证配置建议放在用户级配置中。
5. Windows 找不到配置目录
使用当前用户的目录：
[crayon-6a82316e40a72997093544/]
八、总结
这套方案的核心就是 Codex 原生支持自定义 model_providers。只要 DeepSeek 提供 OpenAI 兼容接口，我们就可以用 config.toml 直接指定 DeepSeek 作为模型供应商。
整个过程不需要 cc-switch，不需要 OpenAI 账号，也不需要本地代理转换。把 model 设置为 deepseek-v4-pro，并让 wire_api = "responses"，Codex 就可以在国内直连 DeepSeek 了。
提示：本文示例中的 API Key 请替换为你自己的真实 Key，并妥善保管，不要提交到公开仓库。