开始之前：确认是 WSL2
在 PowerShell 中运行：
wsl -l -vVERSION 列必须显示 2。如果显示 1，请用 wsl --set-version <DistroName> 2 转换该发行版。OpenAI 的文档说明 WSL1 只支持到 Codex 0.114。参见 WSL1 错误。
方式 A：桌面应用，智能体运行在 WSL 中
- 在 ChatGPT 桌面应用中打开 Settings（设置）。
- 将智能体从 Windows native（Windows 原生）切换为 WSL。
- 重启应用。 重启之前更改不会生效。你的项目保持不变。
集成终端需要单独配置。你可以让智能体在 WSL 中运行，同时终端仍使用 PowerShell，也可以两者都使用 WSL。
方式 B：在 WSL2 中使用 Codex CLI
打开 WSL2 shell，使用 Linux 安装程序：
curl -fsSL https://chatgpt.com/codex/install.sh | sh
codex在 Windows 和 WSL 之间共享配置、登录状态和历史记录
Windows 应用将 Codex 主目录放在 %USERPROFILE%\.codex。WSL 中的 CLI 默认使用 ~/.codex，因此两者不会共享设置、缓存的认证信息或会话。如需共享，请让 WSL 指向 Windows 目录：
export CODEX_HOME=/mnt/c/Users/<windows-user>/.codex将这一行添加到 ~/.bashrc 或 ~/.zshrc 中，使其永久生效。
项目放在哪里
如果你继续使用 Windows-native（Windows 原生）智能体，OpenAI 建议将项目存放在 Windows 驱动器上，并在 WSL 中通过 /mnt/<drive>/... 访问。从 \\wsl$\ 打开项目也能用，但可能检测不到 Git。参见解决方法。