OpenAI Codex App for Windows: 从零构建教程 (含安装包)
2026年2月4日星期三
OpenAI 一直优先发布一些 macOS-only 的产品,好在这次 Codex 是基于 Electron 构建 UI,底层调用 Codex-CLI,我们就有了一些逆向重新构建 Windows 版本的可能。
打包版本
仅作体验尝鲜,只做一个成果演示,不负责后续维护。
-
前往下载:https://github.com/Loongphy/codext/releases/tag/rust-v0.94.0
-
或者下载这个项目 CodexDesktop-Rebuild,本篇文章的灵感来自于此,不过它的 Codex-CLI 是修改版本,我也不清楚改了啥。
我还是主力 Codex-CLI,不常用 App 版本,毕竟 UI 都只是在调用 Codex-CLI,我对现有工作流很满意,不需要 GUI。我也无法拒绝 WSL2,当前 Windows App 版只能通过跨文件系统访问,如 \\wsl.localhost\Debian\root,文件读写会很慢。
有问题可以在评论区提,在官方正式推出前会随着 Codex-CLI Release 版本更新。
授人以鱼不如授人以渔,希望看完这篇文章后能够自己构建、自己修🫡。
下载 macOS 安装包
在 Chrome 里“伪装成 macOS”(UA + Client Hints)打开 https://openai.com/codex/ 下载 codex.dmg 安装包:
- 打开 DevTools:按
F12/Ctrl+Shift+I - 打开命令菜单:
Ctrl+Shift+P,输入 Network conditions,选择 Show Network conditions(会在 DevTools 底部出现面板)。 - 在 User agent 区域,取消勾选 Use browser default,然后:
- 直接从下拉选择一个 macOS / Safari(如果有)
- (很关键)点开 User agent client hints 下拉,把
platform之类的字段也改成 macOS,点 Update。很多站现在更依赖 Client Hints,而不是只看 UA 字符串。 - 刷新页面。
构建 Codex Windows App
我更喜欢在 WSL2 中配合 CLI 形式的 Agent 开发,Windows 的终端体验属于是狗弃人厌,LLM 也容易出错,不小心删除文件的事件屡见不鲜。
创建一个空的文件夹,把下载的 .dmg 文件复制过来,在 WSL2 访问此目录执行 codex,输入 /Approvals 授予 Full Access 权限,Let’s go~。
- 初始 Prompt
请基于我当前仓库的现状,帮我把“基于 macOS 已打包产物的 Electron 应用”重封装为可在 Windows 上构建与打包的版本。
## 项目目的
- 我只有一个 macOS 安装包(Electron 打包后的 .dmg),我想在 Windows 上重新构建出可运行的 Windows App。
- 我不打算恢复源代码或重新编译前端;目标是“重封装/重打包”:把已打包产物作为输入,在 Windows 上重新构建出可运行的 Windows App。
- 后端 CLI 由 Codex-CLI 进程提供:Windows 需要 `codex.exe`,通过 `@openai/codex` 拿到对应平台的预编译 `codex.exe`。
## 交付结果
- 一个 Windows 的可安装文件
## 注意事项
- 我们处于 WSL2 环境中,对于 Windows 相关的依赖打包,需要调用 pwsh.exe 来执行。
观察者
AI 用户习惯让工具直接修复错误,自己很少独立思考,导致后期独立发现和修复 bug 的能力变弱——这恰恰是监督 AI 输出时最需要的技能。
我看到过很多人 Vibe Coding 只看结果责怪 Agent,而不去查看过程,检查是否在某刻出现了偏差。
仅将观察 Codex-CLI 执行过程中遇到的问题记录下来:
prefer uv not python
在执行过程中发现会使用 Python,由于我不希望安装各种依赖到处拉屎,在执行过程中又加了一个 prefer uv not python 的要求。
不过看后续的内容还是直接安装了 Python 而非使用 uv,所以推荐把上述要求加到初始 Prompt 或者 AGENTS.md 文件中。
对于 AGENTS.md 的指令,Codex-CLI 会设定为第一优先级,严格遵循,遗漏的情况很少。

打包过程使用了 Visual Studio Tools,也许你需要先安装一个 Visual Studio Community,应该和开发 Electron 所需的环境一致:安装【使用 C++ 的桌面开发】。

单次执行结果
只有首次的 Prompt 和中间的一句 prefer uv not python,41 分钟完成。

最终只是运行起来了,仍然有一点 bug,比如窗口没做 resize,没法自由拉伸。选择项目后出现 Oops, an error has occurred。
这些都在一句提示词后解决了,now, let’s play with it!
伟哉,Codex-CLI!
另一条构建路线
可能你不想在本地构建,不想安装各种乱七八糟的环境,可以尝试使用 Codex-CLI 在 GitHub Actions 中执行,选择在 Windows 环境中构建,通过 codex "你的指令" 的方式执行,将打包后的产物上传到 Artifacts,你就能直接下载了。
提示词可能需要调整,让它不打包成功就一直重试,因为 Codex-CLI 倾向于询问而非自主完成任务。

期望
开发一个 Windows 版本没那么简单,虽然不指望用 WinUI 3,毕竟微软自己也陷入了技术泥淖。但希望每个编程软件的开发者都考虑下 WSL2 的适配工作,达到 VS Code 那样的原生 Linux 开发体验吧。