Windows 版 Codex App 为你提供一个统一界面，用于跨项目工作、并行运行多个智能体线程以及审查结果。Windows App 支持工作树、自动化、Git 功能、内置浏览器、artifact 预览、插件和技能等核心工作流。它可以直接在 Windows 上原生运行，使用 PowerShell 和 Windows 沙箱；你也可以把它配置为在 适用于 Linux 的 Windows 子系统 2（WSL2） 中运行。
下载并更新 Codex App
通过 Microsoft Store 下载 Codex App。
安装后，按 快速开始 开始使用。
更新时，打开 Microsoft Store，进入 Downloads（下载），点击 Check for updates（检查更新）。Store 随后会安装最新版本。
对于企业环境，管理员也可以通过企业管理工具，使用 Microsoft Store 的应用分发方式来部署 Codex App。
如果你更偏好命令行安装，或者不想手动打开 Microsoft Store 界面，可以运行：
winget install Codex -s msstore原生沙箱
当智能体在 PowerShell 中运行时，Windows 版 Codex App 支持原生 Windows 沙箱；如果你让智能体运行在 WSL2 中，则会改用 Linux 沙箱机制。无论是哪种模式，如果你希望启用沙箱保护，都需要在发送消息前，把输入框中的沙箱权限设置成 Default permissions（默认权限）。
按你的开发环境进行定制
默认编辑器
你可以为 Open（打开） 操作设置一个默认应用，例如 Visual Studio、VS Code 或其他编辑器。这个选择也可以按项目覆盖。如果你已经在某个项目的 Open 菜单中选过其他应用，那么项目级选择会优先生效。
集成终端
你也可以选择默认的集成终端。具体可选项取决于你电脑上安装了哪些终端，常见选项包括：
- PowerShell
- Command Prompt
- Git Bash
- WSL
这个改动只会影响新开的终端会话。如果你当前已经打开了一个集成终端，需要重启应用，或者新建一个线程后，新的默认终端才会生效。
适用于 Linux 的 Windows 子系统（WSL）
默认情况下，Codex App 使用的是 Windows 原生智能体，也就是说智能体命令会在 PowerShell 中执行。即便如此，应用仍然可以通过 wsl CLI 处理位于 WSL2 文件系统中的项目。
如果你想把 WSL 文件系统中的项目添加进来，点击 Add new project（添加新项目） 或按 Ctrl+O，然后在 File Explorer（文件资源管理器）窗口里输入 \\wsl$\。接着选择你的 Linux 发行版和要打开的目录。
如果你打算继续使用 Windows 原生智能体，推荐把项目存放在 Windows 文件系统中，再通过 WSL 的 /mnt/<drive>/... 路径访问它。相比直接从 WSL 文件系统里打开项目，这种方式通常更稳定。
如果你希望智能体本身运行在 WSL2 中，请打开 Settings（设置），把智能体从 Windows native（Windows 原生） 切换到 WSL，然后重启应用。这个改动只有在重启后才会生效，项目本身在重启后通常仍会保留。
WSL1 在 Codex 0.114 之前仍可使用。从 Codex 0.115 开始，Linux 沙箱切换到了 bubblewrap，因此 WSL1 不再受支持。
集成终端与智能体的选择是相互独立的。参见上面的按你的开发环境进行定制章节。你可以让智能体运行在 WSL2 中，同时在终端里继续使用 PowerShell；也可以两者都切到 WSL，具体取决于你的工作流。
常用开发工具
如果机器上已经装好一些常见开发工具，Codex 的体验会更好：
- Git：支撑 Codex App 中的评审面板，也方便你检查或还原改动。
- Node.js：智能体常会依赖它来更高效地完成任务。
- Python：智能体常会依赖它来更高效地完成任务。
- .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，即可启用应用中的 GitHub 相关功能。
如果你需要不同版本的 Python 或 .NET，请把上面的 package ID 换成你想安装的版本。
故障排查与常见问题
以管理员权限运行命令
如果你需要 Codex 以提升后的权限运行命令，请直接用管理员身份启动 Codex App。本地安装完成后，打开开始菜单，找到 Codex，选择 Run as administrator（以管理员身份运行）。Codex 智能体会继承这个权限级别。
PowerShell 执行策略（execution policy）阻止命令执行
如果你之前从未在 PowerShell 中使用过 Node.js、npm 等工具，Codex 智能体或集成终端可能会遇到执行策略（execution policy）错误。
如果 Codex 为你生成了 PowerShell 脚本，也可能出现同样问题。在这种情况下，你可能需要把执行策略（execution policy）调整得稍微宽松一点，PowerShell 才会允许运行这些脚本。
常见报错类似：
npm.ps1 cannot be loaded because running scripts is disabled on this system.一个常见修复方式是把执行策略设置为 RemoteSigned：
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned在更改之前，建议先查看 Microsoft 的执行策略指南，了解其他可选项与风险。
Windows 上的本地环境脚本
如果你的本地环境使用的是跨平台命令，例如 npm scripts，那么你通常可以为所有平台共用一份初始化脚本或动作集合。
如果你需要 Windows 专属行为，就为 Windows 单独定义初始化脚本或动作。
动作会运行在你所选的集成终端环境中，参见上面的按你的开发环境进行定制。
本地初始化脚本则运行在智能体所在环境中：如果智能体使用 WSL，它就在 WSL 里运行；否则就在 PowerShell 中运行。
与 WSL 共享配置、认证和会话
Windows 应用使用的 Codex 主目录与原生 Windows CLI 相同：%USERPROFILE%\.codex。
如果你也在 WSL 里运行 Codex CLI，那么 CLI 默认会使用 Linux home 目录，因此不会自动与 Windows app 共享配置、缓存的认证信息或会话历史。
若要共享，可以使用以下方式之一：
- 让 WSL 中的
~/.codex与%USERPROFILE%\.codex保持同步 - 或在 WSL 中设置
CODEX_HOME
export CODEX_HOME=/mnt/c/Users/<windows-user>/.codex如果你希望每个 shell 都生效，把它加入你的 WSL shell 配置文件，例如 ~/.bashrc 或 ~/.zshrc。
Git 功能不可用
如果你没有在 Windows 原生环境里安装 Git，应用的某些功能将无法使用。可以在 PowerShell 或 cmd.exe 中运行 winget install Git.Git 安装。
从 \\wsl$ 打开的项目检测不到 Git
目前，如果你想在一个也能被 WSL 访问到的项目上继续使用 Windows 原生智能体，最可靠的做法仍然是把项目存放在 Windows 本机磁盘上，然后在 WSL 中通过 /mnt/<drive>/... 访问它。
打开对话框里看不到 Cmder
如果你已经安装了 Cmder，但它没有出现在 Codex 的打开对话框中，可以先把它加入 Windows 开始菜单：右键 Cmder，选择 Add to Start，然后重启 Codex 或重启电脑。