2026 Codex Windows 怎么安装？

先给结论：2026 年优先原生 Windows，需要 Linux 工具链再选 WSL2

只是想在 Windows 上开始使用 Codex，先装 ChatGPT Windows 应用或原生 CLI；项目、依赖和编辑器工作流已经在 Linux 环境时，再选 WSL2。OpenAI 当前 Windows 文档已明确支持原生 PowerShell 与 Windows sandbox，不再要求所有 Windows 用户必须先装 WSL。

官方参考：Windows App、WSL。

Windows App、原生 CLI、WSL2 到底怎么选？

不要只因为某篇旧教程写了“Windows 必须 WSL”就增加一套环境；也不要在 Windows 装一次、WSL 再装一次后，混用同一份 PATH 和配置。两套环境可以并存，但应清楚当前终端和仓库属于哪一侧。

安装前先检查 Windows 版本与工具

OpenAI 当前 Windows sandbox 文档把 Windows 11 列为推荐基线；完整更新的 Windows 10 属于 best effort，实际至少需要 1809 或更新版本提供现代控制台能力。较旧 Windows 10 不推荐。

• Windows 11：官方推荐，适合原生应用、CLI 和 sandbox。
• Windows 10：完整更新且 1809 以上可能可用，但可靠性低于 Windows 11。
• WSL：必须使用 WSL2；WSL1 从 Codex 0.115 起不再受支持。
• winget：用于安装 Windows 应用和常用开发工具；缺失时先更新 Windows Package Manager。
• Git：让 Codex 检查 diff、创建检查点并配合审查流程。

安装或运行脚本前，确认命令来自 OpenAI 官方文档，下载域名为 chatgpt.com 或 Microsoft Store。不要从网盘、群文件或陌生镜像下载所谓“国内特别版 Codex”。

路线一

安装 ChatGPT Windows App

OpenAI 当前提供 Microsoft Store 安装入口，也给出 winget 命令：

winget install --id 9PLM9XGG6VKS -s msstore

安装完成后登录自己的 ChatGPT 账号并添加项目。应用默认使用 Windows 原生 Codex agent，命令运行在 PowerShell；需要 Linux agent 时，可在 Settings 把 agent 切换为 WSL，并重启应用让设置生效。

原生模式应保留 sandbox 与 Ask for approval 边界。Full access 会扩大到项目目录之外，可能造成数据丢失；不要把“少弹一次确认”当成默认安全配置。

路线二

在 PowerShell 安装原生 Codex CLI

OpenAI 当前 CLI 页面提供 Windows 独立安装脚本。在 PowerShell 或 Windows Terminal 运行：

powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

安装完成后重新打开终端，检查版本并进入自己的 Git 项目：

codex --version
cd C:\Users\你的用户名\code\your-project
codex

首次启动时选择 Sign in with ChatGPT 或其他可用的官方认证方式。当前独立安装脚本意味着你不必为了安装 Codex CLI 先从 npm 开始；Node.js、Python、.NET 等仍应按具体项目依赖安装。

官方参考：Codex CLI Quickstart。

路线三

在 WSL2 安装 Codex CLI

先以管理员身份打开 PowerShell 或 Windows Terminal，安装默认 Linux 发行版并进入 WSL：

wsl --install
wsl

首次安装 WSL 后可能需要重启 Windows，并完成 Linux 用户名与密码设置。进入 WSL shell 后，再执行 Linux 侧的官方安装命令：

curl -fsSL https://chatgpt.com/codex/install.sh | sh
codex --version
codex

Windows 与 WSL2 是两个独立环境。在 PowerShell 里安装的 Codex 不会自动出现在 WSL PATH；在 WSL 安装的 Codex 也不会自动成为 Windows 原生命令。你准备在哪个 shell 里工作，就在哪一侧安装。

VS Code、WSL 与项目路径怎么配？

如果选择 WSL2，建议安装 VS Code 的 WSL 扩展，从 WSL shell 进入 Linux home 下的仓库，再打开编辑器：

mkdir -p ~/code && cd ~/code
git clone https://github.com/your/repo.git
cd repo
code .

确认 VS Code 左下角显示 WSL: <distro>，集成终端路径是 /home/… 而不是 C:\…。也可以运行：

echo $WSL_DISTRO_NAME

OpenAI 建议 WSL2 工作流把仓库放在 ~/code 等 Linux home 路径。把大型仓库长期放在 /mnt/c 可能造成更慢的文件 I/O，并增加符号链接、权限和换行差异。需要从 Windows 资源管理器访问时，可使用 \\wsl$\Ubuntu\home\你的用户名。

