33 · Windows 使用指南：原生环境与 WSL

Codex 在 Windows 原生沙箱、PowerShell 和 WSL 中的安装、路径、权限与常见错误，帮你选择更稳定的运行方式。

Windows 用户用 Codex，有个绕不开的选择题：用原生环境，还是用 WSL（Linux 子系统）。这一篇帮你把两边的情况摸清。

「原生环境」是指在 Windows 的 PowerShell 里直接跑。好处是简单直接，不需要额外装子系统；坏处是有些 Linux 生态的工具、脚本，在原生 Windows 上会水土不服。

「WSL」则是在 Windows 里跑一个 Linux 子系统，然后在里面用 Codex。好处是环境更接近 Linux，兼容性更好，很多开发者的工作流本来就在 Linux 上，WSL 更顺；代价是要先装好、配好 WSL。

「路径」是个常见的坑：Windows 原生和 WSL 的文件系统是隔离的，路径写法不同，两边切换时容易搞混文件到底在哪。

「权限」也有差异：Windows 原生的沙箱和 WSL 里的沙箱，行为不完全一样，报错时别拿一个环境的经验套另一个。

「常见错误」里，网络问题、权限问题、路径问题占了大多数，前面安装篇已经提过一部分。

给你的建议是：如果你平时开发就在 Windows 原生，那先用原生环境，简单；如果你本来就常用 WSL、或者要跑很多 Linux 工具，那用 WSL 更稳。没有绝对的好坏，只有「哪个更贴近你的现有工作流」。

选好之后，就把自己固定在那个环境里用，别两边乱切，否则路径和权限的坑会反复咬你。

一个自查清单：当你读完这一篇时，可以问自己三个问题——它解决的是什么具体问题？我当前的工作/学习里有没有这个场景？下一步我该学哪一篇？把这三个问题答清楚，你就知道自己有没有真正吃透。

五分钟练习：① 找一个一分钟能完成的代码任务 ② 用这一篇的方法描述给 Codex ③ 看它执行时有没有触发你刚学的那个机制 ④ 验证结果是否符合预期。这一轮做下来，你对这一篇的理解会深 3 倍。

延伸阅读：学完这一篇，你可以看本组里的下一篇，把相邻的概念连起来读；也可以跳到更后面的组学 MCP、子代理、Skills 这些更深的能力。知识是网状的，多跳几篇会理解更深。

一页速览：如果只能记三件事，① {一}。② {二}。③ {三}。其他细节以后需要再翻这一篇查。