2. Linux.do
  3. 【开源】Codex APP 的安装包官方镜像仓库，包括Windows离线安装包（Codex实用小工具系列第三弹）

【开源】Codex APP 的安装包官方镜像仓库，包括Windows离线安装包（Codex实用小工具系列第三弹）

Wangnov 2026-05-16 20:05 1

本帖使用社区开源推广，符合推广要求。我申明并遵循社区要求的以下内容：



  • 我的帖子已经打上 开源推广 标签： 是

  • 我的开源项目完整开源，无未开源部分： 是

  • 我的开源项目已链接认可 LINUX DO 社区： 是

  • 我帖子内的项目介绍，AI生成、润色内容部分已截图发出： 是

  • 以上选择我承诺是永久有效的，接受社区和佬友监督： 是


以下为项目介绍正文内容，AI生成、润色内容已使用截图方式发出





前言

这是 Codex 实用小工具系列 第三弹。


Codex 实用小工具系列是楼主在日常使用，或应朋友要求，或工作需要Vibe开发的一系列工具。从 CLI 到 APP 到 网络服务应有尽有。


正值五一节后进入摸鱼期，趁 cdx 干活的时候，我空闲下来把开源的工具都整理了一下，分享给各位佬友，希望能帮到有需要的人，如有帮助，还望不吝 Star，多谢！



这是什么




codex-app-mirror，一个镜像官方 Codex App 安装包的项目。


定时从官方来源抓取：



  1. Windows x64 MSIX（没有 exe ）

  2. macOS Apple Silicon DMG

  3. macOS Intel DMG


然后发布到 GitHub Release，同时同步一份到 Cloudflare R2（只保留最新版，我存不起那么多的），方便国内用户下载。


以下为 AI 写的 README 截图：



为啥要做这个


Codex APP 做的越来越好，但是安装体验一直拉完了。对于 Arm Mac 来说，那是亲儿子，没话说。Intel Mac 最近也加了支持，虽然兼容的不是很完整（打开就一堆 UI BUG，但是好歹能用），但是好歹也是有个 dmg 可下载的。


Windows 呢？我那么大一个 Windows 用户群体呢？你竟然告诉我必须得走 Microsoft Store 来下载？？？


且不说有很多人网络环境连不上 Microsoft Store，最气的是就算有时候开了梯子也连不上。


正常情况下，懂点技术的用户往往可以自己解决网络问题，然后走直截了当的方式，比如命令行：


winget download --id 9PLM9XGG6VKS --source msstore --accept-package-agreements

但是如果安装的用户是小白呢（


比如，平时我做线下的分享，有很多朋友也想试试 Codex APP 有没有我说的那么神奇。然后他们就让我帮忙装一下，我脑门的汗就下来了。正好今天在 xhs 碰到了一个想找人帮忙解决 Codex APP 安装问题的，我就顺带想看看，到底有没有一个离线安装包可以解决 Windows 这个烦人的安装。


一番让 GPT Pro搜索之后，找到了一些解决办法，其实就是直接从微软商店里把 .msix 拿出来，然后就可以基本能做到离线安装了。


不过拿这个 .msix 还是有点费劲，网上有一些做这样的工具，但是网页很繁琐古旧，我追根溯源了一下，底层的依赖也很老且很简单。


所以直接让 GPT 大人出手，把这个底层搓出来，然后又搓了一个自动轮询的 Github Action ，把官方的最新版 APP 拉到项目的 Release 里，另外再拉到我的 R2 桶里，让国内用户也都能顺畅安装上。


顺手也镜像了 Mac 的两个 .dmg 。


下载地址


GitHub Release（保存了从我当时开始镜像的全部版本历史）：




R2 短链接：


Windows:

https://codexapp.agentsmirror.com/latest/win



Mac Apple Silicon:

https://codexapp.agentsmirror.com/latest/mac-arm64



Mac Intel:

https://codexapp.agentsmirror.com/latest/mac-intel



Checksums:

https://codexapp.agentsmirror.com/latest/checksums

怎么安装 Windows 版


下载 MSIX 后，正常 Windows 直接双击安装即可。


但是，Windows 有各种稀奇古怪的定制版，尤其是企业内部的。如果遇到问题，按如下顺序尝试：



  1. 你的系统 MSIX / AppX 安装链路还在，可以 PowerShell：


Add-AppxPackage .\Codex-Windows-x64.msix


  1. 如果你是那种 Store 和 AppX 服务都裁得比较狠的系统，那就不一定能正常安装。这种情况下可以把 .msix 改成 .zip，解压里面的 app 目录，然后直接跑 Codex.exe。


本质上 MSIX 也是包，这样做也没什么太大兼容性问题，只是正常系统还是建议走安装流程。


它安全吗


这个项目不修改包、不重打包、不 patch、不破解。


它只从官方来源把安装包下载下来，然后原样发出来。


Windows 来源是 Microsoft Store ProductId：


9PLM9XGG6VKS

macOS 来源是 OpenAI Codex App 的官方静态下载地址：


https://persistent.oaistatic.com/codex-app-prod/Codex.dmg

https://persistent.oaistatic.com/codex-app-prod/Codex-latest-x64.dmg

Release 里会带 SHA256SUMS.txt 和 release-manifest.json，可以自己核对。


咋做到的


这个项目本身逻辑不复杂，主要是把几个下载链路自动化了一下。


macOS 比较简单，对两个官方 DMG 地址做 HEAD，读：


ETag

Last-Modified

Content-Length

如果有变化，就下载新的 DMG。


