Codex Windows 故障排查：沙箱、WSL 和常见权限错误

适用场景

这篇手册适合 Windows 用户排查 Codex 的沙箱、WSL、VS Code 集成和权限问题。

OpenAI 官方 Windows 文档说明，Windows 默认应优先使用 native sandbox；WSL2 适合需要 Linux-native 工具或工作流本来就在 WSL 的场景。

步骤 1：先确认你使用的是哪种环境

你可能在三种环境里使用 Codex：

• Windows native。
• WSL2。
• VS Code Remote WSL。

先确认路径：

pwd

如果在 WSL 中，路径通常类似：

/home/your-name/code/project

如果路径是 /mnt/c/...，性能可能比 WSL home 目录慢。

步骤 2：native sandbox 失败时怎么处理

如果 native sandbox setup 失败，官方文档列出的常见原因包括：管理员提示被拒绝、企业策略禁止本地用户或组创建、防火墙规则变更被阻止、或 sandbox 用户需要的登录权限被阻止。

可以按这个顺序处理：

1. 如果环境允许，重新运行 setup 并批准管理员提示。
2. 如果是公司电脑，询问 IT 是否允许本地用户/组创建、防火墙配置和 sandbox 用户登录权限。
3. 如果暂时无法修复，使用 unelevated sandbox 继续工作。

unelevated sandbox 能继续提供一定隔离，但不是长期企业环境的最佳配置。

步骤 3：遇到 Windows error 1385

如果 sandboxed commands 失败并出现 error 1385，通常是 Windows policy 阻止 sandbox 用户以所需登录类型启动命令。

排查方向：

• sandbox 用户是否创建成功。
• 组策略是否允许这些用户运行 sandboxed commands。
• 企业安全策略是否阻止该登录类型。

这类问题通常需要 IT 或管理员介入。

步骤 4：需要 Linux 工具时使用 WSL2

如果你的工具链依赖 Linux，安装 WSL2：

wsl --install

进入 WSL 后安装 Codex：

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

项目建议放在 WSL home 目录：

mkdir -p ~/code
cd ~/code

避免长期在 /mnt/c/... 下开发大型仓库。

步骤 5：VS Code WSL 找不到 codex

如果 VS Code WSL 终端里找不到 Codex，先确认：

which codex || echo "codex not found"

如果找不到，说明 Codex 没有安装到 WSL 的 PATH 里，需要在 WSL shell 中重新安装，而不是只在 Windows native 环境安装。

常见错误

不要把 Windows native 和 WSL2 的安装混为一谈。它们是不同环境。

不要把大型仓库放在 /mnt/c 下长期开发，容易慢，也更容易遇到权限和符号链接问题。

不要看到 sandbox setup 失败就直接长期关闭沙箱。先判断能否用 unelevated fallback，并和 IT 处理根因。

小结

Windows 上排查 Codex 问题，先确认环境：native 还是 WSL2。native 优先检查 sandbox setup、管理员权限和企业策略；WSL2 优先检查路径、PATH 和 VS Code 是否真的连接到 WSL。