Windows 与环境报错：先分清 Shell、Node、路径和沙箱
采集日期：2026-06-17。复测日期：2026-06-17。
Windows 上的 Codex 问题，经常不是 Codex 本身坏了，而是 Shell、Node、路径、权限、代理、WSL2 或沙箱目录边界没理清。
- 报错先分层：Shell、运行时、项目依赖、网络、权限、Codex 配置。
- 不要看到安装失败就重装全部工具。
- PowerShell、npm、Node、pnpm、WSL2 各自有独立问题。
- 站内错误页从 常见报错库 和 Windows 安装 开始。
| 层级 | 常见现象 | 先看哪里 |
|---|---|---|
| Shell | 脚本无法执行、策略限制 | PowerShell 执行策略 |
| Node / npm | npm 找不到、版本不对 | npm 命令找不到 |
| 项目依赖 | install 或 build 失败 | 安装命令报错 |
| 权限和沙箱 | 读不到目录、写不了文件 | 权限、沙箱和审批 |
| 网络代理 | 拉包失败、登录失败 | 先区分代理、DNS、公司网络 |
| WSL2 / Windows 原生 | 路径混用、依赖装错环境 | 先选定一个运行环境 |
Windows 原生和 WSL2 不要混用
Section titled “Windows 原生和 WSL2 不要混用”新手常见问题是：在 Windows 原生装了一套 Node，又在 WSL2 里跑项目；或者在 WSL2 路径里用 Windows 工具写文件。两边都能工作，但不要在一个任务里反复切换。
判断原则：
- 项目在哪个环境安装依赖，就在哪个环境运行。
- Codex 从哪个目录启动，就让它读同一个环境下的项目。
- 报错里出现路径时，先判断它是 Windows 路径还是 Linux 路径。
什么时候暂停
Section titled “什么时候暂停”这些情况不要让 Agent 继续试命令：
- 它准备删除大目录。
- 它准备全局修改执行策略。
- 它准备安装不明来源脚本。
- 它准备修改系统环境变量但说不清影响。
- 它反复尝试同一类命令，错误没有变。
这时应该让 Codex 先总结已尝试步骤、当前错误文本、下一步假设。
- 安装入口：读 Codex 安装与访问。
- Windows 页面：读 Windows 安装。
- 错误库：读 常见报错库。
- 安全边界：读 安全安装指令。
- 官方入口：OpenAI Codex Windows。
- 站内关联：Windows 安装、常见报错库。
- 分享日期：2026-06-17。
- 复测日期：2026-06-17。