让国内用户直连下载官方 Codex 桌面安装包（codex-app-mirror）

Codex 桌面应用的官方分发渠道是 Microsoft Store 和 OpenAI 自己的下载地址。国内网络访问这两处经常慢，商店偶尔抽风，企业环境里 Store 还可能被策略禁掉。想装的人要的是一个能直连、能核对完整性、不用每次重下完整包的入口。

codex-app-mirror 把官方 Codex 桌面应用的安装包原样镜像到 GitHub Release，由 Shell 与 GitHub Actions 驱动，输出可 SHA256 校验的安装文件，外加一套 macOS 增量更新源。

仓库地址是 https://github.com/Wangnov/codex-app-mirror，MIT 许可证，主要语言 Shell，占比 78.3%，其余是 JavaScript、C#、Python 和 PowerShell。Star 3664，Fork 166，开放 Issue 1 个。项目声明只做镜像：不构建、不修改、不重打包，从上游拿到的字节原样发布。

基础用法

安装与依赖

使用者这一侧不需要安装任何东西。项目没有命令行工具，也没有 npm、pip 之类的依赖，你只需要一个浏览器和能访问 GitHub 或镜像短链的网络。

打开最新 Release，按平台选文件：

• Windows x64：OpenAI.Codex_..._x64__2p2nqsd0c76g0.Msix
• Windows ARM64：OpenAI.Codex_..._arm64__2p2nqsd0c76g0.Msix，仅当官方下载 URL 已解析时发布
• Apple Silicon Mac：Codex-mac-arm64.dmg
• Intel Mac：Codex-mac-x64.dmg

Linux 走独立通道。OpenAI 在 2026-08-11 放出统一 ChatGPT 桌面应用的 Linux Preview，里面含 ChatGPT、ChatGPT Work 与 Codex。这些包不会混进 Stable Latest，要去 Releases 里找 codex-app-linux-preview-<版本> 这个 prerelease，再按发行版取 chatgpt_<版本>_amd64.deb、chatgpt_<版本>_arm64.deb 或 Fedora 的 .rpm。

最短能跑通的示例

最短路径是打开短链，它永远指向当前最新版，不用去 Releases 里翻：

https://codexapp.agentsmirror.com/latest/win
https://codexapp.agentsmirror.com/latest/win-x64
https://codexapp.agentsmirror.com/latest/win-arm64
https://codexapp.agentsmirror.com/latest/mac-arm64
https://codexapp.agentsmirror.com/latest/mac-intel
https://codexapp.agentsmirror.com/latest/checksums
https://codexapp.agentsmirror.com/latest/manifest

/latest/win 是 /latest/win-x64 的兼容别名。win-arm64 只在当前版本已解析到 ARM64 包时可用。短链会自动按你的网络选节点，国内走 S3 副镜像，海外走 Cloudflare R2。

仓库没有给出命令行的下载示例，短链是普通的 HTTP 地址，浏览器和常见下载工具都能取。下载完建议再取一份 SHA256SUMS.txt 做核对。

确认它跑起来了

这一跑成功的标志是：文件完整下载下来，扩展名与你的平台对得上（Windows 是 .Msix，macOS 是 .dmg，Linux 是 .deb 或 .rpm），并且它的 SHA256 与 SHA256SUMS.txt 里的记录一致。

几个结果入口各自管什么：

• GitHub Releases 页面放具体文件，也在那里按 tag 找历史版本
• /latest/checksums 给校验和
• /latest/manifest 给这一版的 Release 指纹

短链只指向最新版，要旧版本得去 Releases 里查。

主要功能

三平台安装包镜像与分发

• Windows MSIX：直接镜像 Microsoft Store 的包。x64 走稳定发布，ARM64 也纳入 manifest 与镜像路径。ARM64 若暂时解析不到下载 URL，会以 catalog-only 状态记在 manifest 里，这时候拿不到文件。
• macOS DMG：Apple Silicon 与 Intel 双架构，官方原包，零改动。
• Linux Preview：Ubuntu / Debian 的 DEB 与 Fedora 的 RPM，x64 与 ARM64 都有。这是显式隔离的第三通道 stable | beta | linux-preview，只发 GitHub prerelease，不进 CDN、不推进 Latest、不创建 latest/linux* 短链。官方包装好后会配置 OpenAI 自己的更新仓库，后续自动更新直接来自 OpenAI，不经过本镜像。
• 国内可达：发布后资产同步到 Cloudflare R2（codexapp-r2.agentsmirror.com）与一套 S3 副镜像，Cloudflare Worker 读请求的 CF-IPCountry 决定走哪边，中国大陆访客分流到 S3。用户看到的是同一条短链。

探测、校验与自动更新

