Codex桌面版安装配置全攻略(接DeepSeek)

无需登录 · 接入 DeepSeek · 国内直连 · 10 分钟上手

最近 Codex 桌面版在开发者圈子里非常火，但不少朋友卡在"必须登录 OpenAI 账号"和"访问境外服务器困难"这两关上。今天分享一个完整的解决方案：通过 Codex++ 增强工具 把请求转发到 DeepSeek 国内API，全程不需要 OpenAI 账号，不需要登录，也不需要访问境外网络。

本教程涵盖 macOS 和 Windows 两个平台，我用的是 Mac Intel 芯片版本，Mac Apple Silicon（M1/M2/M3）用户选择对应版本即可，流程完全一样。

一、整体架构说明

先理解原理，后面操作就不会懵：

你输入指令
    ↓
Codex 桌面界面（前端交互）
    ↓
Codex++ 本地代理（127.0.0.1:57321，拦截并转发请求）
    ↓
DeepSeek API（api.deepseek.com，国内直连）
    ↓
返回结果，呈现在 Codex 界面中

核心就一句话：Codex++ 负责"拦截+转发"，让你用 Codex 的界面，走 DeepSeek 的算力。两个工具各司其职，全程走国内网络。

二、准备工作：申请 DeepSeek API Key

这是唯一需要你花钱的地方，但价格非常低，按量计费，充 10 块钱能用很久。

步骤 1：注册并充值

打开 https://platform.deepseek.com，用手机号注册账号，然后在「充值」页面充值（建议 10-20 元即可）。

步骤 2：创建 API Key

进入「API Keys」页面，点击「创建新的 API Key」，名称随意填写（比如 codex），创建后 立刻复制保存，因为关闭页面后就无法再次查看了。

⚠️ 重要： API Key 是调用 DeepSeek 的凭证，相当于你的"钥匙"。请妥善保管，不要泄露给他人，也不要截图发到公开平台。

三、下载 Codex++ 增强工具

Codex++ 是整个方案的"核心枢纽"。它不修改 Codex 原始文件，而是通过外部启动器的方式注入增强脚本，将 Codex 的请求转发到你配置的 DeepSeek API。

项目地址：https://github.com/BigPizzaV3/CodexPlusPlus

如果 GitHub 访问困难，使用国内镜像加速下载：

可用镜像站：

https://gh-proxy.com/
（在 GitHub 链接前加上这个前缀即可）
https://ghproxy.net/
https://gh.api.99988866.xyz/

使用方法示例：

原始链接：
https://github.com/BigPizzaV3/CodexPlusPlus/releases/download/v1.2.20/CodexPlusPlus-1.2.20-macos-x64.dmg

加速链接（在前面加上 gh-proxy.com/）：
https://gh-proxy.com/https://github.com/BigPizzaV3/CodexPlusPlus/releases/download/v1.2.20/CodexPlusPlus-1.2.20-macos-x64.dmg

根据你的系统选择对应版本：

系统	文件
macOS Intel	`CodexPlusPlus-*-macos-x64.dmg`
macOS M1/M2/M3	`CodexPlusPlus-*-macos-arm64.dmg`
Windows	`CodexPlusPlus-*-windows-x64-setup.exe`

macOS 安装步骤：

步骤 1：下载并挂载 DMG

双击下载的 .dmg 文件，会挂载出一个名为「Codex++」的磁盘。

步骤 2：拖入应用程序

将「Codex++.app」和「Codex++ 管理工具.app」两个应用拖到「应用程序」文件夹。

步骤 3：解除安全限制

打开终端（Terminal），依次执行以下命令（需要输入你的 Mac 登录密码）：

sudo xattr -rd com.apple.quarantine "/Applications/Codex++.app"
sudo xattr -rd com.apple.quarantine "/Applications/Codex++ 管理工具.app"

这一步是为了解除 macOS 对未签名应用的安全拦截，否则无法正常打开。

💡 Windows 用户： 直接双击 setup.exe 安装，弹出系统风险提示时选择「更多信息」→「仍要运行」即可。桌面会自动生成两个快捷图标。

四、下载安装 Codex 桌面版

Codex 桌面版同样可以通过国内镜像加速下载：

Codex macOS 国内镜像下载（通过 gh-proxy 加速）：

https://gh-proxy.com/https://github.com/Wangnov/codex-app-mirror/releases/download/codex-app-26.623.42026/Codex-mac-x64.dmg

Windows 用户： 可将以上链接中的 mac-x64 替换为对应的 Windows 版本文件名，或从微软应用商店直接搜索「Codex」安装。

macOS 安装步骤：

步骤 1：下载并挂载 DMG

