古法编程

OpenAI Codex Windows 版适合在 Windows 上跨项目工作、并行运行多个 agent 线程、查看结果，也支持 worktrees、automations、Git、内置浏览器、artifact 预览、plugins 和 skills。默认用 Windows-native agent 在 PowerShell 里运行；如果启用 WSL2，也可以切换到 Linux sandbox，但需要重启应用后才生效。

OpenAI Codex Windows 安装与使用

OpenAI Codex Windows 版提供一个统一界面，方便你在多个项目之间切换、并行运行 agent 线程、审查结果。它支持 worktrees、automations、Git 功能、内置浏览器、artifact 预览、plugins 和 skills。默认会在 Windows 上原生运行，也可以配置为在 WSL2 中运行。

下载和更新 Codex app

从 Microsoft Store 下载 Codex app。

然后按照 quickstart 开始使用。

更新应用时，打开 Microsoft Store，进入 Downloads，点击 Check for updates，商店会随后安装最新版本。

对于企业环境，管理员可以通过企业管理工具使用 Microsoft Store app distribution 部署应用。

如果你更想用命令行安装，或者不想打开 Microsoft Store 界面，可以运行：

winget install Codex -s msstore

本地沙箱

当 agent 在 PowerShell 中运行时，OpenAI Codex Windows app 支持原生 Windows sandbox。如果你把 agent 配到 Windows Subsystem for Linux 2 (WSL2)，则会使用 Linux sandbox。

要在这两种模式下都启用沙箱保护，在向 Codex 发送消息之前，把 Composer 里的 sandbox permissions 设为 Default permissions。

以 full access mode 运行时，Codex 不会限制在项目目录内，可能执行意外的破坏性操作并导致数据丢失。建议保留沙箱边界，并用 rules 做定向例外；或者按你的 approval 和 security setup 把 approval policy 设为 never，让 Codex 在不请求升级权限的情况下尝试解决问题。

按你的开发环境定制

默认编辑器

你可以为 Open 选择默认应用，比如 Visual Studio、VS Code，或者其他编辑器。这个选择可以按项目单独覆盖。
如果你已经在某个项目的 Open 菜单里选过别的应用，那么该项目自己的设置优先生效。

集成终端

你也可以选择默认的集成终端。根据你安装的工具，可选项包括：

  • PowerShell
  • Command Prompt
  • Git Bash
  • WSL

这个修改只影响新的终端会话。如果你已经打开了一个集成终端，需要重启应用，或者新开一个线程，新的默认终端才会出现。

Windows Subsystem for Linux (WSL)

默认情况下，Codex app 使用 Windows-native agent，也就是在 PowerShell 中运行命令。即使项目放在 Windows Subsystem for Linux 2 (WSL2) 里，应用也仍然可以通过 wsl CLI 处理这些项目。

如果你想从 WSL 文件系统里添加项目，点击 Add new project，或者按 Ctrl+O，然后在 File Explorer 窗口里输入 \\wsl$\。接着选择 Linux 发行版和要打开的文件夹。

如果你准备继续使用 Windows-native agent，建议把项目保存在 Windows 文件系统里，再从 WSL 通过 /mnt/<drive>/... 访问。相比直接打开 WSL 文件系统里的项目，这种方式更可靠。

如果你想让 agent 本身在 WSL2 中运行，打开 Settings，把 agent 从 Windows native 切换到 WSL，然后重启应用。这个变更不会在不重启的情况下生效。重启后，项目应保持不变。

WSL1 只在 Codex 0.114 之前受支持。从 Codex 0.115 开始，Linux sandbox 改为 bubblewrap，因此不再支持 WSL1。

你可以独立配置集成终端和 agent。终端选项见上面的“按你的开发环境定制”。你可以让 agent 运行在 WSL，同时终端继续用 PowerShell；也可以两者都用 WSL，取决于你的工作流。

常用开发工具

如果已经安装了这些常见开发工具，Codex 的效果通常最好：

  • Git：驱动 Codex app 的 review pane，并允许你检查或还原更改。
  • Node.js：agent 常用的工具，能更高效地执行任务。
  • Python：agent 常用的工具，能更高效地执行任务。
  • .NET SDK：在你想构建原生 Windows 应用时很有用。
  • GitHub CLI：驱动 Codex app 里的 GitHub 专属功能。

