在 Windows 上运行 Codex App，有两种模式：PowerShell 原生（配合 Windows Sandbox）和 WSL2（Linux 沙箱，安全性更高）。本文从 Microsoft Store 下载开始，覆盖沙箱配置、集成终端选择、必装开发工具，以及 PowerShell 执行策略报错、WSL 配置共享、Git 功能不可用等常见问题的解决方案。

Codex App Windows 安装与配置

Codex App for Windows 提供统一界面，支持跨项目工作、并行运行 Agent 线程和 Review 改动。可以在 PowerShell 下原生运行（配合 Windows Sandbox），也可以配置为在 WSL2 里运行。

---

安装与更新

从 Microsoft Store 下载，然后按 快速上手 指引配置。

更新：打开 Microsoft Store → 下载 → 检查更新，Store 会安装最新版本。

企业部署：管理员可以通过企业管理工具（如 Intune）使用 Microsoft Store 应用分发来推送 Codex App。

命令行安装（无需打开 Store UI）：

winget install Codex -s msstore

---

原生沙箱

Windows 上的 Codex App 在 PowerShell 模式下支持原生 Windows Sandbox；切换到 WSL2 后使用 Linux 沙箱。

在 Composer 里把沙箱权限设为 Default permissions 即可启用沙箱保护。

注意：Full Access 模式下 Codex 不受项目目录限制，可能执行意外的破坏性操作（数据丢失风险）。建议用 Rules 做针对性例外，而不是打开完全访问。

---

自定义开发环境

默认编辑器

在设置里选择 Open 时使用的默认编辑器（Visual Studio、VS Code 或其他编辑器）。也可以按项目覆盖。如果某个项目已经从 Open 菜单选择了特定编辑器，该项目的选择优先于全局默认。

集成终端

选择默认集成终端（取决于已安装的工具）：

• PowerShell
• Command Prompt
• Git Bash
• WSL

此设置仅影响新建的终端 session。已打开的终端需要重启应用或新建线程才会切换。

---

WSL（Windows Subsystem for Linux）

默认情况下，Codex App 使用 Windows 原生 Agent（命令在 PowerShell 里运行）。需要打开 WSL 文件系统里的项目时，点击 Add new project 或按 Ctrl+O，在文件浏览器里输入 \\wsl$\，选择 Linux 发行版和目录。

如果仍用 Windows 原生 Agent，建议把项目存放在 Windows 文件系统，通过 /mnt/<drive>/... 在 WSL 里访问——比直接从 WSL 文件系统打开更稳定。

切换 Agent 到 WSL2 模式：打开 Settings，把 Agent 从 Windows native 切换为 WSL，重启应用（不重启不生效）。重启后已有项目保留。

WSL1 在 Codex 0.114 及以前版本支持；从 0.115 起 Linux 沙箱迁移到 bubblewrap，不再支持 WSL1。

集成终端和 Agent 是独立配置的——你可以让 Agent 运行在 WSL 而集成终端仍用 PowerShell，或者两者都用 WSL，按需选择。

---

推荐安装的开发工具

以下工具已安装可以让 Codex 工作更流畅：

工具	用途
Git	Review 面板和变更检查功能依赖 Git
Node.js	Agent 执行常见任务时使用
Python	Agent 执行常见任务时使用
.NET SDK	构建 Windows 原生应用时有用
GitHub CLI	Codex App 的 GitHub 相关功能依赖 gh CLI

在集成终端里一键安装：

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，修改对应的包 ID 即可。

---

常见问题排查

PowerShell 执行策略阻止命令

如果从未在 PowerShell 里用过 Node.js 或 npm，Codex Agent 或集成终端可能遇到执行策略报错：

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

常见解决方案是将执行策略改为 RemoteSigned：

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned

修改前请先阅读 Microsoft 的执行策略文档。

需要管理员权限运行命令

以管理员身份启动 Codex App（开始菜单 → 右键 Codex → 以管理员身份运行），Agent 会继承该权限级别。

WSL 与 Windows App 共享配置和会话

Windows App 的配置目录是 %USERPROFILE%\.codex。WSL 里的 Codex CLI 默认用 Linux 主目录，不自动共享配置。解决方案：

# 在 WSL shell profile（~/.bashrc 或 ~/.zshrc）里加入：
export CODEX_HOME=/mnt/c/Users/<windows-user>/.codex

这样 WSL CLI 就会和 Windows App 共享配置、鉴权缓存和会话历史。

Git 功能不可用

Windows 没有原生安装 Git 时，App 无法使用 Review 面板等 Git 相关功能。解决：winget install Git.Git

从 \\wsl$ 打开的项目 Git 不被识别

目前最可靠的解决方案是：把项目存在 Windows 原生磁盘，通过 /mnt/<drive>/... 在 WSL 里访问。

Cmder 不在打开对话框里

右键 Cmder → 添加到开始菜单，然后重启 Codex 或重启电脑。