如果 Codex 图标不显示、面板一直转圈或出现 failed to start codex app-server，不要继续当作 WSL 安装问题处理，转到Codex VS Code / IDE 扩展排查。

安装完成后怎么登录？Plus、Pro 与 API Key 有什么区别？

运行 codex 后可以选择 ChatGPT 登录；也可以在 CLI 使用 API Key。两者的计费与权限不同：

• ChatGPT 登录：使用当前 ChatGPT 套餐、工作区权限和 Codex 用量。
• API Key：由 OpenAI Platform 按标准 API 费率单独计费，不消耗 ChatGPT Plus / Pro 包含的 Codex 用量。
• Codex cloud：需要 ChatGPT 登录，本地 App、CLI 与 IDE 扩展支持 ChatGPT 或 API Key。

查看当前认证方式：

codex login status

如果浏览器成功但终端等待，或出现 401、403、Token exchange failed，转到Codex CLI 登录失败排查。需要比较 Plus、Pro 5x/20x、Credits 与 API，查看Codex 套餐与计费指南。

Windows / WSL 常见错误怎么排？

仍无法判断时运行 codex doctor 生成诊断报告。公开前删除用户名、本地路径、仓库信息和其他敏感内容；绝对不要发送 auth.json、API Key、设备代码或访问令牌。

Codex Windows 安装常见问题

Codex 可以在 Windows 上运行吗？

可以。OpenAI 当前支持 ChatGPT Windows 桌面应用、原生 Windows CLI 和 IDE 扩展，也支持让 Codex 在 WSL2 中运行。Windows 11 是官方推荐基线；较新的完整更新版 Windows 10 属于 best effort 支持。

Codex Windows 原生和 WSL2 怎么选？

一般先选 Windows 原生：适合 PowerShell、Windows 工具链和桌面应用。仓库和开发工具已经在 Linux 环境、依赖 Linux 原生工具，或原生沙箱无法工作时选 WSL2。不要为了跟随教程同时安装两套后混用路径。

Windows 安装 Codex CLI 的官方命令是什么？

OpenAI 当前 Windows 独立安装命令是 powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"。应只从 OpenAI 官方文档复制，并确认脚本域名为 chatgpt.com。

WSL2 安装 Codex CLI 的官方命令是什么？

先在管理员 PowerShell 运行 wsl --install，进入 WSL 后运行 curl -fsSL https://chatgpt.com/codex/install.sh | sh，再运行 codex。Windows 与 WSL 是两个独立环境，安装位置和 PATH 不会自动共用。

Codex 还支持 WSL1 吗？

不支持当前版本。OpenAI 文档说明 WSL1 支持到 Codex 0.114；从 0.115 开始 Linux 沙箱迁移到 bubblewrap，因此应使用 WSL2。

Codex Windows 安装必须先装 Node.js 和 npm 吗？

当前官方已经提供 Windows 和 WSL 的独立安装脚本，因此首次安装 CLI 不必从 npm 开始。Node.js 仍可能是你的项目或 Codex 执行项目任务时需要的开发工具，应按项目实际需求安装。

为什么 VS Code WSL 终端找不到 codex？

通常是只在 Windows 里安装了 Codex，却在 WSL 终端运行，或相反。先用 echo $WSL_DISTRO_NAME 确认当前终端；需要在 WSL 使用时，应在 WSL shell 内单独安装 Codex，并从 WSL 项目目录运行 code .。

为什么 Codex 在 /mnt/c 项目里很慢？

OpenAI 官方建议 WSL2 工作流把仓库放在 Linux home，例如 ~/code/project。/mnt/c 属于 Windows 挂载路径，文件 I/O、符号链接和权限行为可能更慢或更复杂。

Windows 使用 Codex 需要 ChatGPT Plus 或 Pro 吗？

安装客户端本身和登录计费是两件事。使用 ChatGPT 登录时，访问能力取决于当前 ChatGPT 套餐和工作区；也可以使用 API Key 按 OpenAI Platform 标准 API 费率单独计费。

Codex Windows 登录出现 401、403 怎么办？

先运行 codex login status，确认 ChatGPT 或 API Key 登录方式并记录完整错误。401 更接近认证未被接受；403 还可能涉及工作区、组织策略或账号状态。不要复制别人的 auth.json，应按官方 logout、login 或 device auth 流程排查。