Windows 安装 Codex CLI：PowerShell 与项目配置

TL;DR：Windows 安装 Codex CLI 的操作顺序

使用 PowerShell 检查 Node.js 和 npm，安装 Codex CLI，完成登录，再进入项目目录运行一个只读的小任务。安装命令和账号能力可能变化，关键版本信息请回到 OpenAI 官方 Codex 页面 核对。

第一步：用 PowerShell 检查环境

node --version
npm --version
Get-Location

如果 node 或 npm 不存在，先安装 Node.js LTS，关闭并重新打开 PowerShell，再重新检查。不要在多个 Node 版本管理器之间混用全局安装目录。

第二步：安装 Codex CLI

npm install -g @openai/codex
codex --help

如果 PowerShell 提示脚本执行策略或路径问题，先记录完整错误，不要直接关闭安全策略。确认 npm 全局目录已经加入当前用户的 PATH 后，再重新打开终端。

第三步：登录、进入项目并验证

codex login
Set-Location C:\Users\你的用户名\Documents\your-project
codex "只读取项目入口和测试命令，先输出计划，不要修改文件"

建议使用 Git 分支或项目副本进行第一次尝试。完成任务后查看 git diff，再决定是否保留修改。

常见报错与解决

| 现象 | 常见原因 | 解决方向 | | --- | --- | --- | | codex 不是内部或外部命令 | npm 全局目录未加入 PATH | 查看 npm prefix，补充当前用户 PATH | | PowerShell 阻止脚本 | 执行策略或企业策略限制 | 按组织规则处理，不要盲目降低系统安全策略 | | Git 仓库访问失败 | 凭证或仓库权限不足 | 先用 Git 官方命令验证访问，再检查 Codex 授权 | | 命令执行被拒绝 | 项目目录或安全确认 | 选择可写副本，逐条确认需要执行的命令 |

FAQ：Windows 使用 Codex 的关键问题

CMD 和 PowerShell 选哪个？

本指南使用 PowerShell，因为它更适合查看路径、环境变量和项目状态。团队已有统一终端规范时，优先遵循团队规范。

Windows 安装后要重启电脑吗？

通常重新打开终端即可让 PATH 生效。只有系统安装或组织策略明确要求时再重启。

怎么避免 Codex 改错文件？

先要求只读分析和计划，再限定目录、文件和验收命令；修改后检查 git diff 并运行原有测试。