你可以把下面这些命令粘贴到 集成终端 里，或者直接让 Codex 帮你安装：

winget install --id Git.Git
winget install --id OpenJS.NodeJS.LTS
winget install --id Python.Python.3.14
winget install --id Microsoft.DotNet.SDK.10
winget install --id GitHub.cli

安装完 GitHub CLI 之后，运行 gh auth login，即可启用 app 中的 GitHub 功能。

如果你需要其他 Python 或 .NET 版本，把 package IDs 改成你想要的版本即可。

常见问题

OpenAI Codex Windows 版怎么以管理员权限运行

如果你需要让 Codex 以提升权限运行，先把 Codex app 本身用管理员身份启动。安装完成后，打开 Start menu，找到 Codex，选择 Run as administrator。Codex agent 会继承这个权限级别。

PowerShell 提示执行策略阻止命令怎么办

如果你之前从没在 PowerShell 里用过 Node.js 或 npm 这类工具，Codex agent 或集成终端可能会遇到 execution policy 错误。

当 Codex 为你生成 PowerShell 脚本时，也可能出现这个问题。此时在 PowerShell 允许脚本运行之前，你可能需要降低执行策略限制。

错误大致会像这样：

npm.ps1 cannot be loaded because running scripts is disabled on this system.

常见修复方式是把 execution policy 设为 RemoteSigned：

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned

在修改之前，建议先查看 Microsoft 的 execution policy guide，确认还有哪些选项。

Windows 上的本地环境脚本怎么写

如果你的 local environment 里用了像 npm scripts 这类跨平台命令，可以为所有平台共用一套 setup script 或 actions。

如果你需要 Windows 专用行为，就创建 Windows-specific setup scripts 或 Windows-specific actions。

Actions 运行在你的集成终端所使用的环境中。见上面的“按你的开发环境定制”。

Local setup scripts 运行在 agent 环境里：如果 agent 用 WSL，就在 WSL 中运行；否则就在 PowerShell 中运行。

怎么让 Windows app 和 WSL 共享配置、认证和会话

Windows app 使用和 Windows 原生 Codex 相同的 Codex home 目录：%USERPROFILE%\.codex。

如果你也在 WSL 里运行 Codex CLI，CLI 默认使用 Linux home 目录，所以它不会自动和 Windows app 共享配置、已缓存的认证信息或会话历史。

要共享这些内容，可以用下面两种方式之一：

  • 把 WSL 的 ~/.codex 和文件系统里的 %USERPROFILE%\.codex 同步起来。
  • 通过设置 CODEX_HOME，让 WSL 指向 Windows Codex home 目录：
export CODEX_HOME=/mnt/c/Users/<windows-user>/.codex

如果你希望每个 shell 都生效，把这项设置写进 WSL 的 shell profile，比如 ~/.bashrc 或 ~/.zshrc。

Git 功能为什么不可用

如果你的 Windows 上没有原生安装 Git，app 就无法使用部分功能。你可以在 PowerShell 或 cmd.exe 中运行 winget install Git.Git 来安装。

从 \\wsl$ 打开的项目为什么检测不到 Git

目前如果你想让 Windows-native agent 处理一个同时也能被 WSL 访问的项目，最可靠的做法是把项目放在本机 Windows 盘上，然后在 WSL 中通过 /mnt/<drive>/... 访问。

Cmder 为什么不出现在打开对话框里

如果已经安装了 Cmder，但在 Codex 的打开对话框里看不到它，可以把它添加到 Windows Start Menu：右键点击 Cmder，选择 Add to Start，然后重启 Codex，或者重启电脑。

OpenAI Codex Windows 常见问题

OpenAI Codex Windows 版支持哪些运行模式

默认使用 Windows-native agent，在 PowerShell 中运行命令。也可以切换到 WSL2，让 agent 在 Linux sandbox 中运行，但切换后要重启应用才会生效。

OpenAI Codex Windows 版和 WSL 能共享会话吗

可以，但不会自动共享。Windows app 使用 %USERPROFILE%\.codex，WSL 里的 Codex CLI 默认使用 Linux home 目录；如果要共享配置、auth 和 session history，需要同步 ~/.codex，或者在 WSL 中设置 CODEX_HOME 指向 Windows 的 .codex 目录。