Windows安装Codex及接入DeepSeek-V4教程

Codex和Claude Code安装类似,都需要先安装git和Node.js,其中Node.js安装的版本需要Node.js 18+以上,如要接入DeepSeek最好安装最新版本的,会省事很多。

1.Git安装

直接去git官网下载安装包进行安装即可,注意找与自己电脑相匹配的版本。

安装好后可查看git版本:

2.Node.js安装

node.js官网下载安装包进行安装即可,注意找与自己电脑相匹配的版本。

安装好后可查看Node.js版本:

以及查看Node.js的包管理器npm的版本:

3.Codex安装

安装好git和Node.js后,在操作系统终端使用以下命令进行安装:

复制代码
npm install -g @openai/codex

安装好后查看版本:

4.DeepSeek-V4接入

(1)创建DS的API Key

DeepSeek官网的API开放平台中,创建新的API Key:

(2)安装Codxe代理

安装Codex代理,将开源项目codex-bridge下载到用户文件夹的.codex文件夹下:

(3)配置DeepSeek-V4代理

新增.env文件

并增加DeepSeek-V4配置

复制代码
# === DeepSeek 上游密钥 ===
DEEPSEEK_API_KEY=DeepSeek密钥

# === 暴露的模型列表 ===
DEEPSEEK_MODELS=deepseek-v4-pro,deepseek-v4-flash,deepseek-reasoner

# === 默认供应商 ===
DEFAULT_PROVIDER=deepseek

# === 日志级别 ===
LOG_LEVEL=info

(4)配置Codex

在.codex文件夹下增加config.toml文件

并添加配置Codex的配置

复制代码
cli_auth_credentials_store = "file"
model = "deepseek-v4-pro"
model_provider = "local_proxy"

[model_providers.local_proxy]
name = "local_proxy"
base_url = "http://127.0.0.1:4000/v1"
wire_api = "responses"
requires_openai_auth = true

(5)配置DeepSeek-V4密钥

更改.codex文件夹下auth.json中的配置

复制代码
{
  "auth_mode": "apikey",
  "OPENAI_API_KEY": "DeepSeek密钥"
}

(6)启动代理

在.codex\codex-bridge路径下启动代理

复制代码
node --env-file=.env proxy.mjs

到这里就配置成功了。

若启动代理时报错:node: bad option: --env-file=.env,就是安装的Node.js不是新的版本。

--env-file 是 Node.js 20.6.0 才新增的原生命令行参数,安装的 Node 版本低于 20.6,旧版 Node 不识别这个参数,直接报非法选项。

若不想重新更换Node.js版本,可使用以下方法解决:

a.安装dotenv

在 proxy.mjs 所在目录安装 dotenv

复制代码
npm install dotenv

b.修改 proxy.mjs

修改 proxy.mjs 代码,在proxy.mjs文件开头增加这2行代码

复制代码
import dotenv from 'dotenv';

dotenv.config();

c.启动代理

启动命令去掉 --env-file,直接运行:

复制代码
node proxy.mjs

即可解决。

注意启动代理时,要在.codex\codex-bridge下的路径下启动,启动后终端窗口不能关闭。