安装与账号配置

Codex Windows 系统要求与 Win10 兼容性

Codex Windows 安装要求说明,帮助判断 Windows 10、Windows 11、PowerShell、WSL2、winget 和开发工具是否满足使用条件。

编辑:Codex Guide 编辑

搜索 Codex 支持 Win10 吗Codex 安装对电脑有什么要求 时,先确认你要安装的是 ChatGPT/Codex 桌面应用、Codex CLI,还是 Code8 Manager。三者的安装方式和依赖不同,不能只看一个“支持 Windows”的结论。

先看结论

  • Windows 11 是更稳妥的桌面应用环境。
  • 已完整更新的 Windows 10 可能可以运行部分 Codex 工作流,但桌面应用、原生沙箱和新功能的可用性会受系统组件与客户端版本影响。
  • 如果旧版 Win10 无法安装桌面应用,可以选择更新系统、使用 Codex CLI,或在受支持的 WSL2 环境中运行 CLI。
  • 不要从不明网站下载所谓“Win10 特供版”“免安装破解版”或替换系统组件的压缩包。

官方功能和系统支持会随客户端更新变化,安装前应同时核对 Windows 应用文档 与当前安装入口显示的要求。

安装前检查表

1. Windows 版本与更新状态

Win + R,输入 winver,记录 Windows 版本和系统内部版本。然后打开 Windows Update,安装待处理的系统更新并重启。

如果安装器明确提示系统版本过低,不要通过兼容模式强行绕过。桌面应用依赖的商店、WebView、终端和安全组件可能仍然无法正常工作。

2. 安装入口是否可用

在 PowerShell 中检查 winget

winget --version

没有 winget 不一定意味着 Codex CLI 无法使用,但可能影响桌面应用和常用开发工具的安装。先更新 Microsoft Store 的“应用安装程序”,再重新打开终端。

3. PowerShell 与终端

原生 Windows 代理会通过 PowerShell 执行命令。先确认 PowerShell 可以启动,并能运行:

$PSVersionTable.PSVersion

公司电脑还可能通过执行策略、组策略或安全软件限制脚本。出现权限错误时,应记录完整提示并让管理员确认策略,不要直接关闭系统防护。

4. 磁盘、权限和网络

安装前确认:

  1. 系统盘和目标安装盘有足够空间。
  2. 当前用户可以写入安装目录。
  3. 网络可以访问所选安装源。
  4. 安全软件没有隔离安装器或沙箱组件。
  5. 安装过程只运行一个窗口,避免多个安装任务互相占用文件。

5. 开发工具不是全部必装

Git、Node.js、Python、.NET SDK 和 GitHub CLI 会让 Codex 更容易完成对应项目任务,但不是每个用户都需要一次性安装全部工具。先按项目技术栈安装真正需要的依赖。

Win10 版本太低怎么办

按以下顺序处理:

  1. 运行 Windows Update,升级到该设备能获得的最新受支持版本。
  2. 重启后重新检查 Microsoft Store、winget 和安装器。
  3. 如果桌面应用仍不兼容,改用 Codex CLI 安装教程
  4. 需要 Linux 工具链时,确认设备支持 WSL2,再看 Codex WSL2 安装与配置
  5. 设备无法继续获得安全更新时,不建议为了安装 Codex 长期停留在旧系统。

原生 Windows 还是 WSL2

使用情况建议
项目主要在 Windows 目录,使用 PowerShell原生 Windows
项目和工具链已经在 Linux 环境WSL2
需要 Windows 桌面应用和原生沙箱原生 Windows
原生沙箱模式都被本机策略阻止评估 WSL2

桌面应用默认使用 Windows 原生代理。切换到 WSL 后需要重启应用才会生效;WSL1 已不适用于当前 Codex Linux 沙箱路径。

下一步

环境满足要求后,继续 下载并安装 Codex Windows 版。如果安装进度不动或启动失败,查看 Codex 常见问题与排错