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

Codex 安装踩坑

背景

OpenAI 的 Codex App 是一个桌面端 AI 编程助手，类似一个能直接操作你代码的 AI 队友。2026 年它终于有了 Windows 版本，我兴冲冲地准备装上试试。

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

坑一：官网打不开

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

用 curl 一看，Cloudflare 直接给了个 challenge 页面。中国 IP 被拦得死死的，连页面都看不到，更别说找下载按钮了。

结论：官网这条路，不通。

坑二：下载链接超时

翻了一圈教程，找到了官方静态下载地址：persistent.oaistatic.com/codex-app-prod/...

curl 一跑，SSL 握手直接超时，5 秒后连接重置。GFW 把 OpenAI 的 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 这条路，死胡同。

坑五：GitHub 安装脚本路径炸裂

既然 Store 不行，那就从 GitHub Releases 直接下载。OpenAI 在 GitHub 上提供了完整的构建产物，还有一个 install.ps1 安装脚本。

下载脚本，运行：

==> Installing Codex CLI
==> Detected platform: Windows (x64)
==> Resolved version: 0.145.0
==> Downloading Codex CLI
tar (child): Cannot connect to C: resolve failed
gzip: stdin: unexpected end of file

经典的 Windows 路径问题。脚本内部调用 tar 解压时，MSYS 环境把 C:\Users\... 里的 C: 当成了远程主机地址。一个路径解析 bug，脚本直接报废。

结论：官方脚本在 Windows 上跑不通。

最终方案：直接下载 exe

折腾了一圈，其实 GitHub Releases 里有现成的 Windows x64 可执行文件：

codex-x86_64-pc-windows-msvc.exe（359MB）

不需要安装器，不需要脚本，下载下来放到 PATH 里就能用。

但问题是：这个文件在 GitHub 上，下载速度感人，而且很多中国用户连 GitHub Releases 都访问不稳定。

交给 AI 一句话搞定

踩完所有坑之后，我打开 QoderWork，打了一句话：

帮我从 GitHub 下载 Codex CLI 的 Windows x64 版本，安装到本地，配置好 PATH，验证能正常运行。

然后它：

  1. 从 GitHub Releases API 找到最新版本的下载链接
  2. 下载了 359MB 的 exe 文件
  3. 放到 ~/.codex/bin/ 目录
  4. 验证 codex --version 输出 codex-cli 0.145.0

全程不到两分钟。我踩了一小时的坑，它两分钟走完。

给中国用户的安装建议

如果你也想装 Codex，这是我的总结：

最省事的方式：让 AI 助手帮你装。把这句话发给你的 QoderWork / Cursor / 任何能执行命令的 AI：

从 https://github.com/openai/codex/releases 下载最新的
codex-x86_64-pc-windows-msvc.exe，放到 ~/.codex/bin/，
加入 PATH，验证 codex --version 能正常输出。

手动安装：

  1. 你需要一个能稳定访问 GitHub 的网络环境
  2. 去 github.com/openai/codex/releases 找最新版本
  3. 下载 codex-x86_64-pc-windows-msvc.exe（约 359MB）
  4. 放到一个固定目录，比如 C:\Users\你的用户名\.codex\bin\
  5. 把这个目录加到系统 PATH
  6. 打开终端，运行 codex --version 验证

不要走的路：

  • 不要试图直连 openai.com（403）
  • 不要试图直连 persistent.oaistatic.com（超时）
  • 不要用 Microsoft Store 安装器（空壳 + 版本限制）
  • 不要在 Windows 上跑官方 install.ps1（tar 路径 bug）

最后说一句

这不是 Codex 的问题，也不是 Windows 的问题。是”中国用户 + 海外服务”这个组合天然就有一堆摩擦。网络墙、版本限制、路径差异——每一个单独看都是小问题，叠在一起就是一小时的折腾。

AI 助手的价值在这里体现得很明显：它不会烦躁，不会放弃，不会在第四个坑的时候开始怀疑人生。你告诉它目标，它自己找路。

这大概就是 2026 年”安装一个软件”该有的样子。

← back to posts