很多朋友第一次在 Windows 上安装 Codex 桌面版时都卡在同一个地方界面提示点击“继续完成 Windows 设置”点了之后没多久就弹出“Windows 沙箱初始化失败”然后整个安装流程直接中断。我第一次遇到这个报错也懵了一下Codex 一个编程工具怎么和 Windows 沙箱扯上关系了后来翻了一圈官方文档和社区反馈才发现这其实是 Codex 桌面版在 Windows 上的一种隔离启动机制它借用了 Windows 沙箱Windows Sandbox来创建一个干净的、一次性的环境去完成初始配置和安全性验证。也就是说沙箱起不来Codex 的设置流程就没法走完。这篇文章我就从底层机制讲起把这一类“Windows 沙箱初始化失败”的常见诱因、排查顺序和修复方法完整梳理一遍照着做基本都能解决。1. 为什么 Codex 非要依赖 Windows 沙箱1.1 Codex 桌面版与沙箱的关系我第一次看到这个报错时直觉反应是 Codex 的安装包有问题重装了几次都一样。后来才反应过来这个弹窗根本不是在安装 Codex而是 Codex 在启动时尝试拉起 Windows 沙箱来完成系统级的环境初始化。Windows 沙箱是微软提供的一个轻量虚拟机它和 Hyper-V 共享虚拟化底层但使用方式完全不同每次启动都是一张“白纸”关闭后所有痕迹全部丢弃。Codex 把“继续完成 Windows 设置”这个环节放进沙箱里执行目的很明确。AI 编程工具要读取代码、执行命令行、甚至调用本地编译器如果直接在主系统环境里跑那些初始化脚本可能会因为用户已有的开发环境、环境变量、第三方安全软件而产生冲突。放在沙箱里跑Codex 可以让每一步都在一个干净的 Windows 环境中验证拿到一份不受宿主干扰的“体检报告”再决定接下来怎么配置。这个思路本身没问题问题在于 Windows 沙箱对宿主机的硬件和系统功能有硬性要求很多人的电脑天生就不满足于是初始化直接失败。1.2 Windows 沙箱的运行条件Windows 沙箱不是一个普通软件装上就能用。它依赖三个底层能力CPU 虚拟化VT-x 或 AMD-V、Hyper-V 平台组件、以及沙箱本身的容器服务。这三者缺一不可而且不是“能用就行”那么简单。CPU 虚拟化需要在 BIOS/UEFI 里开启很多品牌机出厂默认是关着的Hyper-V 平台组件属于 Windows 可选功能某些精简版系统或 Ghost 版系统干脆没集成沙箱服务如果被组策略禁用也会出现初始化失败。还有个容易被忽略的点是内存。微软官方对 Windows 沙箱的最低要求是 4GB 可用内存但这只是“能开机”的水平。Codex 在沙箱里要执行配置脚本沙箱本身占掉 1~2GBCodex 再占一部分如果宿主机内存本身就吃紧沙箱虚拟机的内存分配就会失败这时候报错可能不是“初始化失败”而是直接黑屏或闪退。所以排查的时候别只盯着一行错误提示硬件资源也要一起看。2. 四步快速定位到底卡在哪一层2.1 先看 CPU 虚拟化是否真正开启排查的第一步不是改任何设置是确认 CPU 虚拟化到底开没开。怎么判断打开任务管理器切到“性能”选项卡选择 CPU看右下角“虚拟化”这一项显示“已启用”说明 CPU 虚拟化是打开的显示“已禁用”就是 BIOS 里没开这是沙箱初始化失败的头号原因。这里有个容易误判的地方。很多人装了 VMware、VirtualBox 或者安卓模拟器这些软件自己带一套软件虚拟化技术在系统里显示为“虚拟化已启用”但那其实是第三方软件的虚拟化层不一定代表 Windows 自带的 Hyper-V 平台能用。最可靠的验证方式是直接去“启用或关闭 Windows 功能”里看 Hyper-V 相关选项的状态或者通过 PowerShell 执行以下命令systeminfo | findstr /I Hyper-V如果输出里能看到 Hyper-V 的要求列表并且每一项后面都写着“已检测到”说明硬件和固件层面是合格的如果显示“Hyper-V 要求: 已检测到虚拟机监控程序。将不显示 Hyper-V 所需的功能”那意味着系统里已经跑着一个虚拟机监控程序比如 Hyper-V 或 Windows 沙箱了反而是好事说明底层是通的。2.2 检查系统版本与 Windows 功能状态Windows 沙箱不是所有 Windows 版本都有。家庭版默认不包含沙箱功能专业版、企业版、教育版才支持。如果你装的是家庭版那么无论如何都打不开沙箱报错也是一样。这时候要么升级系统版本要么想办法让 Codex 跳过沙箱检测。确认系统版本方法WinR 输入 winver看弹出的窗口里是“家庭版”还是“专业版”。如果是专业版但沙箱还失败就去“控制面板 - 程序 - 启用或关闭 Windows 功能”找到“Windows 沙箱”这一项看看它是否处于勾选状态。在大量品牌机里这个功能默认就是没勾的就算你是专业版也得手动开启一次。2.3 确认 Hyper-V 平台是否完整Windows 沙箱的底层是 Hyper-V但很多人不知道Hyper-V 其实是一组功能的合集。要正常运行沙箱以下三项必须全部启用“Hyper-V”、“虚拟机平台”、“Windows 沙箱”。只勾了最后一个前面两个没开照样初始化失败。这个问题的隐蔽性在于Windows 功能面板里勾选“Windows 沙箱”时有时会自动带上“虚拟机平台”但有时候又不会特别是系统版本比较旧或者被第三方工具精简过的情况。更麻烦的是Windows Defender 的内核隔离、内存完整性等功能也会影响 Hyper-V 的可用性。如果开启了“内核隔离”但 Hyper-V 平台不完整就会出现互相打架的情况。我的建议是直接打开 Windows 功能面板把这三项全部打勾然后重启。2.4 内存与磁盘空间的隐性要求最后检查一下系统资源。Windows 沙箱启动时会预分配一部分内存如果宿主机当前可用内存低于 3~4GB沙箱虚拟机的启动就会失败。还有一点经常被忽略Windows 沙箱需要约 1GB 的磁盘空间用于创建临时虚拟磁盘而且要求这个空间必须在系统盘上。如果你的 C 盘快满了或者用了第三方“虚拟内存清理工具”把临时目录清理得过于干净沙箱创建虚拟磁盘时会报“初始化失败”。我见过一个案例C 盘剩余空间只有 700MBCodex 每次点击都是秒报错清理完磁盘后一切正常。所以排查的时候C 盘剩余空间也是硬指标别只看内存。3. 从命令行彻底修复不重装系统的完整方案3.1 用 PowerShell 一步到位开启沙箱图形界面勾选功能的方式并不是每次都有效特别是系统功能组件损坏时勾了也会取消。我推荐直接用管理员权限的 PowerShell 执行命令这种方式更底层可以绕过图形界面的很多隐性限制。在“开始菜单”搜索 PowerShell右键“以管理员身份运行”然后执行这一条Enable-WindowsOptionalFeature -Online -FeatureName Containers-DisposableClientVM -All -NoRestart这条命令的作用是启用 Windows 沙箱服务其中 Containers-DisposableClientVM 就是沙箱对应的功能名称。执行完以后它会自动把 Hyper-V 和虚拟机平台等依赖项一并装好。注意最后那个 -NoRestart加上它表示暂不重启方便你继续执行下面的命令。如果要一次操作到位也可以去掉 -NoRestart让它重启完成后自动生效。执行完后再到“Windows 功能”面板里看一眼确认“Windows 沙箱”这一项已经打勾。有时候命令行装好了图形界面还没刷新重新打开面板或者重启一次即可。3.2 手动清理沙箱残留缓存如果功能已经启用但还是初始化失败那就要考虑是不是沙箱的缓存文件出了问题。Windows 沙箱会缓存一份基础系统镜像在 C 盘如果这个镜像文件损坏每次启动都会失败。清理方法很简单先打开服务管理器停止沙箱相关服务然后删除缓存目录。默认情况下沙箱的缓存路径在这里C:\Windows\System32\WindowsSandbox\BaseImages删除这个目录下的所有内容然后重新启动沙箱系统会重新生成一份基础镜像。这个操作不会影响宿主机的任何数据沙箱本来就是一次性的放心删。删除前最好先确认没有正在运行的沙箱进程否则文件被占用会删不掉。用任务管理器查看 WindowsSandbox.exe 是否在运行在的话先结束进程再删。3.3 避开第三方安全软件的拦截还有一个实际遇到很多的问题第三方安全软件把沙箱进程当成可疑行为拦截了。尤其是一些带“主动防御”功能的安全软件对沙箱这种动态创建执行环境的操作非常敏感会阻止它启动。判断方法是暂时退出安全软件然后手动启动一次 Windows 沙箱WinR 输入 WindowsSandbox.exe试试。如果可以正常打开问题就坐实了。解决方式不是卸载安全软件而是在它的规则设置里把 WindowsSandbox.exe 和 Codex 的安装目录加入白名单。国产安全软件一般叫“信任区”或“排除项”加入后就不用每次都退出防护了。4. Codex 与沙箱集成的专项注意事项4.1 Codex 启动沙箱的机制与常见误导项Codex 调用沙箱不是单纯启动一个虚拟机窗口那么简单。它会在沙箱里挂载一些虚拟盘通过虚拟网络与宿主通信并在沙箱内部执行一系列 PowerShell 脚本。这个机制导致一个现象就算你的 Windows 沙箱可以独立启动Codex 调用时也有可能失败。原因在于 Codex 对沙箱版本有要求太老的 Windows 10 沙箱版本缺少某些内部接口Codex 连接不上就会返回“初始化失败”。所以我的建议是先把 Windows 系统更新到最新确保沙箱组件是最新版。Windows 10 用户至少要保证系统版本在 18362 以上Windows 11 用户就方便多了直接更新到最新即可。4.2 Codex 登录与组织设置加载问题的连带关系初始化失败这个问题如果不去解决而是一味地重试或跳过会引发一连串问题。社区里很多人反映Codex 初始化失败后登录会卡住或者登录成功后组织设置加载不出来。原因很简单Codex 在沙箱里生成的临时凭证没有正常回写宿主端的 Codex 看到的是一个未完成的状态。处理办法是在解决沙箱问题后删除 Codex 本地的缓存配置文件让它重新走一遍初始化流程。Codex 的缓存文件通常在用户的 AppData 目录下%LOCALAPPDATA%\Codex直接把整个 Codex 文件夹删掉然后重新打开 Codex。它会在沙箱里重新生成一份凭证和配置这次只要沙箱正常整个流程就会顺利很多。4.3 命令行增强用日志定位失败根因有时候报错信息太笼统看不出具体原因。考验耐心的时刻就到了看日志。Codex 在 Windows 上会输出运行日志位置在这个路径%LOCALAPPDATA%\Codex\logs打开最新的日志文件搜索“sandbox”“error”“fail”这几个关键词能看到具体的失败原因。常见错误大致有这么几类沙箱服务未运行错误信息里会出现 Service Not Found虚拟化支持缺失错误信息里会出现 Hyper-V 或 virtualization权限不足错误信息里会出现 Access Denied磁盘空间不足错误信息里会出现 Disk Space。这些关键词能帮你快速定位方向省得瞎猜。5. 常见问题与排查技巧速查这里把我在实际过程中遇到过的典型问题整理成了一个速查表方便遇到同样情况的朋友快速定位表现常见原因优先做法点击后 1 秒内报错CPU 虚拟化未开启进 BIOS/UEFI 打开 VT-x/AMD-V报错但沙箱可独立启动Codex 缓存损坏删除 %LOCALAPPDATA%\Codex日志提示 Hyper-V 相关错误Hyper-V 组件不完整命令行启用 Containers-DisposableClientVM沙箱打开就黑屏或闪退内存不足或显卡虚拟化不兼容增加可用内存更新显卡驱动报错且系统盘空间很小临时虚拟磁盘创建失败清理 C 盘至 5GB 以上安全软件弹出拦截提示主动防御拦截沙箱将 WindowsSandbox.exe 加入白名单还有一些细节需要单独提一下。如果你用的是笔记本需要去 BIOS 里把开关英文名认全Intel 平台叫 Intel Virtualization Technology或 VT-xAMD 平台叫 SVM Mode。在部分联想和戴尔的笔记本上这个选项默认是 Disabled而且藏在比较深的子菜单里。再一个坑就是旧版虚拟机软件的冲突。Windows 沙箱用了 Hyper-V而 VMware Workstation 15.5 以下版本与 Hyper-V 不共存。如果你电脑里装的是老版本 VMware就会出现沙箱和虚拟机“抢地盘”的情况解决办法是升级 VMware 到 16 以上版本或者干脆把 Hyper-V 打开后改用 Hyper-V 虚拟机。有一点需要特别提醒Windows 沙箱每次启动都需要重新初始化所以第一次启动会比较慢很多人以为是卡死了其实是在等待。如果有耐心等 30 秒到一分钟是比较正常的。Codex 的沙箱初始化也是一个道理我遇到过等得久然后突然弹出需要重启的情况这不是失败重启完继续走就好。我个人的操作习惯是先跑一次系统信息检查命令确认硬件支持再用管理员 PowerShell 开启功能重启后手动测一次 Windows 沙箱能不能打开最后才去启动 Codex。按照这个顺序问题出现的概率能降到最低。很多人在社区里问 Codex 一直无法加载组织设置怎么办其实多半也是沙箱初始化这个老问题在前面挡着路。底层通了后续全都顺了。
Windows沙箱初始化失败？Codex安装排查与修复指南
很多朋友第一次在 Windows 上安装 Codex 桌面版时都卡在同一个地方界面提示点击“继续完成 Windows 设置”点了之后没多久就弹出“Windows 沙箱初始化失败”然后整个安装流程直接中断。我第一次遇到这个报错也懵了一下Codex 一个编程工具怎么和 Windows 沙箱扯上关系了后来翻了一圈官方文档和社区反馈才发现这其实是 Codex 桌面版在 Windows 上的一种隔离启动机制它借用了 Windows 沙箱Windows Sandbox来创建一个干净的、一次性的环境去完成初始配置和安全性验证。也就是说沙箱起不来Codex 的设置流程就没法走完。这篇文章我就从底层机制讲起把这一类“Windows 沙箱初始化失败”的常见诱因、排查顺序和修复方法完整梳理一遍照着做基本都能解决。1. 为什么 Codex 非要依赖 Windows 沙箱1.1 Codex 桌面版与沙箱的关系我第一次看到这个报错时直觉反应是 Codex 的安装包有问题重装了几次都一样。后来才反应过来这个弹窗根本不是在安装 Codex而是 Codex 在启动时尝试拉起 Windows 沙箱来完成系统级的环境初始化。Windows 沙箱是微软提供的一个轻量虚拟机它和 Hyper-V 共享虚拟化底层但使用方式完全不同每次启动都是一张“白纸”关闭后所有痕迹全部丢弃。Codex 把“继续完成 Windows 设置”这个环节放进沙箱里执行目的很明确。AI 编程工具要读取代码、执行命令行、甚至调用本地编译器如果直接在主系统环境里跑那些初始化脚本可能会因为用户已有的开发环境、环境变量、第三方安全软件而产生冲突。放在沙箱里跑Codex 可以让每一步都在一个干净的 Windows 环境中验证拿到一份不受宿主干扰的“体检报告”再决定接下来怎么配置。这个思路本身没问题问题在于 Windows 沙箱对宿主机的硬件和系统功能有硬性要求很多人的电脑天生就不满足于是初始化直接失败。1.2 Windows 沙箱的运行条件Windows 沙箱不是一个普通软件装上就能用。它依赖三个底层能力CPU 虚拟化VT-x 或 AMD-V、Hyper-V 平台组件、以及沙箱本身的容器服务。这三者缺一不可而且不是“能用就行”那么简单。CPU 虚拟化需要在 BIOS/UEFI 里开启很多品牌机出厂默认是关着的Hyper-V 平台组件属于 Windows 可选功能某些精简版系统或 Ghost 版系统干脆没集成沙箱服务如果被组策略禁用也会出现初始化失败。还有个容易被忽略的点是内存。微软官方对 Windows 沙箱的最低要求是 4GB 可用内存但这只是“能开机”的水平。Codex 在沙箱里要执行配置脚本沙箱本身占掉 1~2GBCodex 再占一部分如果宿主机内存本身就吃紧沙箱虚拟机的内存分配就会失败这时候报错可能不是“初始化失败”而是直接黑屏或闪退。所以排查的时候别只盯着一行错误提示硬件资源也要一起看。2. 四步快速定位到底卡在哪一层2.1 先看 CPU 虚拟化是否真正开启排查的第一步不是改任何设置是确认 CPU 虚拟化到底开没开。怎么判断打开任务管理器切到“性能”选项卡选择 CPU看右下角“虚拟化”这一项显示“已启用”说明 CPU 虚拟化是打开的显示“已禁用”就是 BIOS 里没开这是沙箱初始化失败的头号原因。这里有个容易误判的地方。很多人装了 VMware、VirtualBox 或者安卓模拟器这些软件自己带一套软件虚拟化技术在系统里显示为“虚拟化已启用”但那其实是第三方软件的虚拟化层不一定代表 Windows 自带的 Hyper-V 平台能用。最可靠的验证方式是直接去“启用或关闭 Windows 功能”里看 Hyper-V 相关选项的状态或者通过 PowerShell 执行以下命令systeminfo | findstr /I Hyper-V如果输出里能看到 Hyper-V 的要求列表并且每一项后面都写着“已检测到”说明硬件和固件层面是合格的如果显示“Hyper-V 要求: 已检测到虚拟机监控程序。将不显示 Hyper-V 所需的功能”那意味着系统里已经跑着一个虚拟机监控程序比如 Hyper-V 或 Windows 沙箱了反而是好事说明底层是通的。2.2 检查系统版本与 Windows 功能状态Windows 沙箱不是所有 Windows 版本都有。家庭版默认不包含沙箱功能专业版、企业版、教育版才支持。如果你装的是家庭版那么无论如何都打不开沙箱报错也是一样。这时候要么升级系统版本要么想办法让 Codex 跳过沙箱检测。确认系统版本方法WinR 输入 winver看弹出的窗口里是“家庭版”还是“专业版”。如果是专业版但沙箱还失败就去“控制面板 - 程序 - 启用或关闭 Windows 功能”找到“Windows 沙箱”这一项看看它是否处于勾选状态。在大量品牌机里这个功能默认就是没勾的就算你是专业版也得手动开启一次。2.3 确认 Hyper-V 平台是否完整Windows 沙箱的底层是 Hyper-V但很多人不知道Hyper-V 其实是一组功能的合集。要正常运行沙箱以下三项必须全部启用“Hyper-V”、“虚拟机平台”、“Windows 沙箱”。只勾了最后一个前面两个没开照样初始化失败。这个问题的隐蔽性在于Windows 功能面板里勾选“Windows 沙箱”时有时会自动带上“虚拟机平台”但有时候又不会特别是系统版本比较旧或者被第三方工具精简过的情况。更麻烦的是Windows Defender 的内核隔离、内存完整性等功能也会影响 Hyper-V 的可用性。如果开启了“内核隔离”但 Hyper-V 平台不完整就会出现互相打架的情况。我的建议是直接打开 Windows 功能面板把这三项全部打勾然后重启。2.4 内存与磁盘空间的隐性要求最后检查一下系统资源。Windows 沙箱启动时会预分配一部分内存如果宿主机当前可用内存低于 3~4GB沙箱虚拟机的启动就会失败。还有一点经常被忽略Windows 沙箱需要约 1GB 的磁盘空间用于创建临时虚拟磁盘而且要求这个空间必须在系统盘上。如果你的 C 盘快满了或者用了第三方“虚拟内存清理工具”把临时目录清理得过于干净沙箱创建虚拟磁盘时会报“初始化失败”。我见过一个案例C 盘剩余空间只有 700MBCodex 每次点击都是秒报错清理完磁盘后一切正常。所以排查的时候C 盘剩余空间也是硬指标别只看内存。3. 从命令行彻底修复不重装系统的完整方案3.1 用 PowerShell 一步到位开启沙箱图形界面勾选功能的方式并不是每次都有效特别是系统功能组件损坏时勾了也会取消。我推荐直接用管理员权限的 PowerShell 执行命令这种方式更底层可以绕过图形界面的很多隐性限制。在“开始菜单”搜索 PowerShell右键“以管理员身份运行”然后执行这一条Enable-WindowsOptionalFeature -Online -FeatureName Containers-DisposableClientVM -All -NoRestart这条命令的作用是启用 Windows 沙箱服务其中 Containers-DisposableClientVM 就是沙箱对应的功能名称。执行完以后它会自动把 Hyper-V 和虚拟机平台等依赖项一并装好。注意最后那个 -NoRestart加上它表示暂不重启方便你继续执行下面的命令。如果要一次操作到位也可以去掉 -NoRestart让它重启完成后自动生效。执行完后再到“Windows 功能”面板里看一眼确认“Windows 沙箱”这一项已经打勾。有时候命令行装好了图形界面还没刷新重新打开面板或者重启一次即可。3.2 手动清理沙箱残留缓存如果功能已经启用但还是初始化失败那就要考虑是不是沙箱的缓存文件出了问题。Windows 沙箱会缓存一份基础系统镜像在 C 盘如果这个镜像文件损坏每次启动都会失败。清理方法很简单先打开服务管理器停止沙箱相关服务然后删除缓存目录。默认情况下沙箱的缓存路径在这里C:\Windows\System32\WindowsSandbox\BaseImages删除这个目录下的所有内容然后重新启动沙箱系统会重新生成一份基础镜像。这个操作不会影响宿主机的任何数据沙箱本来就是一次性的放心删。删除前最好先确认没有正在运行的沙箱进程否则文件被占用会删不掉。用任务管理器查看 WindowsSandbox.exe 是否在运行在的话先结束进程再删。3.3 避开第三方安全软件的拦截还有一个实际遇到很多的问题第三方安全软件把沙箱进程当成可疑行为拦截了。尤其是一些带“主动防御”功能的安全软件对沙箱这种动态创建执行环境的操作非常敏感会阻止它启动。判断方法是暂时退出安全软件然后手动启动一次 Windows 沙箱WinR 输入 WindowsSandbox.exe试试。如果可以正常打开问题就坐实了。解决方式不是卸载安全软件而是在它的规则设置里把 WindowsSandbox.exe 和 Codex 的安装目录加入白名单。国产安全软件一般叫“信任区”或“排除项”加入后就不用每次都退出防护了。4. Codex 与沙箱集成的专项注意事项4.1 Codex 启动沙箱的机制与常见误导项Codex 调用沙箱不是单纯启动一个虚拟机窗口那么简单。它会在沙箱里挂载一些虚拟盘通过虚拟网络与宿主通信并在沙箱内部执行一系列 PowerShell 脚本。这个机制导致一个现象就算你的 Windows 沙箱可以独立启动Codex 调用时也有可能失败。原因在于 Codex 对沙箱版本有要求太老的 Windows 10 沙箱版本缺少某些内部接口Codex 连接不上就会返回“初始化失败”。所以我的建议是先把 Windows 系统更新到最新确保沙箱组件是最新版。Windows 10 用户至少要保证系统版本在 18362 以上Windows 11 用户就方便多了直接更新到最新即可。4.2 Codex 登录与组织设置加载问题的连带关系初始化失败这个问题如果不去解决而是一味地重试或跳过会引发一连串问题。社区里很多人反映Codex 初始化失败后登录会卡住或者登录成功后组织设置加载不出来。原因很简单Codex 在沙箱里生成的临时凭证没有正常回写宿主端的 Codex 看到的是一个未完成的状态。处理办法是在解决沙箱问题后删除 Codex 本地的缓存配置文件让它重新走一遍初始化流程。Codex 的缓存文件通常在用户的 AppData 目录下%LOCALAPPDATA%\Codex直接把整个 Codex 文件夹删掉然后重新打开 Codex。它会在沙箱里重新生成一份凭证和配置这次只要沙箱正常整个流程就会顺利很多。4.3 命令行增强用日志定位失败根因有时候报错信息太笼统看不出具体原因。考验耐心的时刻就到了看日志。Codex 在 Windows 上会输出运行日志位置在这个路径%LOCALAPPDATA%\Codex\logs打开最新的日志文件搜索“sandbox”“error”“fail”这几个关键词能看到具体的失败原因。常见错误大致有这么几类沙箱服务未运行错误信息里会出现 Service Not Found虚拟化支持缺失错误信息里会出现 Hyper-V 或 virtualization权限不足错误信息里会出现 Access Denied磁盘空间不足错误信息里会出现 Disk Space。这些关键词能帮你快速定位方向省得瞎猜。5. 常见问题与排查技巧速查这里把我在实际过程中遇到过的典型问题整理成了一个速查表方便遇到同样情况的朋友快速定位表现常见原因优先做法点击后 1 秒内报错CPU 虚拟化未开启进 BIOS/UEFI 打开 VT-x/AMD-V报错但沙箱可独立启动Codex 缓存损坏删除 %LOCALAPPDATA%\Codex日志提示 Hyper-V 相关错误Hyper-V 组件不完整命令行启用 Containers-DisposableClientVM沙箱打开就黑屏或闪退内存不足或显卡虚拟化不兼容增加可用内存更新显卡驱动报错且系统盘空间很小临时虚拟磁盘创建失败清理 C 盘至 5GB 以上安全软件弹出拦截提示主动防御拦截沙箱将 WindowsSandbox.exe 加入白名单还有一些细节需要单独提一下。如果你用的是笔记本需要去 BIOS 里把开关英文名认全Intel 平台叫 Intel Virtualization Technology或 VT-xAMD 平台叫 SVM Mode。在部分联想和戴尔的笔记本上这个选项默认是 Disabled而且藏在比较深的子菜单里。再一个坑就是旧版虚拟机软件的冲突。Windows 沙箱用了 Hyper-V而 VMware Workstation 15.5 以下版本与 Hyper-V 不共存。如果你电脑里装的是老版本 VMware就会出现沙箱和虚拟机“抢地盘”的情况解决办法是升级 VMware 到 16 以上版本或者干脆把 Hyper-V 打开后改用 Hyper-V 虚拟机。有一点需要特别提醒Windows 沙箱每次启动都需要重新初始化所以第一次启动会比较慢很多人以为是卡死了其实是在等待。如果有耐心等 30 秒到一分钟是比较正常的。Codex 的沙箱初始化也是一个道理我遇到过等得久然后突然弹出需要重启的情况这不是失败重启完继续走就好。我个人的操作习惯是先跑一次系统信息检查命令确认硬件支持再用管理员 PowerShell 开启功能重启后手动测一次 Windows 沙箱能不能打开最后才去启动 Codex。按照这个顺序问题出现的概率能降到最低。很多人在社区里问 Codex 一直无法加载组织设置怎么办其实多半也是沙箱初始化这个老问题在前面挡着路。底层通了后续全都顺了。
