Codex CLI是OpenAI推出的命令行AI编程助手，装在终端里就能让它读代码、改文件、跑命令。不过它默认绑定OpenAI的模型和接口，国内直接用并不方便，账号和网络都有门槛。DeepSeek的模型能力强、API价格低，而且官方接口完全兼容OpenAI的SDK格式，所以把它接到Codex CLI上是很多开发者的选择。整个过程不复杂，核心就是安装工具、拿到API Key、改一份配置文件，下面分步骤详细说明。
一、准备工作：安装Node.js和Codex CLI
Codex CLI依赖Node.js 22以上版本，建议先用node -v确认当前版本。如果版本过低，去Node.js官网下载LTS安装包，或者用nvm切换版本：
# 检查node版本 node -v # 版本不够时用nvm安装并切换 nvm install 22 nvm use 22
接着全局安装Codex CLI。官方包名是@openai/codex，执行下面的命令即可：
npm install -g @openai/codex # 安装完成后验证 codex --version
如果npm安装速度慢，可以先切换成国内镜像源，例如npm config set registry https://registry.npmmirror.com，装完再改回来。安装成功后终端输入codex会进入交互界面，说明工具本身没问题。此时它还连的是OpenAI官方服务，下一步要做的就是把模型指向DeepSeek。
二、申请DeepSeek API Key并理解接口地址
打开DeepSeek开放平台，注册账号后在控制台的“API Keys”页面点击创建密钥。这里要注意两点：第一，密钥只在创建时完整展示一次，务必立刻保存到安全的地方；第二，DeepSeek按token计费，新账号通常会送一些额度，够日常调试用。
拿到密钥后，还需要知道DeepSeek的接口地址。它提供了两个主要模型：deepseek-chat对应V3通用模型，速度快价格低，适合日常编码任务；deepseek-reasoner对应R1推理模型，思考更深入但响应慢一些。API基础地址是https://api.deepseek.com，路径格式和OpenAI完全一致，走/chat/completions端点，这就是Codex CLI能无缝对接的前提。
三、修改配置文件让Codex CLI指向DeepSeek
Codex CLI的配置文件位置是~/.codex/config.toml（Windows下在C:\Users\你的用户名\.codex\config.toml），没有的话手动创建。核心思路是注册一个自定义的模型提供商，然后让默认模型使用它：
# ~/.codex/config.toml # 定义一个模型提供商，指向DeepSeek的接口 [model_providers.deepseek] name = "deepseek" base_url = "https://api.deepseek.com/v1" env_key = "DEEPSEEK_API_KEY" wire_api = "chat" # 把默认模型设置为DeepSeek model = "deepseek-chat" model_provider = "deepseek"
配置里的env_key表示从环境变量里读密钥，所以还要设置一下环境变量：
# Linux / macOS，写入shell配置文件 export DEEPSEEK_API_KEY="sk-你的密钥" # Windows PowerShell setx DEEPSEEK_API_KEY "sk-你的密钥"
有一个容易踩的坑：如果配置了多个提供商，model和model_provider这两行要写在配置文件的顶层，不要误放进某个[model_providers.xxx]段落里，否则不会生效。另外wire_api设为chat是因为DeepSeek走的是标准Chat Completions协议，如果写错成responses会直接报404。
四、验证连接与常见问题排查
配置完成后，在一个项目目录里启动codex，随便发一句指令，比如“帮我看看这个项目的目录结构并说明用途”。如果它正常返回分析和操作建议，说明接入成功。想切换到R1推理模型，只需把配置里的model改成deepseek-reasoner再重启CLI即可。
如果遇到报错，可以按下面几类排查。401错误基本是密钥错了或者环境变量没生效，重新检查DEEPSEEK_API_KEY是否设置正确，设置后要重开终端窗口。404错误通常是base_url写错了，确认结尾带不带/v1要和官方文档一致。请求超时或网络错误可能是代理导致的，DeepSeek是国内服务，不需要也不建议挂代理，把HTTP_PROXY相关变量临时清掉试试。
还有一个体验上的建议：DeepSeek的流式输出和Codex CLI的渲染兼容得不错，但在长任务中偶尔会出现响应被截断的情况，可以在指令里让它分步执行，减少单次输出长度。总体来说，接入DeepSeek之后的Codex CLI在代码补全、重构建议、终端自动化任务上表现都够用，成本比官方方案低很多，值得长期使用。
codex clideepseekOpenAI兼容接口修改时间：2026-09-10 14:50:35