Windows 安装 Codex 并接入 DeepSeek-V4：config.toml 配置与验证教程

1. Windows 上跑 Codex 接 DeepSeek-V4先搞清楚要装什么Codex 是 OpenAI 出的命令行编码助手能在终端里读代码、改文件、跑命令适合习惯在命令行里干活的人。DeepSeek-V4 是 DeepSeek 的新一代模型推理和代码能力都不错价格也友好。把这两个凑一起就是想在 Windows 上用 Codex 的交互体验跑 DeepSeek-V4 的模型能力。但 Windows 上装 Codex 有个绕不开的前提它依赖 Node.js 和 git。Node.js 提供运行环境git 提供版本控制能力Codex 在读写仓库、生成 diff 时会用到。Node.js 版本建议 18 以上如果要接 DeepSeek-V4最好直接上 20.6 以上原因后面会讲因为启动代理时会用到--env-file这个参数低版本不认。这篇教程面向的是 Windows 用户从零开始装 git、装 Node.js、装 Codex、配 DeepSeek-V4 接入、启动验证、排错。全程命令可复制配置片段可直接用。如果你之前装过 Claude Code 之类的工具流程会很熟悉因为依赖项基本一样。接入方式上我会用 TaoToken 的统一 Key 和 API 通道来走这样不用在多个平台之间来回切一个 Key 管多个模型配置也集中。下面按步骤来。2. 前置依赖git 和 Node.js 的安装与版本检查2.1 安装 git去 git 官网下载 Windows 安装包选和自己电脑匹配的版本64 位选 64-bit。安装过程一路默认即可注意勾选「Add to PATH」这样终端里能直接调用 git。装完打开 PowerShell 或 CMD验证git --version正常会输出类似git version 2.45.1.windows.1。如果提示找不到命令说明 PATH 没配好重新跑一遍安装程序确认勾选了 PATH 选项。2.2 安装 Node.js去 Node.js 官网下载 LTS 版本Windows 选.msi安装包。这里有个关键点版本要 20.6.0 以上。因为后面启动代理时会用node --env-file.env这个参数是 Node.js 20.6.0 才新增的低于这个版本会直接报bad option。装完后验证三个东西node --version npm --versionnode --version输出v20.11.0或更高就对了。npm --version输出10.x左右。如果 node 版本低于 20.6建议直接去官网下最新 LTS 覆盖安装比后面改代码省事。注意如果你电脑上之前装过旧版 Node.js覆盖安装后最好重启一下终端让 PATH 生效。2.3 安装 Codex依赖齐了用 npm 全局安装 Codexnpm install -g openai/codex装完验证codex --version能输出版本号就说明装好了。如果报权限错误用管理员身份打开终端再跑一次。如果报网络超时检查 npm 源可以临时切到国内镜像npm config set registry https://registry.npmmirror.com装完再切回来也行或者保持镜像源问题不大。3. TaoToken 前置拿统一 Key 和 API 通道Codex 默认是连 OpenAI 的要接 DeepSeek-V4得改 base_url 和 Key。这里用 TaoToken 的统一通道好处是一个 Key 能覆盖多个模型配置集中不用每个模型单独申请。先去官网注册并登录https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content登录后在控制台创建 API Key路径是 API Keys 页面https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content创建时给 Key 起个名字比如codex-deepseek方便后面识别。创建完复制 Key格式一般是sk-开头的一串字符。这个 Key 只显示一次记得存好。TaoToken 的 API 基础地址是https://taotoken.net/api注意这个地址不带 UTM 参数配置里直接用这个。后面 config.toml 里的base_url会用到它。如果你还没决定用哪个模型可以先在模型对话页面试试 DeepSeek-V4 的效果https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content确认模型可用后再往下配 Codex。4. 可复制配置config.toml 骨架与 DeepSeek-V4 接入4.1 创建配置目录Codex 的配置放在用户目录下的.codex文件夹。在 PowerShell 里mkdir $env:USERPROFILE\.codex cd $env:USERPROFILE\.codex4.2 写 config.toml在.codex目录下新建config.toml内容如下cli_auth_credentials_store file model deepseek-v4-pro model_provider taotoken [model_providers.taotoken] name taotoken base_url https://taotoken.net/api/v1 wire_api responses requires_openai_auth true几个关键字段说明字段作用值model指定默认模型deepseek-v4-pro也可换deepseek-v4-flashmodel_provider指定供应商名和下面[model_providers.xxx]对应base_urlAPI 地址TaoToken 的/api/v1wire_api协议类型responsesCodex 用这个requires_openai_auth是否需要鉴权true如果你要用 DeepSeek 的 reasoner 模型把model改成deepseek-reasoner即可其他不用动。4.3 写 auth.json同目录下新建auth.json填 TaoToken 的 Key{ auth_mode: apikey, OPENAI_API_KEY: sk-你的TaoToken密钥 }把sk-你的TaoToken密钥替换成你在 TaoToken 控制台创建的那个 Key。注意 JSON 格式引号和逗号别写错不然 Codex 读不出来。4.4 目录结构确认配完后.codex目录应该是这样.codex/ ├── config.toml └── auth.json没有多余文件干净。如果之前装过其他工具留了旧配置建议先备份再覆盖避免冲突。5. 验证请求启动 Codex 并跑通 DeepSeek-V45.1 启动 Codex在任意项目目录下打开终端输入codex第一次启动会读.codex下的配置。如果配置正确会进入 Codex 的交互界面显示当前模型是deepseek-v4-pro。5.2 发一条测试请求在 Codex 界面里输入一句简单的话比如帮我写一个 Python 函数计算斐波那契数列前 n 项如果配置通了Codex 会调用 DeepSeek-V4 返回结果。你会看到它流式输出代码说明请求链路是通的Codex → TaoToken API → DeepSeek-V4 → 返回。5.3 用 curl 单独验证 API 通道如果 Codex 界面没反应可以先绕过 Codex直接用 curl 测 TaoToken 通道是否正常curl https://taotoken.net/api/v1/chat/completions ^ -H Content-Type: application/json ^ -H Authorization: Bearer sk-你的TaoToken密钥 ^ -d {\model\:\deepseek-v4-pro\,\messages\:[{\role\:\user\,\content\:\hi\}]}Windows 的 CMD 用^换行PowerShell 用反引号。如果返回 JSON 里有choices字段说明 Key 和通道都没问题问题出在 Codex 配置上。如果返回 401检查 Key返回 404检查 base_url 是不是多了或少了/v1。5.4 验证成功的样子成功时你会看到类似这样的返回结构{ id: chatcmpl-xxx, object: chat.completion, model: deepseek-v4-pro, choices: [ { index: 0, message: { role: assistant, content: 你好有什么可以帮你 } } ] }看到content里有内容就说明整条链路跑通了。6. 本篇常见错排查bad option、401、模型不识别6.1node: bad option: --env-file.env这个报错说明你的 Node.js 版本低于 20.6.0。--env-file是 20.6 才加的。两个解法解法一升级 Node.js 到最新 LTS覆盖安装后重启终端。解法二不想升级的话用 dotenv 替代。在项目目录装 dotenvnpm install dotenv然后在入口文件开头加两行import dotenv from dotenv; dotenv.config();启动命令去掉--env-file直接node proxy.mjs。6.2 401 UnauthorizedKey 不对或没带上。检查auth.json里的OPENAI_API_KEY是不是完整的sk-开头字符串有没有多余空格。也确认 TaoToken 控制台里这个 Key 没被删除或禁用。6.3 404 Not Foundbase_url 写错了。TaoToken 的地址是https://taotoken.net/api/v1注意结尾的/v1不能少也不能多。如果你写成了https://taotoken.net/apiCodex 拼路径时会 404。6.4 模型不识别报model not found之类检查config.toml里的model字段拼写。DeepSeek-V4 的模型名是deepseek-v4-pro或deepseek-v4-flash别写成deepseek-v4或deepseek-v3。可以去 TaoToken 的文档页确认当前支持的模型列表https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content6.5 Codex 启动后不读配置确认.codex目录在用户主目录下不是当前项目目录。Windows 上是C:\Users\你的用户名\.codex。如果放错位置Codex 会读默认配置连不上 TaoToken。6.6 代理启动后终端不能关如果你用的是本地代理方案codex-bridge 之类启动代理的终端窗口不能关关了代理就断了。建议单独开一个终端跑代理另一个终端跑 Codex。或者用start /b后台跑但调试阶段还是前台方便看日志。7. 长期编码与 Agent 场景Coding Plan 和后续接入如果你只是偶尔用 Codex 跑几个任务上面的配置够了。但如果你打算长期用 Codex 做编码、跑 Agent 任务建议看一下 TaoToken 的 Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentCoding Plan 针对编码场景做了额度优化比按量计费更适合高频使用。配置方式不变还是用同一个 Key 和 base_url只是计费模式不同。另外如果你用 Claude Code 或 Anthropic 系的工具TaoToken 也有对应的接入文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content配置逻辑和这篇类似都是改 base_url 和 Key只是配置文件位置和字段名不同。最后提醒一句.codex目录下的auth.json含密钥别提交到 git 仓库。如果项目里要用加进.gitignore。Windows 上路径是C:\Users\你的用户名\.codex\auth.json一般不在项目目录里但如果你手动复制过记得检查。