Codex 桌面版 + DeepSeek V4

用户488159395551
1 阅读6分钟

本教程目标：在你的 Windows 电脑上，让 Codex 桌面版用上 DeepSeek V4 模型。每一步都拆开揉碎，确保你跟着做就能成功。

费用说明：DeepSeek 按使用量计费，不是按月付费。注册时会赠送体验额度，用完后充值10块钱就能用很久。

📋 整体流程图

第一步：注册DeepSeek，获取API Key（5分钟）
         ↓
第二步：安装Node.js环境（5分钟）
         ↓
第三步：下载并配置“翻译官”（10分钟）
         ↓
第四步：配置Codex桌面版（5分钟）
         ↓
第五步：启动翻译官 → 打开Codex → 开始使用

为什么需要“翻译官”？
Codex 说的是“英语”（Responses API），DeepSeek 说的是“中文”（Chat Completions API）。翻译官（codex-bridge）就像一个同声传译，让它们能正常交流。

📍 第一步：注册 DeepSeek 并获取 API Key

1.1 注册账号

  1. 打开浏览器，访问 platform.deepseek.com
  2. 点击页面右上角的  “注册”
  3. 输入手机号或邮箱
  4. 获取验证码并输入
  5. 设置密码，完成注册

✅ 支持中国大陆手机号，直接用国内手机号即可。

1.2 完成实名认证（如果充值需要）

  1. 登录后，点击右上角头像
  2. 在下拉菜单中选择  “账户设置”  或  “实名认证”
  3. 按照提示完成认证（通常需要姓名和身份证号）

1.3 获取 API Key

  1. 登录 DeepSeek 开放平台：platform.deepseek.com
  2. 点击左侧菜单的  “API Keys”
  3. 点击  “创建 API Key”
  4. 给 Key 起个名字（比如 codex）
  5. 立刻点击复制按钮，把生成的 Key 保存下来

⚠️ 最重要的一步：API Key 只显示一次，必须立刻复制保存！格式是 sk-xxxxxxxxxxxxxxxxxxxxxxxx

1.4 查看余额并充值（如需）

  1. 点击右上角头像，选择  “账户余额”
  2. 查看是否有体验额度
  3. 如果余额不足，点击  “充值”
  4. 选择金额（最低10元），用微信或支付宝扫码支付
  5. 支付完成后，余额立刻到账

📍 第二步：安装 Node.js

“翻译官”需要 Node.js 环境才能运行。

2.1 下载 Node.js

  1. 打开浏览器，访问 nodejs.org
  2. 点击左侧的  “LTS”  版本下载（长期支持版，最稳定）
  3. 下载完成后，双击安装包

2.2 安装 Node.js

  1. 双击安装包，点击  “Next”
  2. 勾选  “I accept the terms...” ，点击  “Next”
  3. 安装路径保持默认，点击  “Next”
  4. 所有选项保持默认，一路点击  “Next”
  5. 最后点击  “Install” ，等待进度条走完
  6. 点击  “Finish”  完成安装

2.3 验证安装是否成功

  1. 按键盘 Win + R，输入 cmd，回车打开命令提示符

  2. 输入以下命令，回车：

    node --version

  3. 如果显示 v22.x.x 或类似版本号，说明安装成功

📍 第三步：下载并配置“翻译官”

3.1 创建存放目录

  1. 按 Win + R，输入 cmd，回车打开命令提示符

  2. 逐条输入以下命令（每输入一行按一次回车）：

    mkdir %USERPROFILE%.codex\codex-bridge

3.2 下载翻译官文件

由于翻译官是开源项目，我们用最简单的方式下载：

  1. 打开浏览器，访问：
    github.com/wujfeng712-…

  2. 找到页面上的绿色  “<> Code”  按钮，点击它

  3. 选择  “Download ZIP”

  4. 下载完成后，找到下载的 ZIP 文件（通常在“下载”文件夹里）

  5. 右键点击 ZIP 文件 → 选择  “全部解压缩”

  6. 浏览选择目标路径，输入：

    C:\Users\你的用户名.codex\codex-bridge

    如何找到你的用户名：打开任意文件夹，在地址栏输入 %USERPROFILE% 回车，地址栏显示的文件夹名字就是你的用户名。

  7. 点击  “提取”

3.3 验证下载是否成功

  1. 打开文件资源管理器
  2. 在地址栏输入 %USERPROFILE%.codex\codex-bridge，回车
  3. 确认里面有 proxy.mjs 这个文件

3.4 创建翻译官配置文件

  1. 打开记事本（Notepad）

  2. 复制粘贴以下内容：

    DEEPSEEK_API_KEY=sk-你的DeepSeek密钥
