[AI开发] 安装Codex必须启用WSL2：推荐Win11系统以获得最佳兼容体验

原创于 2025-12-09 10:32:09 发布 · 431 阅读

14 ·

CC 4.0 BY-SA版权

文章标签：

#人工智能 #AI #AI编程

生成式AI实战笔记专栏收录该内容

5 篇文章

订阅专栏

编程达人挑战赛·第5期 10w+人浏览 351人参与

作为 OpenAI 推出的强大编程助手，Codex 已经成为许多开发者进行自动代码生成、辅助编程的得力工具。然而在本地部署 Codex 时，很多用户尤其是使用 Windows 系统的开发者会发现：Codex 的安装对系统环境有非常严格的要求。最关键的一点就是——Codex 依赖于 WSL2（Windows Subsystem for Linux 2）环境运行。

但问题在于：WSL2 又强依赖 Hyper-V，而 Hyper-V 并非在所有 Windows 版本中都默认启用或易于启用。这篇文章将带你彻底厘清 Codex 安装环境的底层逻辑，并从实际体验角度分析为何推荐你在 Win11 上进行安装。

一、Codex 安装为何必须使用 WSL2？

1. Codex 的运行需要类 Unix 环境

Codex 后端环境主要依赖于 Linux 生态，如 Python、CUDA、NVIDIA 驱动、容器环境等。而 Windows 原生环境对这些支持并不良好。因此，OpenAI 官方推荐直接在 Linux 或通过 WSL2 在 Windows 下运行 Codex。

2. WSL1 vs WSL2：选择的重要性

WSL1 虽然存在，但已无法满足 Codex 的依赖：

特性	WSL1	WSL2
内核类型	转译层（非Linux）	真正的 Linux 内核
性能	限制较大	接近原生 Linux
Docker支持	不完全	完整支持 Docker & GPU
Codex兼容性	❌ 不支持	✅ 完全支持

因此，想用 Codex，必须使用 WSL2！

二、使用 WSL2 的前提：必须启用 Hyper-V

1. Hyper-V 是什么？

Hyper-V 是微软提供的虚拟化平台，WSL2 本质上就是在 Hyper-V 上运行的轻量级 Linux 虚拟机。因此，启用 WSL2 就必须启用 Hyper-V。

2. 如何启用 Hyper-V？

在 Windows 中，开启 Hyper-V 和 WSL2 涉及以下步骤：

dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart

然后还需要通过“启用或关闭 Windows 功能”勾选：

✅ Hyper-V
✅ 虚拟机平台
✅ Windows 子系统 Linux

重启电脑后，才能确保生效。

三、Win11 是 Codex 本地部署的最佳选择

虽然 Win10 也支持 WSL2，但相比之下，Win11 安装配置 WSL2 更简单，兼容性更好。

✅ Win11 的优势包括：

默认支持 WSL2 和 Hyper-V，无需手动下载内核包
GUI 和 Linux 桌面支持更好（wslg 内置）
内置 wsl.exe --install 一步完成所有设置

安装示例（Win11 下只需一条命令）：

wsl --install

安装完成后直接进入 Ubuntu（或其他发行版），随后即可部署 Codex 所需环境，如 Conda、PyTorch、CUDA 等。

四、开发者实际体验对比

项目	Win10（需要手动配置）	Win11（默认支持）
启用 WSL2 所需步骤	多步骤命令+重启	一条命令搞定
Docker Desktop 与 WSL2	手动配置集成路径	自动检测
Codex 安装成功率	低，依赖错多，易崩溃	高，安装更丝滑
Hyper-V 冲突问题	容易与VMWare等冲突	管理逻辑更统一