双击下载的 Codex-mac-x64.dmg，会挂载出「Codex Installer」磁盘。

步骤 2：拖入应用程序

将「Codex.app」拖到「应用程序」文件夹即可。

五、配置 DeepSeek API 供应商

这是最关键的一步。打开刚才安装的「Codex++ 管理工具」，按以下步骤操作：

步骤 1：进入供应商配置

点击左侧菜单「供应商配置」→ 点击右侧「添加供应商」。

步骤 2：填写配置参数

按以下内容严格填写：

配置项	填写内容
名称	`DeepSeek`
接入模式	纯 API
Base URL	`https://api.deepseek.com`
Key	粘贴你在 DeepSeek 后台创建的 API Key
上游协议	Chat Completions
测试模型	`deepseek-chat`

步骤 3：保存并启用

点击「保存」→ 返回列表，找到刚创建的 DeepSeek 条目 → 点击右侧的「使用」按钮 → 右上角出现「使用中」提示即配置成功。

步骤 4：测试连接（可选）

点击「发送 hi 测试」，如果返回 HTTP 200 和正常回复内容，说明 DeepSeek API 连接成功。

六、启动 Codex

⚠️ 重要：必须通过 Codex++ 启动！ 不要直接双击 Codex.app，否则不会加载 DeepSeek 配置，你会被卡在 OpenAI 登录页面。

正确启动流程：

步骤 1：彻底退出所有 Codex 进程

确保系统中没有任何 Codex 相关进程在运行。macOS 可以在终端执行 pkill -f "Codex"；Windows 则打开任务管理器结束所有 Codex 进程。

步骤 2：双击 Codex++.app 启动

这时 Codex++ 会自动以增强模式启动 Codex 主程序，启动后可以看到它注入了 --remote-debugging-port=9229 参数。

步骤 3：首次进入的操作

加载完成后如果看到登录页面，直接点击 Skip 跳过。如果点 Skip 后页面卡住，完全退出 Codex 后重新启动，重复 2-3 次即可正常进入主界面。

启动慢的解决方案：

Codex 启动时会尝试连接 OpenAI 服务器，如果连接不上会等待超时，最长可能 2 分钟。实测有效的解决方法是：启动 Codex 时先断开本地网络，等界面加载出来再恢复网络连接。这样连接请求会快速判定失败，大幅缩短等待时间。

七、验证是否配置成功

💡 进入 Codex 主界面后，在对话页面的模型选择栏中，应该能看到 DeepSeek 相关选项（如 deepseek-chat 等）。如果没看到，退出所有 Codex 进程后重新用 Codex++ 启动即可。

可以发送一条简单指令测试，比如：

"帮我创建一个 hello.py 文件，内容是打印 Hello World"

如果 Codex 成功创建了文件并返回了结果，说明整个链路已经打通：

你的指令 → Codex 界面 → Codex++ 本地代理 → DeepSeek API → 返回结果

八、常见问题

Q1：模型选择栏没有 DeepSeek 选项？

退出所有 Codex 进程（包括后台进程），重新用 Codex++ 启动。如果仍不行，打开 Codex++ 管理工具检查供应商是否处于「使用中」状态。

Q2：Codex 启动后一直白屏？

等待 1-2 分钟，白屏会自动跳转。如果超过 2 分钟没反应，断开网络再重试。

Q3：对话报错或无响应？

检查 DeepSeek 账户余额是否充足；确认 API Key 是否正确粘贴到 Codex++ 管理工具的配置中。

Q4：汉化怎么操作？

进入 File → Settings → General → Language，选择「中文（简体）」后点击 Restart 重启即可。注意：汉化需要从 OpenAI 服务器下载中文语言包，需要网络能正常访问 OpenAI 服务。如果暂时无法汉化，英文界面也不影响核心功能使用。

九、总结

回顾一下完整流程：

✅ 在 DeepSeek 官网注册并创建 API Key
✅ 通过国内镜像下载 Codex++ 增强工具并安装
✅ 通过国内镜像下载 Codex 桌面版并安装
✅ 在 Codex++ 管理工具中配置 DeepSeek API 供应商
✅ 通过 Codex++ 启动 Codex，Skip 登录后即可使用

整个过程全程走国内网络，下载用GitHub镜像加速，API调用走DeepSeek 国内服务器。不需要 OpenAI 账号，不需要登录，不需要任何特殊网络环境。

核心要点再强调：
① 必须用 Codex++ 启动，不要直接打开 Codex.app
② API Key 创建后立刻保存，关闭页面无法再查看
③ 启动慢就断网再重开，实测有效

有问题欢迎留言交流 🎉