DEEPSEEK_MODELS=deepseek-v4-pro,deepseek-v4-flash
DEFAULT_PROVIDER=deepseek
PROXY_PORT=4000
LOG_LEVEL=info

  3. 把 sk-你的DeepSeek密钥 替换成你在第一步获取的真实 API Key

    替换后应该像这样：DEEPSEEK_API_KEY=sk-abc123def456xyz

  4. 点击记事本的 文件 → 另存为

    • 在地址栏输入：%USERPROFILE%.codex\codex-bridge

    • 文件名输入： .env

    • 保存类型改为：所有文件（.）

    • 点击保存

    ⚠️ 注意：文件名就是 .env，前面没有名字，只有扩展名。

📍 第四步：配置 Codex 桌面版

4.1 找到配置文件

  1. 打开文件资源管理器
  2. 在地址栏输入：%USERPROFILE%.codex
  3. 回车

4.2 编辑配置文件

  1. 找到 config.toml 文件

  2. 右键点击 → 选择  “打开方式”  → 选择  “记事本”

  3. 清空文件里的所有内容

  4. 粘贴以下配置：

    model = "deepseek-v4-pro"
model_provider = "deepseek_bridge"

[model_providers.deepseek_bridge]
name = "DeepSeek V4 Bridge"
base_url = "http://127.0.0.1:4000/v1"
wire_api = "responses"

  5. 点击 文件 → 保存

  6. 关闭记事本

📍 第五步：启动一切，开始使用

5.1 启动“翻译官”

  1. 按 Win + R，输入 cmd，回车打开命令提示符

  2. 输入以下命令，回车：

    cd %USERPROFILE%.codex\codex-bridge

  3. 再输入以下命令，回车：

    node --env-file=.env proxy.mjs

  4. 如果看到类似以下输出，说明翻译官已就位：

    text

    [codex-bridge] Listening on http://127.0.0.1:4000
[codex-bridge] Default provider: deepseek

    ⚠️ 重要提醒：这个命令提示符窗口绝对不能关！关掉就等于翻译官下班了。每次使用 Codex 前都要先启动它。

5.2 启动 Codex 桌面版

  1. 保持翻译官窗口打开
  2. 点击开始菜单，找到 Codex 图标，打开它
  3. 或者直接按 Win 键，输入 Codex，回车

5.3 验证是否成功

在 Codex 的对话框里输入：

用中文回答：你是谁？

预期回复：

  • 如果回答包含“DeepSeek”或“深度求索”，说明配置成功！
  • 如果报错 402 Insufficient Balance，说明 DeepSeek 余额不足，回到第一步充值。
  • 如果报错 401 Unauthorized，说明 API Key 配置有误，检查 .env 文件。

📋 日常使用流程（以后每次这样做）

1. 打开命令提示符，启动翻译官
   → Win+R → cmd → 输入两行命令：
   cd %USERPROFILE%.codex\codex-bridge
   node --env-file=.env proxy.mjs

2. 看到 "Listening on http://127.0.0.1:4000" 后
   → 保持这个窗口开着

3. 打开 Codex 桌面版
   → 正常使用

4. 使用完毕后
   → 关闭 Codex
   → 关闭命令提示符窗口（翻译官下班）

📊 DeepSeek V4 收费说明

模型版本特点价格（每100万Token）适合场景
V4-Flash速度快，成本低输入 ¥1，输出 ¥2日常对话、简单编程
V4-Pro能力强，推理深输入 ¥12，输出 ¥24复杂推理、高级代码

什么是Token？  大约100万Token = 75万个汉字。充值10块钱，用V4-Flash可以用很久。

🔧 常见问题速查

问题原因解决方法
402 Insufficient BalanceDeepSeek余额不足登录 platform.deepseek.com 充值
401 UnauthorizedAPI Key错误检查 .env 文件里的Key是否完整复制
连接失败翻译官没启动确认命令提示符窗口还开着
node: command not foundNode.js没装好重新执行第二步，安装Node.js
翻译官启动报错.env 文件路径或格式错误确认文件在 codex-bridge 文件夹里，名字是 .env
想用Flash模型配置里写的是Pro把 config.toml 里的 deepseek-v4-pro 改成 deepseek-v4-flash

✅ 操作检查清单

完成以下所有项，说明你已经成功上手：

  • DeepSeek 账号已注册，API Key 已获取
  • DeepSeek 账户有余额（体验额度或已充值）
  • Node.js 已安装（node --version 有输出）
  • codex-bridge 文件夹已创建，proxy.mjs 和 .env 都在里面
  • .env 文件里的 API Key 已替换为真实 Key
  • config.toml 已配置好
  • 翻译官能正常启动（看到 "Listening on..."）
  • Codex 桌面版能正常对话
avatar
文章
阅读
粉丝