Codex App（ChatGPT 桌面版）国内安装教程（Windows，2026）

先知道两件事

Codex App 是 OpenAI 的 ChatGPT 桌面应用（包名 OpenAI.Codex，Microsoft Store 显示名常为 ChatGPT）。其中的 Codex 是应用内的一种编程助手模式。它的安装源是 Microsoft Store 体系的官方 MSIX，签名完整。国内安装卡点通常是 Store / CDN 下载链路不可达，而不是系统装不了 MSIX。

解决办法：用开源的 Codex App 安装器，拿到官方 MSIX 校验后装上，并顺手写好 API 配置。

安装前准备

Windows 10/11 64 位管理员权限（机器范围安装需要）网络：能访问镜像源或官方源之一即可

用开源安装器安装（全程自动）

安装器项目（GitHub 开源，附源码与构建脚本）：

项目仓库：https://github.com/l1i1/CodexAppInstaller使用说明与下载：https://l1i1.github.io/CodexAppInstaller/

安装器会自动做的事

镜像加速下载：从 GitHub Release 拉取对应架构（x64 / arm64）的官方 MSIX，tag 与资产名动态匹配，自动选对版本SHA256 校验：比对同 Release 的 SHA256SUMS.txt，确认 MSIX 是 Microsoft Store 签名官方包、未重打包静默安装：机器范围预配（所有用户可用） 当前用户注册（可选）API 配置：自动写入 ~/.codex/config.toml 和 ~/.codex/auth.json，桌面端 / CLI / IDE 三端共用创建桌面快捷方式下载缓存：跨重启复用，版本更新后哈希变化自动失效重下

操作步骤

从上面的仓库页下载 CodexAppInstaller.exe双击运行，UAC 弹窗点"是"安装器自动执行：下载 MSIX → 校验 SHA256 → 静默安装 → 配置 API → 创建桌面快捷方式若提示配置 API，按提示填你自己的端点与 Key（不需要可直接跳过）完全退出（含托盘）并重新打开 Codex 桌面应用，开始使用

常用参数

-SkipApi跳过 API 配置-ApiBaseUrl  自定义端点-ApiKey  API Key-ApiModel  模型 ID-SkipChecksum 跳过校验（不建议）-SkipShortcut 不创建桌面快捷方式

验证是否装好

打开 Codex 桌面应用，能进入对话 / Codex 模式界面若配置过 API，检查 ~/.codex/config.toml 内容是否符合预期，Key 在 ~/.codex/auth.json

常见问题

所有下载源都失败？
检查网络/袋里连通性后重试，安装器内置多源回退与自动重试。

401 鉴权失败？
请先检查 ~/.codex/auth.json 中的 Key 是否填写正确，同时确认账户的配额或余额是否充足。

模型列表为空？
核对端点 /v1/models 可用性与模型 ID 是否正确。

配置修改后没有生效？
请先确认已经完全退出托盘进程，同时检查你编辑的是否确实是 %USERPROFILE%.codex 目录下的文件。

注意事项

任何镜像包都必须做 SHA256 校验，安装器已内置；不要使用来源不明的改包需要 Windows 10/11 64 位与管理员权限本教程覆盖安装与本地配置；账号登录、服务可用性与合规由使用者自行处理第三方 API 端点的安全、隐私、费用由使用者自行评估