前阵子帮朋友处理一台刚装好 Codex 桌面版的 Windows 机器登录账号之后界面卡在“继续完成 Windows 设置”点下去就弹出一个让人摸不着头脑的提示“Windows 沙箱初始化失败”。这台机器配置不差、系统也是最新的 Windows 11但偏偏就是走不完这一步。后来花了一晚上把操作系统层面翻了一遍才发现这类问题根本不是 Codex 的 bug绝大多数是 Windows 自身的“沙箱能力”没满足条件。这篇文章就把完整排查思路和修复步骤写下来给卡在这一步的人一个可直接照做的路线图同时也能帮你搞清楚 Codex 在 Windows 上究竟需要系统提供哪些底层能力。无论你是刚接触 Codex 的小白还是被同事拉去救火的运维这套流程都能用得上。1. 先搞清楚这个报错背后到底缺了什么1.1 Codex 桌面版在 Windows 上初始化时干了什么Codex 桌面版不是简单的聊天界面。装好后它会尝试在本地准备一个隔离的工作环境用于后续生成代码、运行诊断命令、做文件层面的操作等等。这个隔离环境在 Windows 上的实现依赖系统自带的沙箱和虚拟化能力而不是应用自己单独写一套。所以无论 Codex 内部把这一步叫“继续完成 Windows 设置”还是别的名字本质都是在调用 Windows 的沙箱基础组件。如果 Windows 系统本身没有准备这些组件比如沙箱功能没安装、虚拟化被关闭、相关服务被禁用Codex 的初始化动作就会失败然后对外表现成标题里的那句提示。换句话说这个问题的主战场在操作系统不在 Codex 配置。你先别急着卸载重装 Codex那样解决不了任何问题。1.2 为什么一句“初始化失败”能直接把流程卡死因为 Codex 把沙箱初始化当成“继续完成设置”的前置条件它不指望用户在没完成这一步时能进入主界面。失败之后界面停留在原页面既不能直接跳过也没有给出更细的原因提示。这种设计在追求安全性时是合理的——毕竟它后续要在一个隔离环境里执行大量不可信操作如果环境的底层依赖没就绪放你进去反而容易出问题——但对使用者来说就很不友好排查时只能靠系统层面去反推。我见过不少人在这一步反复折腾有的甚至把系统重置了结果重新走到这里还是一样报错。其实只要理解了“沙箱初始化”在系统层面的完整依赖链修复思路就非常清晰。接下来要做的就是把这个依赖链一层层检查过去。1.3 从报错反推6 个大概率原因我一般按概率从高到低排查Windows 沙箱功能根本没启用。这是最常见的一种默认情况下很多系统镜像并不会开启这个功能。系统版本不支持。Windows 沙箱只在专业版、企业版、教育版上提供家庭版和家庭中文版默认不支持。CPU 虚拟化没开启。BIOS 里的 Intel VT-x 或 AMD SVM 被关闭沙箱起不来。支撑功能缺失。“虚拟机平台”“Windows 虚拟机监控程序平台”等底层组件没安装。Hyper-V 相关服务被禁用或状态异常。vmcompute、vmms 等服务没跑起来。资源或策略限制。磁盘剩余空间不足、内存过小、企业组策略禁用沙箱、权限不足。这些原因之间还经常叠加比如虚拟化关了的时候去启用 Windows 沙箱功能可能装得上但初始化一定失败。所以下面做“系统体检”时我会把这几个维度一次全部查清楚而不是单点出击。修完一步就回头点一次 Codex 的“继续完成 Windows 设置”这样能快速排除问题链路。2. 动手前先做系统体检判断 Windows 到底能不能跑沙箱2.1 先确认系统版本和版本类型打开“设置 - 系统 - 系统信息”或按Win R输入winver就能看到系统版本和版本类型。关键看两处版本号不低于 Windows 10 1903Windows 11 的话基本没问题。系统类型是专业版、企业版或教育版而不是家庭版。如果显示家庭中文版那基本可以判死刑了。不是不能装 Codex而是 Windows 沙箱在家庭版上不可用你需要在系统层面先解决版本问题或者走替代路线比如用 Codex CLI 继续工作。别在家庭版上硬磕 Windows Sandbox这个功能微软压根没开放给家庭版。市面上有些“升级到专业版”的镜像或工具具体合规性我不好评价但从技术角度讲版本类型直接决定你有没有这个功能选项。这里我做一张表帮助判断系统版本是否支持 Windows 沙箱说明Windows 10/11 家庭版不支持功能列表里看不到“Windows 沙箱”Windows 10/11 专业版支持需手动启用并满足虚拟化要求Windows 10/11 企业版/教育版支持企业版可能被组策略禁用Windows Server支持通常需要额外配置2.2 用 systeminfo 和 msinfo32 快速验证虚拟化状态虚拟化是否就绪两条命令基本能判断。第一条管理员权限打开 PowerShell 或 CMD运行systeminfo在输出末尾找“Hyper-V 要求”那一行。如果看到“已检测到虚拟机监控程序。将不显示 Hyper-V 所需的功能。”说明 Hypervisor 已经在运行虚拟化没问题。如果看到“虚拟化已启用”或者“固件中已启用虚拟化是”但下方提示“Hyper-V 未安装”就说明 CPU 虚拟化是开的但缺少 Hyper-V 相关功能。第二条按Win R输入msinfo32打开系统信息在“系统摘要”底部看“基于虚拟化的安全性”和“已检测到的虚拟机监控程序”这两项。正常状态下虚拟化相关条目应该是“是”。这里有个容易误判的点如果机器本身就跑在虚拟机里比如 VMware、VirtualBox 里装的 Windows沙箱能不能用还要看宿主机是否开启了嵌套虚拟化。大多数情况下虚拟机里再开 Windows 沙箱会因为嵌套虚拟化未开启而失败。这个细节放到后面第 5 节单独展开。2.3 沙箱依赖的底层组件关系Windows 沙箱不是独立存在的它底层依赖一整套虚拟化支撑。我把关键组件列成一张关系表方便你对照组件作用缺失影响Windows 沙箱顶层功能提供隔离桌面环境功能不存在报初始化失败虚拟机平台提供虚拟机对象管理能力沙箱装不上或起不来Windows 虚拟机监控程序平台暴露 Hyper-V 接口给应用安全隔离层无法建立Hyper-V Host Compute Service (vmcompute)管理容器和 VM 的运行时服务沙箱进程无法启动Hyper-V Virtual Machine Management (vmms)管理虚拟机的生命周期沙箱镜像无法加载一句话总结这一套东西就像一个“套娃”顶层是沙箱中间是虚拟机平台底层是 Hypervisor 服务。任何一层断了最后都表现为沙箱初始化失败。所以体检阶段只要发现某一层有问题后面修复阶段就优先处理那一层。3. 修复操作全流程一步步把沙箱从禁用状态拉起来3.1 优先在 BIOS 里打开虚拟化开关先处理最容易忽略但影响面最大的环节BIOS 层面的虚拟化开关。重启机器在开机画面按Del、F2、F10或F12进入 BIOS Setup。不同品牌快捷键不一样开机画面一般有提示。找到类似Intel Virtualization Technology、VT-x、AMD SVM Mode或Virtualization Extensions的选项把它从Disabled改成Enabled保存退出。不同品牌位置大概是这样戴尔System Configuration - Virtualization Support联想Security - Virtualization惠普Advanced - Processor Options华硕、微星等主板Advanced Mode - CPU Configuration笔记本尤其容易出现这个选项默认关闭的情况台式机反而少。改完开机进入系统后再用msinfo32确认虚拟化状态已经变成“是”。记住这一步操作后要彻底关机再开机有些机器热重启不会正确刷新固件设置我就遇到过设置了 VT-x 但热启动后依然不生效的怪事。BIOS 改完不用急着往下看直接打开 Codex 试一次。如果还失败就继续下面的功能启用步骤。3.2 启用 Windows 沙箱功能和两个底层平台如果系统版本支持就打开“启用或关闭 Windows 功能”。按Win R输入optionalfeatures弹窗里勾选以下三项Windows 沙箱虚拟机平台Windows 虚拟机监控程序平台勾选后点击确定系统会开始安装相关组件。装完后大概率要求重启这就要听它的重启后再看沙箱状态。你也可以用管理员 PowerShell 来启用方便批量操作Enable-WindowsOptionalFeature -Online -FeatureName Containers-DisposableClientVM -All -NoRestart Enable-WindowsOptionalFeature -Online -FeatureName VirtualMachinePlatform -All -NoRestart Enable-WindowsOptionalFeature -Online -FeatureName HypervisorPlatform -All -NoRestart-NoRestart只是告诉你它不会立刻重启这几个命令跑完后自己重启一次。如果某个功能已经启用命令会提示状态已经是 Enabled不影响后续。重启后用管理员 PowerShell 确认一下状态Get-WindowsOptionalFeature -Online -FeatureName Containers-DisposableClientVM Get-WindowsOptionalFeature -Online -FeatureName VirtualMachinePlatform Get-WindowsOptionalFeature -Online -FeatureName HypervisorPlatform看到 State 都是 Enabled 就说明功能层没问题了。这里有个小细节勾选功能时如果系统报“Windows 找不到所需的文件”之类的错说明系统镜像可能被精简过或者更新补丁不完整。这种情况先不要反复点功能开关直接跳到 3.4 做 DISM 修复把镜像基础修好再回来启用功能。3.3 检查并重启 Hyper-V 相关服务功能装上之后沙箱运行时依赖的 Host Compute Service 也得正常工作。用管理员 PowerShell 查看Get-Service vmcompute Get-Service vmms正常状态下这两个服务应该是Running启动类型为Automatic。如果发现状态是Disabled或Stopped执行Set-Service vmcompute -StartupType Automatic Start-Service vmcompute Set-Service vmms -StartupType Automatic Start-Service vmms如果服务启动失败先别急着反复点启动去“事件查看器”里看Microsoft-Windows-Hyper-V-Compute或Hyper-V-VMMS的日志通常能翻到具体失败原因。最常见的两个一是虚拟化仍未生效二是上一次异常关机导致状态残留。后者重启一次系统基本能自愈。还需要检查 Hypervisor 是否随系统启动。管理员 PowerShell 或 CMD 运行bcdedit /enum | findstr hypervisorlaunchtype看到hypervisorlaunchtype是Off的话需要执行bcdedit /set hypervisorlaunchtype auto然后重启。这个设置控制 Windows 虚拟机监控程序是否随系统启动。注意bcdedit /set操作要谨慎别去动其他启动项只改 hypervisorlaunchtype 就够了。3.4 用 DISM 和 SFC 修复受损组件如果功能装不上、服务起不来、沙箱初始化还是失败大概率是系统组件已经损坏或者精简镜像缺了东西。这时候跑两遍系统自带的修复工具成本低且经常有效。先用管理员权限打开 CMD 或 PowerShell运行DISM /Online /Cleanup-Image /RestoreHealth这个命令会把系统映像里的损坏部分从 Windows Update 或其他源修复。跑完后再执行sfc /scannowsfc /scannow负责检查并修复系统文件的完整性。两条命令都有耗时的心理准备DISM 可能会卡很久中途别强制关窗口。跑完重启再回到 Codex 试一次。这里我也提醒一下如果你用的是某些论坛的精简版系统镜像或者用了不少“优化工具”关闭了很多系统组件即使 DISM 和 SFC 跑完也未必能恢复完整的沙箱依赖。这种情况下最省心的办法是换一个未做深度精简的安装包重装系统或者直接在原版 ISO 基础上叠加修复。3.5 踩到组策略和权限坑时的处理如果前面全部正常但沙箱还是初始化失败就要考虑组策略和权限这两类特殊原因。组策略层面打开gpedit.msc依次定位到计算机配置 - 管理模板 - Windows 组件 - Windows 沙箱看“允许 Windows 沙箱”这个策略是不是被设成了“已禁用”。如果是改成“未配置”或“已启用”然后管理员 CMD 执行gpupdate /force刷新策略。注意本地策略在自己机器上随便改没问题但如果这台电脑是企业域环境且策略由域控下发本地改完重启后仍会被覆盖这时候得找管理员放开策略。权限层面你可以试试用管理员身份运行 Codex 桌面版。右键图标选择“以管理员身份运行”然后重新点“继续完成 Windows 设置”。沙箱的初始化过程需要创建临时虚拟设备和网络配置普通用户权限下偶尔会失败尤其是开了 UAC 且账户是标准用户的情况下。另外如果是 Windows 版本较老或补丁状态很旧的机器我给一个补充建议先运行一遍 Windows Update把累积更新打满再重新执行上述步骤。有不少沙箱初始化失败实际是补丁缺失导致的已知问题修复还没到位。4. 修好沙箱后让 Codex 重新走完设置流程4.1 清除 Codex 的失败状态避免旧配置干扰系统层面的沙箱修好后Codex 自己可能还残留着上次失败的初始化记录导致界面虽然还停在“继续完成 Windows 设置”但再次点击仍然报同样的错。这是很常见的情况很多人修完系统后在这里被坑了一下。先彻底退出 Codex托盘图标也记得右键退出。然后打开注册表编辑器regedit在路径HKEY_CURRENT_USER\Software\OpenAI下看看有没有跟 setup 状态、初始化标记相关的键值。如果你不确定哪个值是干什么的最稳妥的做法是备份后删除整个OpenAI项让应用下次启动时重新生成默认配置。删除前记得备份注册表右键项选“导出”。如果你不想动注册表也可以尝试在应用设置里找“重置”“重新开始设置”之类的入口。有些版本的 Codex 桌面版把重新初始化入口做在了设置页底部不显眼但存在。实在找不到入口卸载 Codex 之后把%LOCALAPPDATA%\OpenAI和%APPDATA%\OpenAI目录清理干净再重新安装效果等同于完全重置。4.2 重新执行“继续完成 Windows 设置”的顺序与验证清理干净后以管理员身份重新启动 Codex 桌面版。这次点“继续完成 Windows 设置”沙箱初始化应该能正常走完。正常过程中你可能会看到短暂的“正在初始化环境”“正在准备沙箱”之类提示甚至看到桌面闪烁一下、弹出一个小的隔离窗口这些都是沙箱正在拉起来的表现。如果你想知道沙箱到底有没有真的可用可以在启用成功后单独测试 Windows 沙箱按Win R输入WindowsSandbox.exe或直接在开始菜单搜索“Windows Sandbox”并启动。如果系统沙箱能正常打开一个孤立的桌面窗口说明 Codex 的初始化条件已经满足。这样一个独立验证步骤能帮你把“系统问题”和“Codex 问题”快速区分开。如果沙箱单独能启动但 Codex 依然初始化异常那这时候需要看 Codex 自己的日志。到%LOCALAPPDATA%\OpenAI或%APPDATA%\OpenAI目录找应用日志文件搜关键词sandbox、virtual、error。日志一般会指出是权限、虚拟化服务还是磁盘空间哪一环出了问题。把日志里最关键的那几行记下来后续不管是自己排查还是去问人都会高效很多。4.3 常见变体报错速查表实际操作中即使核心原因一样界面提示也会因为环境不同出现各种变体。根据我遇到的情况整理了一张速查表报错现象大概率原因处理方式Windows 沙箱初始化失败且功能列表中无“Windows 沙箱”系统版本为家庭版或功能未启用确认版本专业版则手动勾选启用沙箱初始化失败提示与虚拟化相关BIOS 虚拟化未开或未启用 Hypervisor开启 VT-x/SVM确认 hypervisor 已加载沙箱设置能勾选但重启后功能仍不可用补丁缺失或组件损坏DISM SFC 修复再安装累积更新初始化失败事件日志里 vmcompute 报错服务被禁用或残留状态恢复服务自动启动必要时重启系统初始化失败磁盘空间不足沙箱临时镜像生成失败清理 C 盘空间至少保留 5GB初始化失败报权限相关标准用户运行管理员身份运行 Codex这张表不追求覆盖所有稀奇古怪的报错但覆盖了绝大多数踩坑现场。你的报错如果不在表里先回到第 2 节重新做一遍体检大概率能找到直接原因。5. 几个容易被忽略的坑和我的最终体会5.1 一些真实环境里容易翻车的细节处理了这么多次类似问题时有几个细节我需要额外提醒。第一个虚拟机里装 Windows 再跑 Codex 沙箱。如果你当前 Windows 跑在 VMware 或 VirtualBox 上沙箱初始化大概率会继续失败除非你在虚拟机设置里开启了“嵌套虚拟化”。VMware 要勾选“虚拟化 Intel VT-x/EPT 或 AMD-V/RVI”VirtualBox 要在 系统 - 加速 里勾选“启用嵌套 VT-x/AMD-V”。这个选项默认关闭但很多人不知道检查的时候特别容易漏掉。第二个不要在启用沙箱功能的过程中强制关机。optionalfeatures安装组件时哪怕进度条看起来卡住不动也请耐心等。中断安装很容易让功能列表处于半启用状态表现出来就是“功能勾了但状态未就绪”后面怎么修复都别扭。到时候你可能不得不回来再跑一遍 DISM白白浪费时间。第三个清理磁盘空间要算上沙箱的临时需求。Windows 沙箱在启动时会把系统镜像映射到临时目录磁盘越满越容易失败。别以为剩一两个 GB 就能跑建议给系统盘留 5GB 以上的余量。另外如果系统盘是 SSD 且剩余空间经常告警顺手清理一下休眠文件和旧的 Windows 更新缓存往往能腾出意料之外的空间。第四个某些杀毒软件或系统优化工具可能会禁用 Windows 沙箱所需的服务或者把虚拟化相关驱动当成风险项拦截。遇到“功能都开了还是失败”的僵局试着临时关闭安全软件或把 Codex、WindowsSandbox.exe 加入白名单再测试。这个问题很少被想到但我在实际环境中确实撞到过一次。第五个如果所有修复做完Windows Sandbox 单独能启动但 Codex 桌面版依然卡在初始化可以考虑先用 Codex CLI 方式继续验证你的工作流。CLI 版本不依赖桌面版的设置初始化流程在 Windows 上同样能用至少能让你把账号、任务流程先跑通不必卡死在一个设置页面上。5.2 我的排障顺序建议最后给一个排序上的个人建议整套排查从成本最低的开始不要一上来重装系统。我的顺序是查看版本类型 - 检查虚拟化 - 启用功能 - 重启 - 检查服务 - 修组件 - 查策略 - 清 Codex 状态。八成问题在“开启虚拟化 启用功能 重启”这三步内就能解决剩下两成才需要深入系统修复。我自己处理这类问题最深的一个体会是Codex 的报错文案虽然简陋但它其实把排查范围缩小得很明确——它直说的是 Windows 沙箱那就先别怀疑 Codex 本身。只要系统层满足沙箱条件设置流程基本就能顺畅通过。后续如果你还遇到沙箱能启动但 Codex 初始化还是异常的怪事能记录一下事件查看器里的具体日志排障会轻松很多。说到底这类初始化问题就是一层层依赖链路的问题把每一层的状态确认一遍答案就会自己浮出来。