Windows 稍微麻烦一点。它不是直接保存第三方网站给的链接，而是自己走 Microsoft Store metadata：



  1. 通过 DisplayCatalog 查 ProductId 9PLM9XGG6VKS

  2. 拿到 WuCategoryId

  3. 再请求 FE3 metadata

  4. 从返回的 package metadata 里筛 Windows Desktop x64 对应的 MSIX

  5. 下载微软 CDN 返回的临时包 URL


其实这个实现有一个现成的开源依赖： StoreLib，但是它太老了，就直接让 Codex 自己搓了一个纯 .NET 的解析器，没有依赖第三方 Store helper 包。


自动更新


GitHub Actions 每 15 分钟轮询一次。


每次先轻量 probe，不下载大文件：



  1. Windows：比对当前 MSIX moniker / digest 等稳定字段

  2. macOS：比对 DMG 的 ETag / Last-Modified / Content-Length

  3. 和最新 Release 里的 release-manifest.json 对比


如果没变化，就直接结束，不发重复 Release。


如果发现任意平台有新版本，就下载 Windows + 两个 Mac 包，生成 Checksums，然后发新的 GitHub Release，并同步到 R2。


说完了


最近由于 Codex APP 的一些花式玩法，比如今天看到佬友发布的 原生 codex app 同时支持中转与远端控制 ，也是更加看到了对于历史版本镜像的需求。恰好我这里有，就不偷懒今天把这一弹发出来。


有问题欢迎直接丢 issue，如有帮到也感谢佬友能不吝 Star。


后面还有一些 Codex 周边小工具，整理完继续发。


Codex 实用小工具系列目录


第一弹：【开源】切 provider 避免丢会话：Codex-Threadripper（Codex实用小工具系列第一弹）


第二弹：【开源】逆向 Codex APP ASR 搓了一个语音转写小工具，支持 Whisper 格式（Codex 实用小工具第二弹）


第三弹：【开源】做了一个 Codex App 安装包镜像，解决 Microsoft Store 不好下载的问题（Codex 实用小工具第三弹）

最新回复 (19)
  • 纯真的薯薯 05-16 20:09
    2楼

    太棒了 最新版codex windows版本更新完毕之后历史的对话全部出错,不知道回滚上一个版本有没有用 ^-^

  • Wangnov 楼主 05-16 20:09
    3楼

    现在主要是全面投奔奥特曼了（

    我是叛徒（

  • 纯真的薯薯 05-16 20:15
    4楼



    对话信息看不到而且不能使用 更新前还是正常的 cli和vscode插件也正常,确认就是客户端的问题

  • Wangnov 楼主 05-16 21:06
    5楼

    可以让 codex 直接破掉壳子看看是什么问题

  • ryougishikis 05-18 10:45
    6楼

    windows版本下载后没有登陆选项是什么问题

  • Wangnov 楼主 05-18 11:10
    7楼

    之前有用过 API 吧，把 ~/.codex/config.toml 里的 model_provider="XXX" 注释掉试试

  • Soulanchor 05-19 12:59
    8楼

    支持，派上用场了！！！！！！！！！

  • goatsol 05-19 20:26
    9楼

    我真是吐了，codex app 从旧版更新后一直reconnect，要不就是一直思考中

  • 点赞的暴富 05-19 21:51
    10楼

    感谢分享，claude desktop是不是也有安装文件，之前折腾装过一次，后面就没有更新过

  • ousam 05-20 16:33
    11楼

    感谢楼主，刚困就有枕头 ^-^，前两天用PVE新建了一个window虚拟机，直接网络环境没问题的，就是没办法初始化微软商店，弄了一堆东西都不行

  • 阿祖 05-21 15:36
    12楼

    你是赛博大圣人啊，不亚于人前显圣了

  • hl128k 05-25 10:32
    13楼

    好东西,谢谢大佬,让我尝尝codexapp是什么样的

  • jjj124 05-25 12:58
    14楼

    codex app 怎么能在没有vpn 的环境中登录呢 公司电脑安装不了vpn

  • Wangnov 楼主 05-25 13:09
    15楼

    无解，只能用中转站了，不然登录上了也没啥用

  • jjj124 05-26 10:17
    16楼

    现在问题是登录不上 我Chrome有fq 插件，但是codex 获取到rt 之后，刷新会提示地区不支持

  • kent 05-26 10:55
    17楼

    佬有在server服务器上面测试过吗？2023服务器系统没有store根本没办法用APP版本，现在都在用CLI好难受。

  • Wangnov 楼主 05-26 10:56
    18楼

    没有测试过，可以看 readme 或者本帖里有说，如果实在走不通这个 msix 的安装，让 cdx 帮忙拆掉壳去里面提取 exe 运行就是了，我没有做这一步因为这超过了我声明的不对官方包做修改

  • 好好先生对吧 05-27 16:57
    19楼

    下载了还没开始用 想到了个问题:windows有新版本 下载安装的时候能不能把旧版本替了 还是说会同时存在两个版本

  • Wangnov 楼主 05-27 17:44
    20楼

    目前 Codex APP 的 electron 更新逻辑是能增量就增量更新，不会全量（Windows 我不确认，Mac 的 sparkle 是这样的）。


    就算不增量，它也是走的内置下载，不需要再走我这里的了。我只解决第一棒或者卸载后想重装。


    退一万步说，你用了手动下载离线安装包，也是会覆盖更新的。这个 msix 安装包的安装固定位置是在 ~/WindowsAPP（好像是）， 所以不用担心多版本并存。


    除非你自己把里面的 exe 提出来了，再考虑这个问题。

* 帖子来源Linux.do
附近帖子
返回
飞读
随机推荐