Skip to content

docs: add Windows offline install fallback #21

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
Hiwoniu wants to merge 1 commit into
base: main
Choose a base branch
from
Open

docs: add Windows offline install fallback #21

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
15 changes: 15 additions & 0 deletions docs/guide/01-app-installation.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -31,6 +31,21 @@ description: "Codex 桌面 App 下载与安装教程，说明 macOS、Windows

Windows 用户点击对应的下载按钮，下载完成后运行安装程序，按提示完成安装。

如果点击后微软商店打不开、白屏，或一直卡在「获取」/「正在安装」，可以改用离线安装方式。核心思路是：不走微软商店客户端，直接从微软服务器解析 Codex 安装包，再手动安装。

1. 打开 [store.rg-adguard.net](https://store.rg-adguard.net/)，左侧选择 `ProductId`，输入 Codex 的产品 ID：`9PLM9XGG6VKS`，右侧选择 `RP`，点击对勾解析。
2. 在结果里找到文件名包含 `OpenAI.Codex` 的最新安装包。普通 Windows 电脑通常选 `x64` 架构，后缀可能是 `.msix`、`.msixbundle` 或 `.appxbundle`。
3. 如果浏览器直接点击无法下载，可以右键复制安装包链接，粘贴到浏览器地址栏下载，或在 PowerShell 里用 `curl.exe -L "安装包链接" -o Codex.msix` 下载。
4. 下载完成后双击安装包。如果双击无法安装，在安装包所在目录打开 PowerShell，再执行：

```powershell
Add-AppxPackage -Path ".\Codex.msix"
```

::: warning 安全提醒
这个方法只是绕开微软商店客户端，安装包仍应来自微软下载服务器。如果 PowerShell 提示缺少依赖包，再回到解析结果里下载对应架构的 `Microsoft.VCLibs`、`Microsoft.UI.Xaml` 等依赖包并先安装。不要安装网盘、群文件或不明来源的二次打包文件。
:::


## 登录

Expand Down