Codex 是 OpenAI 推出的 AI 编码代理。对于 Windows 10/11 用户，最干净、最省心的安装方式就是使用系统自带的包管理器 winget 。本文将介绍如何用 winget 完成安装、验证以及日常更新。

1. 前提条件

• Windows 10 1809 或更高版本 / Windows 11
• 确保 winget 可用（打开 PowerShell 输入 winget，有帮助信息即表示正常）

2. 安装 Codex

以管理员身份打开 PowerShell，然后执行：

powershell

winget install OpenAI.Codex

系统会自动：

• 从官方源下载最新的 Codex 安装包
• 静默完成安装
• 将 codex 命令自动添加到系统 PATH （安装路径C:\Users\你的用户AppData\Local\Microsoft\WinGet\Packages）

安装完成后，关闭并重新打开 PowerShell（或重新加载环境变量），输入以下命令验证：

powershell

codex --version

如果正常输出版本号（例如 1.0.0 等），说明安装成功。

3. 首次登录与使用

安装成功后，直接在终端输入 codex 并回车，程序会提示你通过浏览器登录 ChatGPT 账号。
完成授权后，你就可以在终端里使用 Codex 进行 AI 辅助编码了。

4. 如何更新 Codex

winget 最大的好处之一就是更新极其简单。要升级到最新版本的 Codex，只需在 PowerShell 中执行：

powershell

winget upgrade OpenAI.Codex

该命令会自动检测是否有新版本，如果有则下载并覆盖安装，保留你的所有配置和登录状态。

💡 小技巧：你也可以一次性更新所有通过 winget 安装的软件：
winget upgrade --all

5. 卸载（如果需要）

如果你想彻底移除 Codex，使用 winget 同样干净利落：

powershell

winget uninstall OpenAI.Codex

执行后 Codex 及其命令行入口会被完全删除。

6. 常见问题

Q：提示“未找到可用软件包”怎么办？
A：请先运行 winget source update 更新软件源，然后再试。

Q：安装后 codex 命令仍找不到？
A：关闭当前 PowerShell 窗口，重新以管理员身份打开一个新窗口；或者手动重启 explorer.exe 刷新 PATH。

Q：winget 安装的 Codex 和 npm 安装的会冲突吗？
A：强烈建议先卸载 npm 版本（npm uninstall -g @openai/codex），再使用 winget 安装，避免命令冲突。

总结

使用 winget 管理 Codex，无需关注下载地址、环境变量，升级也只需一条命令，非常适合 Windows 用户长期使用。

其他方法

手动下载安装包

1. 访问发布页面 ：打开 OpenAI Codex 在 GitHub 上的 Releases 页面：https://github.com/openai/codex/releases/latest。
2. 选择正确文件 ：根据你的操作系统和 CPU 架构，下载对应的压缩包文件：
   • Windows x64 (主流) ：下载 codex-x86_64-pc-windows-msvc.zip
   • Windows ARM64 (如骁龙本) ：下载 codex-aarch64-pc-windows-msvc.zip
   • macOS (Apple Silicon) ：下载 codex-aarch64-apple-darwin.tar.gz
   • macOS (Intel) ：下载 codex-x86_64-apple-darwin.tar.gz
   • Linux (x64) ：下载 codex-x86_64-unknown-linux-musl.tar.gz
3. 解压文件 ：将下载的压缩包解压到一个你 专门存放命令行工具的文件夹 ，例如 D:\Tools\Codex 或 C:\Users\你的用户名\bin。
4. 简化文件名 ：解压后，你会看到一个带有平台后缀的可执行文件（例如 codex-x86_64-pc-windows-msvc.exe）。为了方便使用，可以把它重命名为 codex.exe。

⚙️ 配置环境变量 (PATH)

为了让系统在任何地方都能找到 codex 命令，需要把它的所在目录添加到 PATH 环境变量里。

• 图形界面操作（推荐） ：
  1. 在 Windows 搜索框输入“ 环境变量 ”，选择“ 编辑系统环境变量 ”。
  2. 在“系统属性”窗口中，点击“ 环境变量 ”。
  3. 在“用户变量”区域，找到并选中 Path ，然后点击“ 编辑 ”。
  4. 点击“ 新建 ”，然后粘贴你存放 codex.exe 的文件夹路径（例如 D:\Tools\Codex），最后点击“ 确定 ”保存。
• 通过命令行快速添加 ：
  你可以在以管理员身份运行的 PowerShell 或 CMD 中，使用 setx 命令添加。以下命令示例中，请将 D:\Tools\Codex 替换成你实际的路径。
  bash

setx /M PATH "%PATH%;D:\Tools\Codex"

🚀 验证安装和更新方法

完成上述步骤后，重新打开一个命令行窗口，输入 codex --version，如果能看到版本号，就说明安装成功了。

后续需要更新时，可以定期访问 GitHub Releases 页面，下载新版压缩包，或者直接运行下面的自动更新命令：

bash

codex --upgrade

执行后它会自动检查并下载更新。