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使用 ChocolateyChocolatey 安装# 使用 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 | elevatedsandbox unelevated# 在私有桌面运行沙盒子进程sandbox_private_desktop true沙箱模式说明模式说明unelevated标准用户权限运行推荐elevated管理员权限运行推荐使用 unelevated 模式以保持安全性。PowerShell 集成Codex 可以直接在 PowerShell 中使用PowerShell 中使用# 启动 Codexcodex# 非交互模式codex exec 审查代码# 使用 PowerShell 命令codex ! Get-ProcessCMD 支持Codex 也支持传统的 CMD 环境CMD 中使用# 在 CMD 中运行codex exec 列出文件Codex 自动检测终端类型并优化输出。Windows 特有配置路径处理Windows 路径与 Unix 不同Codex 会自动处理反斜杠转换为正斜杠盘符处理UNC 路径支持环境变量Windows 环境变量# 设置 Codex 特定的环境变量set CODEX_HOMEC:\Users\YourName\.codexset CODEX_SQLITE_HOMEC:\Users\YourName\.codex代理配置代理设置# 设置代理set HTTP_PROXYhttp://proxy.example.com:8080set HTTPS_PROXYhttp://proxy.example.com:8080# 然后运行 Codexcodex如果你的网络需要代理配置环境变量即可。故障排除常见问题无法启动检查是否安装了必要的 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。