正常安装 OpenAI Codex 桌面客户端时，Windows 平台依赖 Microsoft Store 分发 MSIX 安装包，macOS 依赖 OpenAI 官方海外下载地址。

国内使用极易出现下载中断、商店打不开、GitHub 访问缓慢等问题。

本文依托开源镜像项目 codex-app-mirror，提供无需商店、稳定高速的离线安装方案，镜像仅同步官方原版安装包。

有一点需要注意：

适于合法拥有 OpenAI 使用权限、仅下载链路受阻的用户。

一、codex-app-mirror项目核心说明

1. 工作原理

该项目是官方安装包同步镜像仓库，核心运行逻辑为 GitHub Actions 定时自动拉取官始安装文件，全程不篡改程序本体。

- 每15分钟自动轮询上游官方分发地址；

- Windows端读取微软商店产品元数据，macOS端探测官方DMG文件指纹；

- 版本发生更新时自动下载完整安装包，生成SHA256校验文件与版本元数据；

- 同步发布至GitHub Releases，搭建国内 S3 静态镜像加速下载。

2. 明确不提供的功能

- 不破解 Codex 登录授权、不绕过 OpenAI 账号验证；

- 不修改、重打包、二次编译官方安装包；

- 不替代微软商店、OpenAI 官网等官方分发渠道；

- 无法绕过企业/学校设备系统安全策略（如禁止 MSIX 安装、外部软件拦截）。

二、下载渠道

提供两类下载源，海外网络环境优先 GitHub Releases，国内网络环境优先 S3 副镜像，副镜像仅保留最新版本，历史安装包需前往 GitHub 仓库获取。

1. GitHub Release

官方 GitHub Release地址：

https://github.com/Wangnov/codex-app-mirror/releases/latest

版本会不断更新，在对应的版本页面显示官方发布时间和镜像发布时间。

2. 国内 S3 副镜像

三、安装方式

1. Windows安装

Windows 用户下载的是.Msix文件，下载完成后双击安装。如果系统里的 App Installer 正常，通常会弹出安装界面，确认后自动安装。

如果双击没有反应，可以尝试用 PowerShell 安装：

Add-AppxPackage -Path "E:\codex\OpenAI.Codex_26.623.19656.0_x64__2p2nqsd0c76g0.Msix"

把路径改成你文件实际存放的位置，安装成功后，可以在开始菜单搜索codex 。

2. macOS 安装方式

macOS 用户下载的是.dmg文件，不同芯片选择不同版本：

不确定自己的 Mac 是什么芯片，可以点左上角苹果菜单，进入“关于本机”查看芯片信息。

- 下载完成后双击打开；

- 将 Codex.app 拖到 Applications/ “应用程序”目录；

- 从 Launchpad 或应用程序目录启动 Codex。

如果 macOS 提示应用来自互联网，属于常见的 Gatekeeper 提醒，可以在“系统设置 - 隐私与安全性”里确认是否允许打开。

四、文件校验

codex-app-mirror每个 Release 都会提供SHA256SUMS.txt。建议你下载安装包后，同时下载校验和文件，对照 SHA256。

打开PowerShell运行：

Get-FileHash -Algorithm SHA256 "E:\codex\OpenAI.Codex_26.623.19656.0_x64__2p2nqsd0c76g0.Msix"

会返回如下结果

将输出的Hsah与SHA256SUMS.txt里的值进行比对，正常情况下两边的值一致。

在终端里运行：

shasum -a 256 ~/Downloads/Codex-mac-arm64.dmg

Intel版本命令换成：

shasum -a 256 ~/Downloads/Codex-mac-x64.dmg

下载链路可能经过浏览器、代理、镜像、断点续传、网络缓存等多个环节，Hash校验至少可以确认文件是否损坏、有没有被替换。校验不是万能安全保证，但它是使用镜像安装包时应该做的最低限度检查。

写在最后

codex-app-mirror解决了官方分发渠道下载链路受阻的痛点，不改变软件本身、不绕过账号与设备安全限制。通过此方法获得安装包进行安装前，Hash校验是保障文件安全的最低标准，切勿跳过校验步骤直接安装。

👆👆tips：亲爱的读者朋友，由于微信的推送规则，即使你关注了我，可能也常常收不到推送，记得点击“松语AI志名片，设为星标⭐️，文章会自动推送哦！