安装 Codex 前需要准备什么？

Codex 是面向软件开发工作的 AI 编程代理，可以读取项目、修改代码、执行命令、审查差异，并在获得授权后使用浏览器、技能和插件。Windows 版默认使用 PowerShell 运行本地任务，也可以切换到 WSL2 环境。

安装前建议确认以下事项：

• 电脑运行受支持的 Windows 10 或 Windows 11 版本，并保持系统更新。
• 准备一个可以登录 ChatGPT 的账号。
• 系统已安装 Microsoft App Installer；使用 Winget 时尤其需要。
• 如果要让 Codex 操作 Git 仓库，建议提前安装 Git。
• 如果项目依赖 Node.js、Python 或 .NET，可在安装 Codex 后按项目需要补充。

方法一：通过 OpenAI 官方入口安装 Codex

这是普通用户最省事的安装方式。打开 OpenAI 文档提供的 Windows 官方下载入口，系统会调用 Microsoft 的安装服务下载并安装应用。

1. 点击上面的官方下载链接。
2. 浏览器询问是否打开安装程序时，确认继续。
3. 在 Microsoft 安装界面中选择安装。
4. 安装完成后，从开始菜单启动应用。

官方入口的优点是步骤少、来源清晰，并且后续更新通常更方便。除非商店组件损坏或网络策略限制，否则建议优先使用此方法。

方法二：使用 Winget 命令安装 Codex

不想打开 Microsoft Store 界面，或者需要通过终端完成部署，可以使用 Windows 自带的软件包管理器 Winget。

1. 打开 PowerShell 或 Windows Terminal。
2. 运行以下命令：

winget install Codex -s msstore

其中 -s msstore 表示从 Microsoft Store 软件源查找 Codex。根据系统设置，安装过程中可能要求确认软件源协议或弹出权限提示，按屏幕说明完成即可。

检查 Winget 是否可用

如果系统提示无法识别 winget，先运行：

winget --version

仍然找不到命令时，可在 Microsoft Store 中更新“应用安装程序（App Installer）”，然后重新打开终端。

方法三：下载 Codex 的 MSIX 离线安装包

当 Microsoft Store 无法使用，或者需要把安装包保存到其他电脑时，可以获取 Codex 的 MSIX/MSIXBundle 包。该方法步骤更多，且需要自行核对文件来源和签名，因此只建议作为备选。

1. 查询 Codex 对应的商店包

可使用第三方 Microsoft Store 链接解析页面 store.rg-adguard.net。该网站并非 OpenAI 或 Microsoft 官方网站，使用时不要下载脚本、广告程序或来源不明的可执行文件。

1. 打开解析页面，将左侧类型设为 ProductId。
2. 输入 Codex 的 Microsoft Store 产品 ID：9PLM9XGG6VKS。
3. 右侧通道保持 RP，然后提交查询。

2. 选择正确的文件

结果页通常会列出多个架构、版本和依赖包。重点核对：

• 文件名包含 OpenAI.Codex。
• 扩展名是 .msix 或 .msixbundle。
• Intel/AMD 64 位电脑通常选择 x64；ARM 设备应选择与系统匹配的架构。
• 版本号会随更新变化，不要把教程中的示例版本当成固定版本。

解析页给出的应用包链接通常指向 Microsoft 的内容分发域名。下载前仍应检查域名，安装前应在文件属性的“数字签名”中核对发布者，不要仅凭文件名判断安全性。

3. 使用浏览器或 PowerShell 下载

浏览器无法直接下载时，可以复制实际下载链接，在 PowerShell 中执行：

curl.exe -L "这里替换为复制到的 Microsoft 下载链接" -o Codex.msix

如需确认当前保存目录，可执行：

Get-Location

4. 安装 MSIX 或 MSIXBundle

下载完成后，可以双击安装包并使用“应用安装程序”打开，也可以在 PowerShell 中运行：

Add-AppxPackage -Path ".Codex.msix"

如果下载的是 MSIXBundle，请替换为实际文件名：

Add-AppxPackage -Path ".OpenAI.Codex_x64.msixbundle"

若提示缺少依赖，不要从随机下载站补文件。优先返回官方安装方式，或从同一 Microsoft 软件包结果中核对与系统架构匹配的依赖。

Codex 首次启动与基础设置

1. 登录账号：启动应用后，使用 ChatGPT 账号登录；本地工作也可以选择 API Key，但 API Key 会按 API 用量计费。
2. 选择项目：添加一个本地文件夹或 Git 仓库作为 Codex 的工作目录。
3. 设置权限：初次使用建议选择需要审批的模式，查看命令和文件改动后再允许执行。
4. 选择运行环境：一般 Windows 项目可直接使用 PowerShell；Linux 工具链较多的项目可配置 WSL2，修改后需要重启应用。
5. 安装开发工具：根据项目需要安装 Git、Node.js、Python、.NET SDK 或 GitHub CLI。

例如，可以通过 Winget 安装常用工具：

winget install --id Git.Git
winget install --id OpenJS.NodeJS.LTS
winget install --id Python.Python.3.14
winget install --id GitHub.cli

工具版本应以项目要求为准，不必为了使用 Codex 一次性安装全部开发环境。

安装 Codex 后一定要订阅 ChatGPT Plus 吗？

不一定。根据 OpenAI 当前的套餐说明，Codex 可随多个 ChatGPT 套餐使用，不同套餐的用量、模型和可用能力存在差异。因此，安装 Codex 与购买 Plus 是两个步骤：你可以先安装并登录，再根据实际使用频率决定是否升级。

如果你经常让 Codex处理较大的代码库、连续执行多个开发任务，或者同时需要 ChatGPT 的付费功能与更高使用额度，ChatGPT Plus 会更适合长期使用。

Codex Windows 安装常见问题

Winget 找不到 Codex 怎么办？

先确认命令使用了 Microsoft Store 软件源：winget install Codex -s msstore。如果 Winget 本身不可用，更新 Microsoft App Installer，关闭终端后重新打开。

Add-AppxPackage 提示文件不存在怎么办？

先运行 Get-Location 查看当前目录，再用 Get-ChildItem 检查文件名。路径中包含空格时务必加引号，也可以直接使用安装包的绝对路径。

MSIX 提示架构不兼容怎么办？

在“设置 → 系统 → 系统信息”中查看系统类型。x64 和 ARM64 安装包不能随意混用，重新下载与设备架构匹配的版本。

为什么安装后 Git 功能不可用？

Windows 原生运行模式需要系统能够找到 Git。可以执行 winget install --id Git.Git，安装后重启 Codex。如果项目位于 WSL 文件系统，还要确认 Codex 当前使用的是 Windows 原生代理还是 WSL 代理。

PowerShell 提示禁止运行脚本怎么办？

先确认被阻止的脚本是否可信，再参考 Microsoft 的执行策略文档。常见处理方式是以适当权限运行 Set-ExecutionPolicy -ExecutionPolicy RemoteSigned，但企业设备可能由管理员统一管理，不应绕过组织策略。

ChatGPT Plus 能保证 Codex 永不限量吗？

不能。不同套餐具有不同的使用额度，额度与产品规则也可能调整。购买前应查看 OpenAI 当前套餐说明，并根据自己的任务规模选择。

总结：Windows 安装 Codex 应该选择哪种方法？

最稳妥的路径是先尝试官方入口，其次使用 Winget，最后才使用第三方解析页面查找 MSIX 包。安装完成后，先以受限权限打开一个测试项目，确认登录、终端和 Git 环境正常，再逐步扩大 Codex 的操作范围。