最近在 Windows 11 上装 Codex 桌面版，安装包跑完、账号登录都顺顺利利，结果点击“继续完成 Windows 设置”这个按钮时，弹窗直接给了我一句“Windows 沙箱初始化失败”。我当时第一反应是 Codex 本体坏了，反复重装了两遍，问题一模一样，后来才发现根子不在 Codex，而在 Windows 自己的虚拟化环境上。这篇文章会把完整排查链路和修复方案都写出来，包括我踩过的坑、验证方法和一份可以直接抄的检查单。适合两类读者：一类是和我一样被这个弹窗卡住的人；另一类是正准备装 Codex 桌面版、想提前把 Windows 环境理顺的人。说白了，这个错误提示很模糊，但绝大多数情况下都能在半小时内解决。
1. 先弄明白：“继续完成 Windows 设置”这一步到底在配置什么
1.1 Codex 为什么非要有沙箱不可
Codex 不是普通的代码补全工具，它是 AI 编程智能体。你在窗口里下指令，它不只是把代码写出来，还会直接编译、运行测试、修改项目文件，甚至执行你要求的维护脚本。这种能力意味着它有权限操作你的真实系统。如果它运行一个删除命令、改一个注册表键值或连一下内网服务，出了问题很难追回。沙箱的作用就是把“AI 执行的代码”和“宿主机系统”隔离开，让不可信代码在受限环境里跑，跑完就丢。
Windows 版 Codex 的沙箱底座就是 Windows 沙箱。对不熟悉的朋友说一句，Windows 沙箱本质上是一个用完即焚的轻量虚拟机，基于 Hyper-V 技术。每次启动都是干净系统，关闭后所有更改全部消失。对 Codex 这种需要短时间执行可能不可信代码的场景来说，这种设计非常合适——AI 生成的代码就算再造作，也污染不到你日常使用的环境。
我见过有人问“Codex 为什么不能直接在终端里跑”，其实看这个逻辑就明白了：终端跑代码补全没问题，但平台要跑一个会自主执行命令的智能体，就必须把执行环境圈起来。Windows 沙箱正好承担了这个角色，所以它起的名字叫“沙箱”而不是“虚拟机”，侧重点就在于隔离和临时。
1.2 “继续完成 Windows 设置”到底做了什么
点击按钮后，Codex 桌面版并不是在配置 Codex 本身，而是在把沙箱运行环境拉起来。从安装过程和日志看，它至少做了三件事：
- 检查 Windows 沙箱所需的功能是否开启，包括 Hyper-V 平台、虚拟机平台、Windows 沙箱组件；
- 如果功能缺少，尝试通过系统接口把功能补上；
- 创建并启动一个沙箱虚拟机实例，进行启动自检。
任何一个环节失败，最终都会收敛成同一句“Windows 沙箱初始化失败”。我之前一直以为是 Codex 安装包有问题，但其实这一步是典型的“环境前置校验”，校验不过，应用根本不会进入正式初始化阶段。
这个流程对开发者来说其实很常见，类似 Docker 启动时检查 WSL 2、安卓模拟器检查 Hyper-V。Codex 只是在首次启动时把这一步做成了可视化引导，显得像是在“设置 Codex”，实际上它服务的是整个 Windows 虚拟化体系。
1.3 为什么这个弹窗给了等于没给
弹窗里没有错误码、没有组件名、没有日志路径，信息量几乎为零。同一条提示背后可能是硬件虚拟化没开、功能没启用、内存不足、甚至系统被更换成不支持的版本，所以正确姿势是先做整体体检，而不是反复重装 Codex。重装软件和这个提示完全无关，我一开始就白做了两遍。
这里要强调一个判断问题的基本思路：同一个表层症状，背后可以对应完全不同的底层原因。弹窗只说“初始化失败”，就好比车子启动不了，可能是没油、没电、火花塞坏、甚至钥匙没电。这时候瞎拆发动机没意义，先把油表、电瓶、传感器逐项查一遍，才能少走弯路。
2. 完整排查链路：我是如何从一句弹窗定位到 BIOS 虚拟化开关的
2.1 第一步：先看日志，别急着动系统
排查的第一步，我觉得应该是翻日志。Codex 桌面版的日志通常在你用户目录下的 .codex 文件夹里，找 logs 子目录，按时间倒序找最新文件。如果你用的是绿色版或自定义安装目录，也可以在安装目录下找 logs 文件夹，或者直接全盘搜索“codex”相关文件夹，都是一样的。
打开之后重点搜 “sandbox” 和“初始化失败”对应的英文关键字。日志里可能有一句 “Windows sandbox initialization failed”，也可能包含更底层的原因，比如 Hyper-V 相关服务起不来、虚拟化不可用等。虽然不一定能直接定位到 BIOS，但能帮你缩小范围。
一个小技巧：在报错前在电脑上打开一个记事本，记下当前时间，报错后去看日志目录，哪些文件是刚刚修改的，那个文件里往往就有最有用的线索。日志是排查这类问题最可信的一手信息，比任何论坛论断都靠谱。
2.2 第二步：确认你的 Windows 版本到底支不支持沙箱
Windows 沙箱对系统版本有硬性要求：必须是 Windows 10/11 专业版、企业版或教育版。家庭版无法启用 Windows 沙箱，因为底层 Hyper-V 相关组件被裁剪了。所以第一件事用 Win+R 输入 winver 看版本信息。
如果你看到版本里写着“家庭版”，那后面的功能开关都不用折腾了。要么去“设置 -> 系统 -> 激活 -> 更改产品密钥”，输入合法专业版密钥直接升级；要么先完成升级再回来继续配置 Codex。有人问“家庭版能不能手动开启 Hyper-V”，答案是官方不支持，强行开启会面临系统更新被覆盖、功能状态不稳定等问题，不推荐。
还有一点要注意：哪怕你用的是专业版，也要确认 Windows 更新是不是停在很老的版本上。Windows 沙箱功能在旧版本系统上有不少已知问题，尤其是组件更新不完整的情况，先把系统更新到最新会更省事。
2.3 第三步：体检虚拟化状态
Windows 沙箱是跑在 Hyper-V 上的轻量虚拟机，硬件虚拟化是地基。有几种方式检查：
- 任务管理器 -> 性能 -> CPU：右下角有“虚拟化”一栏，显示“已启用”或“已禁用”。
- msinfo32（系统信息）-> 系统摘要：可以看到“虚拟化”相关信息。
- 命令行 systeminfo：输出末尾有一段“Hyper-V 要求”，会提示固件中是否已启用虚拟化。
我自己的机器就是在这里现了原型：任务管理器 CPU 页面清清楚楚写着“虚拟化：已禁用”。看到这三个字，我的心反而定了，因为大概率是 BIOS 设置问题，不用去碰 Codex。
这里要补充一个容易被忽略的点：即使任务管理器里虚拟化显示“已启用”，也不代表一切顺利。你还需要看“基于虚拟化的安全性”是否正常，有时候安全软件或系统策略会占用虚拟化能力，导致 Hyper-V 平台没法正常使用。但在大多数家用电脑上，任务管理器这一项就足够判断方向了。
2.4 第四步：检查 Windows 可选功能、服务和组策略
虚拟化开启后如果还失败，就要看 Windows 层面了。依次检查三个地方：
- 可选功能：控制面板 -> 程序 -> 启用或关闭 Windows 功能，确认“Windows 沙箱”“虚拟机平台”“Hyper-V”这三项至少勾选了后两项。Windows 沙箱与虚拟机平台建议都勾上，Hyper-V 平台在启用沙箱时会自动作为依赖拉起。也可以在管理员 PowerShell 里直接查状态：
Get-WindowsOptionalFeature -Online | Where-Object FeatureName -match "Sandbox|Hyper|VirtualMachine" | Select-Object FeatureName, State服务：services.msc 里重点看 Hyper-V Virtual Machine Management（Vmms）和 Hyper-V Host Compute Service 是否被禁用，常见于装了各种系统优化工具后。这俩服务被改成“禁用”后，即使功能开关都是开的，沙箱也启动不了。
组策略：gpedit.msc 打开“计算机配置 -> 管理模板 -> Windows 组件 -> Windows 沙箱”，把“允许 Windows 沙箱”设成“未配置”或“已启用”。公司电脑尤其容易在这里翻车，域策略可能直接锁死沙箱。
2.5 我的根因落点：BIOS 里的 Virtualization 开关
我的机器到了第三步就定位了：虚拟化显示禁用。重启进 BIOS，在“高级 CPU 配置”里找到 SVM Mode（AMD 平台）或 Intel Virtualization Technology（Intel 平台，有的叫 VT-x），从 Disabled 改成 Enabled，保存退出。重启后再看任务管理器，虚拟化变成“已启用”。回到 Codex 点击“继续完成 Windows 设置”，这次一路顺畅。
我遇到这个问题之前根本没意识到笔记本出厂默认会关掉虚拟化。这是很多人的共同盲点：Windows 功能菜单里的 Hyper-V、沙箱选项都是“开”的，但底层 BIOS 没开，跑起来照样初始化失败，提示还特别模糊。所以排查顺序里，虚拟化一定要排在功能开关前面，因为软件层状态再好，地基没打牢都是白搭。
3. 对症下药：六种常见失败根因的完整修复操作
3.1 根因一：Windows 版本不满足
一句话判断：winver 里看到“家庭版”。
Windows 沙箱在家庭版上不可用，这是系统级裁剪，不是开关能解决的。修复方案就一个：升级到支持的专业版/企业版，然后重启再跑 Codex。升级后会保留现有文件和程序，不用太担心数据迁移。
如果你暂时没有升级条件，又急着用 Codex，也可以先考虑用 Codex CLI 的只读沙箱模式顶一顶。CLI 版本里有自动配置沙箱模式的逻辑，允许在更严格的读写限制下工作。但注意这只是权宜之计，Windows 桌面版所依赖的系统级沙箱依然需要专业版及以上版本，长期用还是建议把系统版本升上去。
3.2 根因二：BIOS 虚拟化被关闭
操作步骤并不复杂，关键是找到正确的 BIOS 入口：
- 重启电脑，开机时按 DEL / F2 / F10 进入 BIOS 或 UEFI 设置界面。
- 不同品牌进 BIOS 的按键不完全一样，可以参考这个表：
| 品牌/主板 | 常见按键 |
|---|---|
| 华硕 | DEL / F2 |
| 微星 | DEL |
| 技嘉 | DEL / F2 |
| 联想 | F2 / Fn+F2 |
| 戴尔 | F2 |
| HP | F10 / ESC |
- 进入“Advanced”或“CPU Configuration”，找 Intel Virtualization Technology / VT-x、AMD SVM Mode、VT-d 等，改成 Enabled。
- 保存并退出，进系统后再看任务管理器 CPU 页，确认“虚拟化：已启用”。
注意事项：有些电脑 BIOS 界面里没有虚拟化选项，可能是默认开启但被第三方占用，也可能是固件里被隐藏。可以尝试恢复 BIOS 默认设置再找，或者在“Security”菜单里搜索 Virtualization。我见过一台 ThinkPad 的选项在“Security -> Virtualization -> Intel Virtualization Technology”里，而不是在 CPU 配置里。如果你找了一圈确实没有，先去官网查一下主板型号是否支持虚拟化，别在设置里耗太久。
3.3 根因三：Windows 沙箱相关功能未启用
环境：虚拟化已启用，版本也支持，但还是初始化失败。
管理员身份打开 PowerShell，一次运行下面三条命令：
Enable-WindowsOptionalFeature -Online -FeatureName "Microsoft-Hyper-V" -All Enable-WindowsOptionalFeature -Online -FeatureName "VirtualMachinePlatform" -All Enable-WindowsOptionalFeature -Online -FeatureName "Containers-DisposableClientVM" -All跑完提示是否重启，选择重启。重启后重新打开 Codex，再点“继续完成 Windows 设置”。
Containers-DisposableClientVM 就是“Windows 沙箱”在系统内部注册的功能名，记不住没关系，直接在“启用或关闭 Windows 功能”界面里勾选“Windows 沙箱”和“虚拟机平台”效果一样。我建议优先用命令行的原因，是它能直接显示 State 状态，方便确认到底有没有成功。图形界面勾选之后，如果切换页面再回来发现勾又没了，多半是上一个选项没真正生效，需要用命令行重新确认。
3.4 根因四：系统组件损坏或更新不完整
如果你所有开关都确认开齐了、BIOS 也对了，还是失败，多半是沙箱组件或系统映像出了毛病。这时先做完整性修复：
DISM /Online /Cleanup-Image /RestoreHealth sfc /scannow两条命令都跑完，重启，再试。如果还不行，强制重建 Windows 沙箱组件状态：
Disable-WindowsOptionalFeature -Online -FeatureName "Containers-DisposableClientVM" -NoRestart重启之后再用前面的 Enable 命令把它重新启用一遍。这个操作有点像把电源彻底断掉再通电，很多半损坏状态会被清掉，比单纯重装应用管用得多。
另外别忘了检查 Windows 更新。我见过一台机器是系统更新没打全，沙箱组件缺了新版本补丁，更新到最新版后问题自动消失。尤其是 Windows 11 的 26H2 这类大版本更新，前后沙箱依赖的服务名和组件名可能有调整，旧状态容易出问题。
3.5 根因五：内存、磁盘空间不够
Windows 沙箱要求系统至少 4GB 可用内存，建议 8GB 以上；磁盘可用空间至少 1-2GB（推荐 SSD）。但它每次启动时会把轻量系统加载进内存，所以实际占用峰值很容易飙到 2-3GB。如果你机器本身只有 8GB 内存，开机后浏览器、微信、直播软件一开，可用内存可能只剩两三 GB，沙箱初始化失败的概率会直线上升。
检查方向：
- 关闭浏览器、视频会议等大内存占用程序，再看任务管理器性能页。
- 磁盘空间：检查 C 盘剩余空间，沙箱虚拟磁盘默认构建在临时目录，C 盘不够就会初始化失败。清一下临时文件，给 C 盘腾出空间。
- 虚拟内存：设置 -> 系统 -> 关于 -> 高级系统设置 -> 性能设置 -> 高级 -> 虚拟内存，确保“自动管理所有驱动器的分页文件大小”是勾选状态。分页文件设置过小也可能导致随机失败。
磁盘方面有个容易踩的坑：有些人的 C 盘是系统盘加软件盘混用，看起来“剩余空间几十 GB”，但临时目录里已经堆积了大量沙箱 VHD 文件。打开%TEMP%和C:\Windows\Temp，把里面明显是沙箱或临时虚拟磁盘的旧文件清掉，往往能解决“空间明明够”但沙箱还是起不来的问题。
3.6 根因六：组策略禁用、第三方软件冲突
最后这类问题比较隐蔽：
- 组策略里禁用了 Windows 沙箱：gpedit.msc 打开“计算机配置 -> 管理模板 -> Windows 组件 -> Windows 沙箱”，把“允许 Windows 沙箱”改为“未配置”或“已启用”。公司电脑尤其常见，域策略会把沙箱锁死。
- 第三方虚拟机软件冲突：VMware、VirtualBox、部分安卓模拟器会占用虚拟化资源，或者为了性能自动关闭 Windows Hypervisor Platform。如果装了这些，先把它们退出（甚至卸载），重启后试一次。
- “优化”软件把 Hyper-V 服务禁用了：检查 services.msc 里 Hyper-V Virtual Machine Management 和相关服务是不是被改成了“禁用”，改成“自动”并启动。
第三方软件这块，我遇到过最奇葩的情况是某电竞外设的灯效软件自带了“系统性能优化”，会把虚拟化相关服务给拉停。所以如果你排查了一圈还找不到原因，不妨想想最近装了哪些偏门软件，逐个退出试试。不要高估普通软件的自律性，尤其国产“安全卫士”“加速球”这一类的优化项，动服务是常有的事。
六种根因我按出现概率排过序，从系统版本、BIOS、可选功能这三个开始查，命中率很高。下面给一个可以在排查时对照的汇总：
| 根因 | 快速判断 | 修复动作 |
|---|---|---|
| 版本是家庭版 | winver 显示家庭版 | 升级专业版/企业版 |
| BIOS 虚拟化关闭 | 任务管理器显示“已禁用” | 进 BIOS 开启 VT-x/SVM |
| 功能未启用 | PowerShell 查询 State 为 Disabled | 启用沙箱/虚拟机平台/Hyper-V 并重启 |
| 组件损坏 | 其它都对但仍失败 | DISM + SFC，必要时重装沙箱功能 |
| 资源不足 | 内存<4G 或 C 盘空间紧张 | 关大程序、清理磁盘、恢复自动虚拟内存 |
| 策略/冲突 | 有组策略锁定、装了虚拟机软件 | 改策略、退出第三方虚拟化软件 |
4. 修复完成后的验证，以及我建议的笔记式检查单
4.1 手动启动 Windows 沙箱，先验证系统底座
修完别急着直接跑 Codex，建议先在开始菜单里搜“Windows Sandbox”手动打开一次。如果能正常弹出一个干净的桌面窗口，并能正常关闭，说明系统级沙箱已经完全可用了。到这一步，Codex 的初始化失败基本不会再出现。
如果手动启动也失败，说明问题仍在系统层，别去重装 Codex，继续回看第 3 节。如果手动启动成功、但 Codex 还是报错，那就回到 2.1 看日志，问题很可能出在 Codex 桌面版自己的配置或缓存上。手动启动 Windows 沙箱是个很好的“系统自检”手段，它能帮你把锅分清楚：到底是 Windows 的锅，还是 Codex 的锅。
4.2 重新走一遍 Codex 设置流程
系统沙箱验证通过后，关闭 Codex 桌面版再重新打开，点“继续完成 Windows 设置”。正常情况下它会很快完成初始化，进入主界面。如果中途还有报错，把报错时截图，再去看 .codex 日志目录里新增的日志文件。
另外，如果你之前做过“重装 Codex”的操作，建议卸载时把用户目录下的 .codex 配置缓存一起清掉，避免旧配置干扰新的初始化流程。我习惯的做法是：先卸载桌面版，再到%USERPROFILE%\下删除 .codex 文件夹，如果里面有你自己保存的配置文件，记得先备份。
清理这一步确实有人觉得没必要，但我遇到过一次很典型的情况：系统环境和沙箱都修好了，Codex 却还在用旧日志里的失败状态反复报错。清掉配置缓存后，它就像第一次安装一样走了完整初始化流程，问题立刻消失。这类“应用层残留状态”很隐蔽，值得记一笔。
4.3 一份可以直接保存的检查清单
下面是我总结的检查清单，建议按顺序过：
- winver 确认版本属于专业版/企业版/教育版；
- 任务管理器确认“虚拟化：已启用”；
- PowerShell 确认 Windows 沙箱、虚拟机平台、Hyper-V 功能 State 是 Enabled；
- 确认 Hyper-V 相关服务是“自动”运行，没被禁用；
- 确认 C 盘剩余空间至少 1GB，内存不少于 4GB；
- 存在第三方虚拟化/优化软件时，先退出再试。
以后遇到类似“XX 初始化失败”的提示，这套思路也能复用：先查硬件虚拟化，再查系统功能，再查服务和资源，最后再怀疑应用本身。顺序很重要，倒过来排查会浪费大量时间。而且每一次检查最好把结果记下来，别凭感觉判断，因为这类问题往往不是单一原因，可能是“虚拟化没开”加“功能没启”两个因素叠在一起，修完一个还失败，继续往下修另一个，直到清单全部打勾。
最后说一句实在话：Windows 版 Codex 报“Windows 沙箱初始化失败”，绝大多数情况都不是 Codex 的问题，而是 Windows 的虚拟化环境没准备好。我这次最耗时的一步反而是最初的重装操作，完全属于无用功。你按文里的顺序从上往下过一遍，大概率半小时内解决。如果哪一步你觉得环境对不上，或者想聊聊自己的排查经历，也可以在评论区留言，我看到了都会回。祝各位把沙箱顺利跑起来，后面用 Codex 写代码才会真的省心。