• 15 分钟探测：主调度是 Cloudflare Cron Trigger，每 15 分钟触发一次 mirror.yml；GitHub Actions 自带 schedule 每 6 小时兜底一次（11 */6 * * *），防止 GitHub 计划任务被延迟或跳过。每次先做轻量探测，上游没变就到此为止，不下载、不发重复 Release。Windows 侧靠 Microsoft Store DisplayCatalog 取元数据，再用 FE3 metadata 解析可下载的 MSIX moniker 和临时 CDN URL；macOS 侧读官方 DMG 与 appcast 的 ETag、Last-Modified、Content-Length；Linux Preview 侧用固定公钥验证官方 APT InRelease 与 RPM repomd.xml。
• 可校验：每个 Release 附 SHA256SUMS.txt 与 release-manifest.json，后者记录了上游指纹。新版本会和上一版 manifest 的稳定字段比对。
• macOS Sparkle 增量更新：提供 appcast 与 delta 差量包，客户端只下版本之间的差量而不是整包。镜像逐字节复制官方 Sparkle 归档和 OpenAI 的 EdDSA 签名，只改写 enclosure 的下载地址。EdDSA 签的是归档字节本身，字节级一致时原始签名仍然有效，镜像不伪造也伪造不了签名。客户端找不到匹配 delta 时会回退到完整归档。

参数与配置

常用参数

项目没有命令行参数，也没有需要你填的环境变量。使用者能控制的只有从哪个入口取包：

• 通道标识是 stable | beta | linux-preview，Linux 包只在第三个通道里
• 平台短链就是「基础用法」一节列出的那七个地址，分别对应 Windows x64、ARM64 与 Mac 双架构
• macOS 自动更新源分架构：Apple Silicon 用 /latest/appcast.xml，Intel 用 /latest/appcast-x64.xml

管道侧的入口是 mirror.yml 这个工作流，由 Cloudflare Cron 通过 workflow_dispatch 触发，README 没有说明它接受哪些输入字段。

配置文件

仓库里没有面向使用者的配置文件。管道自身涉及一份清单文件 release-manifest.json，它的机器可校验契约写在 docs/manifest-schema.md 与 schemas/release-manifest.schema.json 里，你可以照这个 schema 去解析 /latest/manifest 返回的内容。

目录结构里的 .github/、cloudflare/、scripts/ 是管道自身的实现，README 没有逐个说明它们内部的文件和字段。

实际使用中的坑

仓库的 Issue 列表里，几个问题反复出现。它们目前都标记为已解决，但知道现象能省排查时间。

• 开关代理后检查更新结果不一致：同一台 Windows 设备、同一个 Codex App Manager，开代理能发现新版本 26.707.31428，关代理直连却提示当前版本 26.623.141536 已是最新。两个网络路径拿到的结果不一样，容易被误判成应用坏了。
• MSIX 报 0x803FB017：从镜像装 Codex-Windows-x64.msix（v26.915.4065.0）时启动失败，错误码对应 APPX_E_FILE_HASH_MISMATCH，提示包未签名。这类报错和文件哈希对不上有关，先核对 SHA256SUMS.txt。
• 上游品牌合并打断镜像管道：Codex 并入 ChatGPT 品牌后，镜像的探测与命名逻辑出现断点，仓库用一个三层修复提案处理身份、渠道、文件名的映射。根源在上游，镜像侧只能跟着改。
• 老系统被自动更新顶掉：Mac mini 的 Intel 机器最高只能装到 macOS 12，更新到最新版后提示要求 macOS 13，退回老版本后又被自动更新推回新版，当时也没有关闭自动更新的开关。

合规限制

这个项目每 15 分钟探测的是 Microsoft Store DisplayCatalog、官方 DMG 与 appcast、以及 OpenAI 的 APT 与 RPM 仓库，读的都是公开元数据，不涉及对使用者或第三方系统的扫描抓取。

它做的是分发镜像，使用时要注意的是来源与完整性。镜像声明不构建、不修改、不重打包，逐字节复制官方归档与 EdDSA 签名，也不伪造签名，你下载后仍应核对 SHA256SUMS.txt 与 release-manifest.json。

MIT 许可证标注在仓库自身。仓库里没有说明这些镜像安装包再分发的授权边界。

适合谁

适合国内网络环境、Microsoft Store 不可用或企业策略禁用了商店的 Windows 用户，也适合需要给多台机器准备同一份可校验安装包的运维。macOS 用户如果要的是增量更新而不是每次重下完整 DMG，这套 appcast 现成可用。把镜像当更新后端的客户端开发者，可以直接订阅那两个 appcast 地址。

需要 Linux 稳定版的用户不适合，目前只有 Preview prerelease。macOS 12 的老机器不适合，最新版要求 macOS 13。想把安装包拿去做二次改造或重新打包分发的人，与这个项目的定位相反，它刻意不做改动。只想要一键安装、不想碰哈希核对的人，README 里指向了基于本镜像的 Codex App Manager 桌面客户端，仓库地址是 github.com/Wangnov/Codex-App-Manager。

焚评：这个项目的量化评分

本项目的选题来自 焚.com（一个按公开公式给 GitHub 项目打分的站）。焚评当前总分 9.3 分（满分 10）。下表是各维度的得分：

评分口径、权重与计算方式见焚.com 的评分方法页；数据随 GitHub 指标刷新，具体数值以焚.com 当前页面为准。本文正文为诀.com 独立撰写，评分数据由焚.com 授权引用。