我先查 Codex 在 Windows 上的官方安装方式和 2026 年最新变化。
Codex 的 Windows 桌面版是 2026 年 3 月 4 日正式上线的，官方只通过微软商店分发，没有独立的 exe 安装包，所以 “下载安装包” 这个思路本身就走偏了。正确的安装方式有三条：微软商店页面直接装、winget install --id 9PLM9XGG6VKS -s msstore、或者干脆不装桌面版、改用官方 CLI。这里有个很多人踩过的坑必须提前说：网上不少教程让你执行 winget install Codex -s msstore，这条命令在微软商店里匹配到的是一个叫 “Codex - QR Reader & Generator” 的二维码工具，发布者是 IYIA，不是 OpenAI 的产品 ——OpenAI 官方文档一度写错，后来在开发者社区更正为必须带 --id 9PLM9XGG6VKS。装错了不只是白装，还真有安全风险，因为你是照着官方文档敲的命令，很容易不看发布者就直接确认。另外，网上流传的 “提取版 MSIX 安装包”“网盘下载” 不建议用：来源无法校验、没有自动更新、签名是否被改过你也不知道。
先分清三个东西，别装错
| 名称 | 是什么 | 官方获取方式 | 适合谁 |
|---|---|---|---|
| Codex 桌面 App | 图形化工作台，多 agent 并行、看 diff、管长任务，带 Windows 原生沙箱 | 微软商店（ID：9PLM9XGG6VKS） | 不想敲命令、要图形界面的人 |
| Codex CLI | 终端里的编码 agent，功能最全，能接 CI/CD | npm install -g @openai/codex 或 GitHub Releases 二进制 | 开发者、自动化场景 |
| Codex IDE 扩展 | VS Code 里的 Codex | VS Code 扩展市场搜 OpenAI Codex | 已经在用 VS Code 的人 |
桌面版和 CLI 不是二选一，可以同时装，登录同一个 ChatGPT 账号即可。
官方安装：三条路，按这个顺序试
| 方式 | 具体操作 | 优点 | 限制 |
|---|---|---|---|
| 微软商店页面 | 打开 apps.microsoft.com/detail/9PLM9XGG6VKS，点 “获取 / 安装” | 最稳，自动更新 | 商店本身要能打开、账号地区要匹配 |
| winget 指定 ID | winget install --id 9PLM9XGG6VKS -s msstore | 可脚本化、可批量部署 | 依赖 msstore 源和商店服务 |
| 官方 CLI | npm i -g @openai/codex，或从 GitHub Releases 下 exe | 不受商店地区限制，功能最全 | 需要 Node 环境或手动配 PATH |
系统要求按商店页面口径：Windows 10（建议 19041 及以上）或 Windows 11，官方推荐 Windows 11；需要联网，首次启动要登录。企业设备如果由 IT 统一管理，管理员需要通过 MDM 部署已批准的版本，个人绕不过去。
商店打不开、地区不可用：按这个顺序排查
| 现象 | 常见原因 | 处理办法 |
|---|---|---|
| 搜 Codex 出来一堆奇怪应用 | 关键词太泛，商店里有同名工具 | 认 ID：9PLM9XGG6VKS，或直接开商店页面链接 |
| 点安装没反应、一直转圈 | 商店缓存坏了 | 运行 wsreset.exe，清缓存后重开商店 |
| 提示 “此应用在你的地区不可用” | 账号地区与商店地区不一致 | 核对账号地区；不想折腾地区就走 CLI 路线 |
| 商店打不开、报 0x80131500 之类 | 网络、DNS、代理拦截 | 换网络、关掉系统代理再试，或改用手机热点 |
| 公司电脑商店被禁用 | 组策略 / Intune 关闭了 Store | 找 IT 走 MDM 部署，别自己改策略 |
| 装完打不开，提示权限错误 | 首次启动要建本地目录 | 右键 “以管理员身份运行” 一次，之后正常打开 |
商店修复的两条常用命令，按需使用：
wsreset.exe
Get-AppxPackage -allusers Microsoft.WindowsStore | Foreach {Add-AppxPackage -DisableDevelopmentMode -Register "$($_.InstallLocation)\AppXManifest.xml"}
第二条是重新注册商店应用，执行完重启一次。如果商店整体被 IT 禁用，这两条也没用，直接走 CLI。
装完第一次启动就报错：三个高频问题
用户名带中文或非 ASCII 字符。 这是社区里反馈最多的一类：应用启动时要在 C:\Users\你的用户名\.codex\sqlite 建本地库，路径里有中文、日文、带重音字母就会失败。三个办法，按成本从低到高：
- 设环境变量，把 Codex 的数据目录指到纯英文路径：
setx CODEX_HOME "C:\CodexHome"
- 首次右键 “以管理员身份运行”，让它把目录建完，之后正常启动；
- 新建一个纯英文用户名的本地账户，专门跑 Codex。
报 0x8007177E 或类似加密 / 权限错误。 网上有教程让你执行 fsutil behavior set disableencryption 0，这条不建议照做 —— 它改的是系统级加密行为，为了装一个应用去动系统安全设置，代价不对等。正确顺序是：确认安装目录有写权限、以管理员运行一次、检查杀毒软件是否拦截了沙箱进程，再不行就卸载重装。
终端里 codex 命令找不到。 两种原因：没全局安装，或者 npm 的 bin 目录没进 PATH。先 npm ls -g @openai/codex 确认装没装，再 npm config get prefix 看路径，把那个路径下的 bin 加进 PATH，重开终端。
还有一个官方文档里写明的坑：在 Windows 桌面版里，如果 Codex 打开了网页却控制不了标签页，并提示 “Trusted RPC dependency” 错误，别去删自带的浏览器文件，新建一个 Codex 会话重试就行。
不想碰商店：CLI 路线怎么走
前置只有一个：Node.js 22 及以上（node -v 看版本，不够就 winget install OpenJS.NodeJS.LTS）。
npm install -g @openai/codex
codex --version
codex auth login
登录方式二选一：codex auth login 走 ChatGPT 账号，或者设环境变量 $env:OPENAI_API_KEY = "sk-..." 走 API Key。想免 Node 环境，就去 GitHub Releases 下 codex-x86_64-pc-windows-msvc.exe，解压后把目录加进 PATH；Release 页有 SHA256，下载后建议核对一遍再运行。
装完建议先配沙箱，别一上来就给全权限。配置文件在 %CODEX_HOME%\config.toml（默认是 C:\Users\你\.codex\config.toml）：
[windows]
sandbox = "elevated"
elevated 是独立低权限沙箱用户 + 防火墙规则 + ACL 边界，属于推荐档；企业策略不允许时才退回 unelevated。如果命令因为读不到目录失败，用 /sandbox-add-read-dir C:\你的项目绝对路径 单独授权，不要直接把沙箱关掉。
| 对比项 | 桌面 App | CLI |
|---|---|---|
| 上手难度 | 低，图形界面 | 中，要记命令 |
| 多 agent 并行 | 原生支持，按项目 / 线程组织 | 支持，配合 Git Worktree |
| 自动化 / CI | 不适合 | 适合，支持非交互输出 |
| 更新方式 | 商店自动更新 | npm 升级或手动换二进制 |
| 地区限制 | 受商店地区影响 | 基本不受 |
账号与套餐：先确认你有没有资格
Codex 已经包含在 ChatGPT 各档套餐里，包括 Free 和 Go；Codex Cloud 只对符合条件的 Plus、各档 Pro、Business、Enterprise、Healthcare、Education 开放，还要看工作区设置。桌面版登录时如果要求手机验证，按提示做完即可。企业工作区如果没开本地 Codex 权限，个人怎么装都用不了，这一步只能找管理员。
五个别踩的坑
- winget install Codex -s msstore 是错的。 会装成 IYIA 的二维码工具，认准 --id 9PLM9XGG6VKS。
- 第三方网盘的 “提取版 MSIX” 别用。 微软商店只是分发渠道，但提取包绕过了商店的签名与更新机制，来源不可控；真装不上就走 CLI。
- 别为了修安装错误去改系统加密设置。 fsutil 那条命令影响面太大，不值得。
- 别用中文用户名硬扛。 首启失败大多是这个原因，改 CODEX_HOME 最省事。
- 别关杀毒软件 “解决” 安装失败。 先看拦截日志、加白名单，实在不行再找 IT，不要整机裸奔。
说到底，Codex 在 Windows 上的分发方式就一句话：桌面版认商店 ID，CLI 认 npm 包名和 GitHub Release。卡在商店是环境问题，不是软件问题，按 “清缓存 → 查网络 → 查地区 → 查策略” 的顺序排，排不掉就换 CLI，不要把时间花在找所谓的 “官方安装包” 上 —— 官方根本没提供那个东西。
【常见问题】
问题 1：Codex Windows 版有独立的 exe 安装包可以下载吗？
回答 1：桌面版没有官方 exe，只通过微软商店分发，安装 ID 是 9PLM9XGG6VKS；CLI 才有独立二进制，可从 GitHub Releases 下载 codex-x86_64-pc-windows-msvc.exe。所以找 “Codex Windows 版安装包” 时，认准这两条官方渠道，别用网盘提取包。
问题 2：执行 winget install Codex 为什么装出来是二维码工具？
回答 2：因为 Codex 这个关键词在微软商店里匹配到了 IYIA 发布的 “Codex - QR Reader & Generator”，不是 OpenAI 的应用。安装 Codex Windows 版必须带 ID：winget install --id 9PLM9XGG6VKS -s msstore，这是官方后来更正的写法。
问题 3：微软商店打不开或提示地区不可用，还能装 Codex Windows 版吗？
回答 3：能。先试 wsreset.exe 清商店缓存、检查网络和账号地区；如果商店被公司策略禁用，就走 CLI 路线：装 Node.js 22+ 后执行 npm install -g @openai/codex。Codex Windows 版的 CLI 不受商店地区限制，功能也最全。
问题 4：Codex Windows 版装完打不开、报路径错误怎么办？
回答 4：大概率是用户名含中文或非 ASCII 字符。设 setx CODEX_HOME "C:\CodexHome" 把数据目录指到英文路径，或首次以管理员身份运行，再不行就新建一个英文用户名账户。Codex Windows 版的首次启动会在用户目录建本地数据库，路径不合法就会直接失败。
【参考资料】
[2026-11-13]（2026 年最新 Codex windows 版安装包下载和安装教程（Windows 无法微软商店下载解决方法））阿里云开发者社区
[2026-11-05]（Using Codex with your ChatGPT plan）OpenAI Help Center
[2026-09-24]（Official Codex app installation command resolves to an unrelated third-party app）OpenAI Developer Community
[2026-09-03]（Codex with Azure OpenAI in Microsoft Foundry Models）Microsoft Learn
[2026-08-19]（winget install 命令）Microsoft Learn
[2026-08-16]（Codex 安装使用全攻略：从环境准备到高阶技巧（2026 全平台版））CSDN
[2026-06-19]（The Codex app is now on Windows）OpenAI Developer Community
[2026-06-16]（2026 最新版 OpenAI Codex 桌面端安装指南：Win 和 Mac 全流程详解）稀土掘金
[2026-06-03]（别手搓多 Agent 了！Codex Windows 版用 Git Worktree 并行跑代码）稀土掘金
[2026-03-04]（Codex app 正式登陆 Windows）OpenAI Developer Community
免责声明： 本文依据 OpenAI 官方帮助文档、开发者社区公告与公开教程整理，应用 ID、系统要求、套餐权益和命令可能随版本更新而变化，请以微软商店页面、OpenAI 官方文档和 npm 最新版本为准；文中对第三方安装包的风险提示为一般性安全建议，不构成对任何具体文件的安全性背书，下载软件请优先使用官方渠道。