中国用户安装 Codex App 踩坑实录

Codex 安装踩坑

背景

我想装的是 Codex App。这篇记录的是 Windows 上从处处碰壁,到桌面应用终于能打开的过程。

然后开始了长达一小时的踩坑之旅。

坑一:官网打不开

第一反应是去官网下载。打开 openai.com/codex,浏览器转了半天,返回 403 Forbidden。

用 curl 一看,Cloudflare 直接给了个 challenge 页面。在我这条网络下,页面都打不开,更别说找下载按钮。

结论:官网这条路,不通。

坑二:下载链接超时

翻了一圈教程,找到了 OpenAI CDN 上的静态下载地址。

curl 一跑,SSL 握手超时,几秒后连接重置。这个 CDN 地址在我这里也走不通。

结论:直连下载,也不通。

坑三:Microsoft Store 安装器是个空壳

又找到一个 Microsoft Store 的引导安装器链接,这次居然能下载。下完一看,只有 1.4MB。

1.4MB 能装什么?一个 .NET 写的引导程序,它的工作是帮你打开 Microsoft Store 然后从商店下载完整包。

问题是:这台机器的 Microsoft Store 服务有问题。运行之后直接卡死,没有任何反馈。

坑四:Windows 版本不兼容

好不容易让 Store 安装器跑起来了,弹出来一个对话框:

Microsoft Store 报错:Windows 版本不符合最低要求

“你的电脑上的 Windows 版本不符合此应用的最低要求。”

好家伙,Windows 10 LTSC 2019(Build 17763)被嫌弃了。Codex App 要求更新的 Windows 版本。点”检查更新”没用,点”重试”还是同样的错。

结论:Store 这条路,死胡同。

最终方案:用第三方安装器装 Codex App

官方的下载和 Store 路线都走不通后,我换成了 codex-windows-updater。它不是 OpenAI 官方工具:它会从 Microsoft 的服务下载官方 Codex MSIX,解压到自己的安装目录,再由一个启动器检查更新和打开 App。这样不需要依赖 Microsoft Store 客户端。

安装步骤很短:

  1. 到项目的 Releases 页面 下载 codex-launcher.exe
  2. 首次运行会打开安装向导,选择 User 模式即可
  3. 默认会装到 %LOCALAPPDATA%\Codex,完成后从开始菜单或安装目录打开 Codex
  4. 之后启动 codex-launcher.exe,它会按设定检查并安装更新

下载前,先做两件事

这是第三方安装器,不该跳过校验。

  1. 只从该项目的 GitHub Releases 下载,不要从网盘或不明转载站拿 exe
  2. 把下载文件的 SHA-256 和 Release 附带的校验值对上。PowerShell 可以运行:
(Get-FileHash .\codex-launcher.exe -Algorithm SHA256).Hash

项目发布的 exe 目前没有 Windows 代码签名,所以 SmartScreen 首次提示是预期现象。只有在确认仓库、Release 和校验值都对得上时,才继续运行。

最后说一句

这条路解决的是“没有 Store 或 Store 装不上”时怎么拿到 Codex App,不是官方安装渠道的替代品。等官方入口在你的网络和系统上可用,优先走官方;第三方安装器只在你愿意自己核验来源和承担额外风险时使用。