Codex Windows 原生支持

Codex 在 Windows 上提供原生支持，无需 WSL 即可运行。本节介绍 Windows 平台特有的功能和配置。

Windows 支持概述

Codex 支持以下 Windows 环境：

环境支持状态
Windows 11（原生）官方支持
Windows 10官方支持
Windows 11 + WSL2完整支持

Codex 可以在 Windows 上原生运行，保持 Windows 工作流程。

安装

使用 winget 安装

winget 安装

# 使用 winget 安装
winget install OpenAI.Codex

# 或者安装预览版
winget install OpenAI.Codex --source winget --accept-source-agreements --accept-package-agreements

使用 Chocolatey

Chocolatey 安装

# 使用 Chocolatey 安装
choco install codex -y

手动安装

从 GitHub 下载 Windows 版本：

https://github.com/openai/codex/releases

下载 .exe 安装程序并运行。

推荐使用 winget 或 Chocolatey 安装，以便自动更新。

原生沙箱

Codex 可以在 Windows PowerShell 中原生运行：

  • 无需 WSL 或虚拟机
  • 保持 Windows 工作流程
  • 与 Windows 工具无缝集成

沙箱模式配置

配置沙箱

# Windows 沙箱配置
[windows]
# 沙箱模式：unelevated | elevated
sandbox = "unelevated"

# 在私有桌面运行沙盒子进程
sandbox_private_desktop = true

沙箱模式说明

模式说明
unelevated标准用户权限运行（推荐）
elevated管理员权限运行
推荐使用 unelevated 模式以保持安全性。

PowerShell 集成

Codex 可以直接在 PowerShell 中使用：

PowerShell 中使用

# 启动 Codex
codex

# 非交互模式
codex exec "审查代码"

# 使用 PowerShell 命令
codex ! Get-Process

CMD 支持

Codex 也支持传统的 CMD 环境：

CMD 中使用

# 在 CMD 中运行
codex exec "列出文件"
Codex 自动检测终端类型并优化输出。

Windows 特有配置

路径处理

Windows 路径与 Unix 不同，Codex 会自动处理：

  • 反斜杠转换为正斜杠
  • 盘符处理
  • UNC 路径支持

环境变量

Windows 环境变量

# 设置 Codex 特定的环境变量
set CODEX_HOME=C:\Users\YourName\.codex
set CODEX_SQLITE_HOME=C:\Users\YourName\.codex

代理配置

代理设置

# 设置代理
set HTTP_PROXY=http://proxy.example.com:8080
set HTTPS_PROXY=http://proxy.example.com:8080

# 然后运行 Codex
codex
如果你的网络需要代理，配置环境变量即可。

故障排除

常见问题

无法启动？

  • 检查是否安装了必要的 Visual C++ 运行库
  • 尝试以管理员权限运行
  • 检查杀毒软件是否阻止

PowerShell 命令不执行？

确保 PowerShell 可执行文件在 PATH 中。

中文路径问题？

Codex 支持 Unicode，但某些旧版终端可能有问题。

大多数问题可以通过重新安装或更新解决。

日志位置

Windows 日志位置：

%USERPROFILE%\.codex\log\codex-tui.log
查看日志可以了解详细的错误信息。

与 WSL2 比较

特性原生 WindowsWSL2
性能更快稍慢
设置简单需要安装 WSL
兼容性Windows 工具Linux 工具
维护自动更新独立更新
对于大多数 Windows 用户，推荐使用原生版本。

最佳实践

  • 使用 winget 或 Chocolatey 安装
  • 保持系统和 Codex 更新
  • 使用 unelevated 沙箱模式
  • 配置合理的代理（如需要）
Windows 原生支持让 Codex 可以无缝融入你的 Windows 工作流程。

常见问题

Q: Windows 原生版本和 WSL 版本哪个好？

对于大多数用户，原生版本更好 - 更快、更简单。

Q: 可以和 WSL 共存吗？

可以，两者可以同时安装使用。

Q: 需要管理员权限吗？

不需要，unelevated 模式不需要管理员权限。

Q: 支持 PowerShell ISE 吗？

推荐使用 Windows Terminal 或新版 PowerShell。