Codex Windows 安装教程：OpenAI Codex 桌面版下载、winget 失败与代理排查

本文介绍如何在 Windows 上安装 OpenAI Codex 桌面版，并整理 Microsoft Store 下载失败、卡住、服务被禁用、代理不一致等常见问题的排障步骤。

适用范围

• Windows 10 / Windows 11
• 通过 Microsoft Store / winget 安装 OpenAI Codex 桌面版
• 适用于安装时报错、下载卡住、Microsoft Store 无响应、0x803fb017 等场景

官方安装源

Codex 桌面版在 Windows 上通过 Microsoft Store 分发。

官方 Store 包信息：

winget show 9PLM9XGG6VKS --source msstore

正常情况下应看到类似信息：

Name: Codex
Publisher: OpenAI
ProductId: 9PLM9XGG6VKS

注意：

• 9PLM9XGG6VKS 是 OpenAI Codex 桌面版的 Microsoft Store 包 ID。
• OpenAI.Codex 在 winget 源中可能指 Codex CLI，不一定是桌面版 GUI。
• 不建议从第三方网站下载未知来源的 .msixbundle、.appx 或安装包。

正常安装方法

打开 PowerShell，执行：

winget install --exact --id 9PLM9XGG6VKS --source msstore --accept-package-agreements --accept-source-agreements

安装完成后，在开始菜单搜索：

Codex

打开应用后，用 ChatGPT 账号登录即可。

确认是否安装成功

可以执行：

Get-AppxPackage | Where-Object { $_.Name -match 'OpenAI|Codex' } |
  Select-Object Name, PackageFullName, Version, InstallLocation

如果安装成功，通常会看到类似：

Name: OpenAI.Codex
PackageFullName: OpenAI.Codex_<版本号>_x64__2p2nqsd0c76g0
Version: <版本号>

常见问题一：Microsoft Store 报错或 winget 安装失败

可能表现：

0x803fb017
找不到与输入条件匹配的程序包
正在启动程序包安装...
下载卡住
90% 长时间不动

建议按下面顺序排查。

第一步：确认 Store 源可用

执行：

winget source update msstore
winget search Codex --source msstore

正常情况下应能看到：

Codex    9PLM9XGG6VKS    Unknown

如果搜索不到，先检查网络、代理、Microsoft Store 服务状态。

第二步：检查 Store / Windows Update 相关服务

执行：

Get-Service DoSvc,wuauserv,bits,InstallService,AppXSvc,ClipSVC |
  Select-Object Name, Status, StartType

关键服务说明：

DoSvc          Delivery Optimization
wuauserv       Windows Update
bits           Background Intelligent Transfer Service
InstallService Microsoft Store 安装服务
AppXSvc        AppX Deployment Service
ClipSVC        Client License Service

建议确保这些服务没有被禁用，尤其是：

• DoSvc
• wuauserv
• bits
• InstallService

可以尝试启动：

Start-Service DoSvc
Start-Service wuauserv
Start-Service bits
Start-Service InstallService

如果提示权限不足，请使用管理员 PowerShell。

第三步：检查 Windows Update 服务宿主组

检查 wuauserv 配置：

Get-ItemProperty HKLM:\SYSTEM\CurrentControlSet\Services\wuauserv |
  Select-Object Start,ObjectName,ImagePath

正常情况下应类似：

ImagePath: C:\WINDOWS\system32\svchost.exe -k netsvcs -p
ObjectName: LocalSystem

检查 netsvcs 宿主组是否包含 wuauserv：

Get-ItemProperty 'HKLM:\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Svchost' |
  Select-Object -ExpandProperty netsvcs

正常情况下列表里应包含：

wuauserv
BITS
InstallService

如果 wuauserv 不在 netsvcs 中，Windows Update 相关功能可能异常，需要以管理员权限修复。

第四步：检查 Delivery Optimization 和 BITS

查看服务配置：

sc.exe qc DoSvc
sc.exe qc bits
sc.exe query DoSvc
sc.exe query bits

如果 BITS 启动时报：

Access is denied

通常说明服务权限被系统优化工具、更新拦截工具或策略改过。需要恢复服务权限后再安装。

不建议直接删除系统服务或手动删除不确定的注册表项。

第五步：检查 WinHTTP 代理

Microsoft Store、BITS、Windows Update 可能使用 WinHTTP 代理，而不是浏览器代理。

查看 WinHTTP 代理：

netsh winhttp show proxy

查看当前用户代理：

Get-ItemProperty 'HKCU:\Software\Microsoft\Windows\CurrentVersion\Internet Settings' |
  Select-Object ProxyEnable, ProxyServer, AutoConfigURL

如果当前用户代理和 WinHTTP 代理不一致，Microsoft Store 下载可能会卡住。

例如用户代理是：

127.0.0.1:<当前代理端口>

但 WinHTTP 代理指向旧端口：

127.0.0.1:<旧代理端口>

可以在管理员 PowerShell 中执行：

netsh winhttp import proxy source=ie

或者手动设置：

netsh winhttp set proxy 127.0.0.1:<当前代理端口>

如果不使用代理，可以恢复直连：

netsh winhttp reset proxy

第六步：更换代理节点

如果安装已经进入：

正在启动程序包安装...
90%

但长时间不动，通常是 Microsoft Store / Windows Update 下载链路不稳定。

可以尝试：

• 更换代理节点
• 优先选择对 Microsoft CDN 稳定的节点
• 确认代理客户端的系统代理端口没有变化
• 确认 WinHTTP 代理仍然指向当前端口

换节点后重新执行：

winget install --exact --id 9PLM9XGG6VKS --source msstore --accept-package-agreements --accept-source-agreements

查看 AppX 部署日志

如果仍失败，可以查看 AppX 事件日志：

Get-WinEvent -LogName 'Microsoft-Windows-AppXDeploymentServer/Operational' -MaxEvents 50 |
  Where-Object { $_.Message -match 'OpenAI|Codex' } |
  Select-Object TimeCreated, Id, LevelDisplayName, Message

如果日志里能看到类似：

OpenAI.Codex_<版本号>_x64__2p2nqsd0c76g0

说明 Store 已经识别到 Codex 包，问题更可能出在下载、代理、BITS 或部署阶段。

不建议的做法

不建议进行证书绕过。

原因：

• 会降低系统信任链安全性
• 可能导致 Microsoft Store、Windows Update、登录、包签名验证异常
• 后续排障更困难

也不建议使用未知来源的第三方离线安装包。

除非 OpenAI 官方提供独立安装包，否则优先使用 Microsoft Store / winget 安装。

推荐排障顺序

1. 确认官方包可见：

winget show 9PLM9XGG6VKS --source msstore

1. 刷新 Store 源：

winget source update msstore

1. 检查并启动服务：

Get-Service DoSvc,wuauserv,bits,InstallService
Start-Service DoSvc
Start-Service wuauserv
Start-Service bits
Start-Service InstallService

1. 检查 WinHTTP 代理：

netsh winhttp show proxy

1. 同步或修复代理：

netsh winhttp import proxy source=ie

1. 更换稳定代理节点后重试：

winget install --exact --id 9PLM9XGG6VKS --source msstore --accept-package-agreements --accept-source-agreements

参考资料

• OpenAI Codex app 公告：https://openai.com/index/introducing-the-codex-app/
• OpenAI Academy Codex 入门：https://openai.com/academy/codex-how-to-start
• OpenAI Help Center Codex FAQ：https://help.openai.com/en/articles/11369540-codex-in-chatgpt-faq

https://api.deepai.wang/v1