Codex Windows 安装教程：PowerShell、npm、PATH 与登录排查
在 Windows 上装 Codex，通常不需要先装 WSL2。普通用户用 PowerShell 官方安装器或 npm 就能装好命令行版（CLI）。只有要从源码构建、项目依赖 Linux 工具链时，才需要 WSL2。
先选对路线#
「Codex 下载」可能指不同的东西：
| 路线 | 适合谁 |
|---|---|
| CLI（命令行） | 想让 Codex 读本地项目、改文件、跑测试 |
| 桌面 App | 不喜欢终端，要图形界面 |
| IDE 扩展 | 已经固定用 VS Code、Cursor 等编辑器 |
| 网页版 | 只想先体验，不装任何东西 |
它们的区别见 Codex 网页版、App、CLI 和 IDE 扩展有什么区别。下面讲 CLI 的安装。
安装前检查#
在 PowerShell 里依次运行：
winget --version
node --version
npm --version
git --version不要求全都存在，但注意几点：
- 用 npm 方式需要 Node.js 和 npm，建议用仍在维护的 LTS 版本。
- Git 不是必须的，但看 Diff、回滚时非常有用。
- 第一次试用不要选生产目录，复制一个没有敏感信息的小项目。
- 公司代码能不能发给外部 AI 服务，先按公司制度来。
- 只从官方入口、官方包名和系统包管理器安装，不要运行群里「改过的脚本」。
方法一：官方 PowerShell 安装器#
按官方文档当前给出的命令执行：
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"装完关掉窗口重新打开，再验证：
codex --version
codex --help提示脚本被阻止时，只对当前这个窗口临时放开：
Set-ExecutionPolicy -Scope Process Bypass这种命令会下载并执行远程内容，运行前确认域名拼写是 chatgpt.com。公司电脑先问管理员。安装地址以官方文档为准，别把某一次的下载链接当永久地址。
方法二：npm 安装#
已有 Node.js 的话：
npm install -g @openai/codex
codex --version出现权限或目录错误，别反复用管理员身份硬装，先看 npm 的全局目录和 Node 版本：
npm config get prefix
node --version
where.exe node
where.exe npm
where.exe codex最常见的坑是装的时候用了一个 Node，运行时 PATH 指向另一个。如果 npm install 成功但 codex 不是命令，通常是 npm 的全局目录没加进用户 PATH：把 npm config get prefix 显示的目录追加到用户环境变量（不要整段覆盖），重启终端再试。
WSL2 什么时候才需要#
- 项目脚本依赖 Bash、Linux 命令或 Linux 权限模型；
- 要按官方源码文档自己编译；
- Windows 原生环境和项目工具链不兼容；
- 团队统一在 Ubuntu 等 Linux 环境开发。
只是装预编译的 CLI、分析普通项目，走 PowerShell 或 npm 更直接。
第一次登录#
装好后运行 codex，选 Sign in with ChatGPT，按浏览器提示完成。ChatGPT 账号、OpenAI API Key、第三方平台令牌是三套不同的凭据，不能互相替代。
浏览器授权后回不到终端时：
- 确认地址栏仍是官方域名；
- 暂时关掉会拦截 localhost 回调的浏览器扩展；
- 检查系统时间、代理和防火墙；
- 关掉旧的 Codex 进程，重新执行
codex login； - 在没有浏览器的机器上，看版本是否支持
codex login --device-auth。
详细分层排查见 Codex 登录失败 token_exchange_failed 怎么办。查看状态和退出：
codex login status
codex logoutCodex 支持自定义接口。用 CC Switch 一键导入最省事，见 快速开始；手动配置见 Codex config.toml 怎么配置。
装好后先做的低风险检查#
进入练习项目：
cd C:\path\to\demo-project
git status
codex --version先给一个只读任务：
只读分析当前项目，不要修改文件、安装依赖或联网。
请说明项目语言、框架、入口文件、测试命令和 Git 状态，并把已确认的事实和推测分开。输出没问题，再授权一个小范围修改。
Windows 常见问题速查#
| 现象 | 常见原因 | 排查顺序 |
|---|---|---|
codex 不是命令 | PATH 没刷新，或安装目录不在 PATH 里 | 重启终端 → where.exe codex → 查 npm prefix |
| PowerShell 脚本被阻止 | 执行策略限制 | 只对当前窗口 Set-ExecutionPolicy -Scope Process Bypass |
| npm 权限错误 | 全局目录归属别的用户，或 Node 版本混乱 | 查 prefix 和 Node 路径，别盲目用管理员 |
| 登录后卡在 localhost | 回调被扩展、代理或防火墙拦截 | 换浏览器，重试 codex login |
| 401 / 403 | 凭据或账号资格问题 | codex login status → 重新登录 → 看账号页面 |
| 任务很快用完额度 | 模型、上下文、工具和任务复杂度不同 | 在用量页或 /status 里看实时状态 |
常见问题#
一定要用 WSL2 吗？#
不一定。官方提供 PowerShell 安装器和 npm 两条原生路线，WSL2 只在需要 Linux 环境时再用。
PowerShell 和 npm 选哪个？#
没有统一答案。PowerShell 安装器步骤少、不用单独管 Node；npm 适合已经用 Node 版本管理器的开发者。
codex --version 没输出？#
先重开终端，运行 where.exe codex 和 Get-Command codex -All。找不到路径，就检查是否真的安装成功，以及安装目录是否在 PATH 里。
ChatGPT 订阅能当 API Key 用吗？#
不能。两者登录、计费和权限都是分开的。