结论先说
os error 32的本质是 Windows 文件占用冲突(ERROR_SHARING_VIOLATION)。Codex 在执行命令前会调用 Windows 沙箱初始化组件(如codex-windows-sandbox-setup.exe)校验并刷新运行目录的访问控制列表(ACL);一旦目录里的node.exe、node_repl.exe或运行库 DLL 正被旧版后台进程锁住,沙箱刷新就会直接中止。- 先升级到已修复版本并彻底退出后台进程。部分早期测试构建(如
0.162.0-alpha附近)存在沙箱自检锁死自身运行文件的回归问题;先升级桌面端和独立 CLI,再清空残留进程,大多数报错可直接消失。 - 排查外部占用源:IDE 内置终端、杀毒软件实时扫描或云盘同步目录都可能短时间锁住
.codex下的沙箱运行文件。 - 急着干活可按官方后备方案临时切
unelevated。若更新后仍暂时无法通过elevated校验且设备不支持mxc,可在%USERPROFILE%\.codex\config.toml中短暂启用unelevated,但务必知晓其隔离强度更弱,待更新修复后及时切回。 - 排障同时确保账号订阅和额度正常。国内缺少外币卡的用户可在本站自助开通 ChatGPT Plus 或高额度 ChatGPT Pro,团队多人采购可看 ChatGPT Business 团队定制。

图:本站根据 OpenAI Codex 官方文档:Windows sandbox 与仓库 Issue 整理的示意图
本文根据 OpenAI Codex 官方文档《Windows sandbox》《ChatGPT desktop app for Windows》《Troubleshooting》及官方 GitHub 仓库 Issue 讨论整理,资料核对于 2026-11-19。配图为本站整理的示意图,不是界面截图。本站(bigolab.com)不是 OpenAI 官方网站。
适用于谁
- 在 Windows 上使用 Codex CLI 或 ChatGPT 桌面端(Codex 模式)执行命令前,收到
helper_unknown_error: setup refresh had errors或os error 32提示的开发者; - 刚通过 Microsoft Store 或
npm升级完 Codex,随后任何本地 Shell 命令都无法启动的用户; - 需要区分「文件被旧进程锁住」与「Windows 沙箱权限策略被拦住」两类报错的人。
一、为什么更新后容易触发 helper_unknown_error 与 os error 32
Windows 文件系统对正在运行的可执行文件和动态链接库(DLL)采用独占句柄锁机制,这与 Linux 和 macOS 允许替换已打开文件的行为不同。当 Codex 桌面端或 CLI 出现以下三种情形时,最容易撞上 os error 32:
- 原地热更新留有僵尸进程:通过 Microsoft Store 自动更新桌面 App,或在终端跑完
npm install -g @openai/codex后,旧会话的codex.exe、沙箱辅助进程或内嵌 Node 进程仍在后台挂着,新版本启动沙箱刷新尝试改写或校验文件 ACL 时被系统拒绝。 - 特定版本自检回归:社区反馈部分版本在每次命令启动前都会重复执行
setup refresh,去扫描已被自身子进程占用的运行时二进制(例如cua_node下的node_repl.exe或VCRUNTIME140_1.dll),从而自我锁死。 - 安全软件或同步工具抢锁:Windows Defender、第三方杀毒引擎或将用户目录映射到 OneDrive 实时同步时,可能在沙箱刷新的毫秒窗口内占用文件句柄。
如果报错里出现的是 error 1385、Everyone 可写 或 UAC 被拒绝,而非 os error 32,说明问题偏向系统策略与账户权限,请转看 /guides/codex-windows-sandbox-setup-failed。
二、按顺序清理残留进程、升级并刷新沙箱
以下为本站建议的 5 步标准排障顺序,建议按先后执行,避免盲目重装系统或清空项目代码:

图:本站根据 OpenAI Codex 官方仓库 与 Windows 排障经验整理的示意图
第 1 步:彻底结束残留后台进程(本站建议)
先关闭所有打开了 Codex 的终端窗口、VS Code / JetBrains 编辑器与 ChatGPT 桌面端(注意检查任务栏托盘图标),然后用管理员权限打开 PowerShell,检查并清理可能锁住文件的残留进程:
powershell
# 查看仍在运行的 Codex 相关进程
Get-Process | Where-Object { $_.Name -match "codex|ChatGPT|node_repl" } | Select-Object Name, Id, Path
# 强制结束残留的 Codex 与沙箱辅助进程(先确认没有正在跑的重要任务)
Stop-Process -Name "codex", "codex-windows-sandbox-setup", "node_repl" -Force -ErrorAction SilentlyContinue
操作前请确认你本地没有其他无关 Node 生产服务依赖同名进程;如仅想精准结束单个进程,按上一步查出的 Id 执行 Stop-Process -Id <PID> -Force 更稳妥。
第 2 步:更新桌面端与独立 CLI 至最新修复版
进程清干净后,再执行版本升级,确保替换掉有回归缺陷的旧二进制:
- 桌面端用户:打开 Microsoft Store,进入「下载与更新」,将 ChatGPT / Codex 桌面端更新至最新版本(社区记录
26.1007.21434及以上已修复相关回归)。安装细节可对照 /guides/codex-windows-app-download-install。 - CLI 用户:在新的 PowerShell 窗口升级全局包(
0.163.0及以上包含修复),并核对当前生效路径是否唯一:
powershell
npm install -g @openai/codex@latest
where.exe codex
codex --version
若 where.exe codex 返回多条路径,说明电脑里混装了全局 npm 版与历史独立版,容易互相拉起旧沙箱助手;建议卸载多余副本只留一份,具体可看 /guides/codex-cli-install-update。
第 3 步:重启电脑并让沙箱重新初始化(本站建议)
当 DLL 或系统服务句柄被内核缓存锁住时,仅杀用户态进程有时还不够。重启一次 Windows 后,不要急着同时开多个终端,先单开一个 PowerShell 在测试目录里运行 codex,观察首次沙箱刷新能否顺利完成并弹出正常的审批界面。
排障与订阅提示:高强度调试 Windows 环境与反复让 Codex 跑构建验证,很容易消耗大量推理额度。若 Plus 额度告急,可在本站升级 ChatGPT Pro 充值 或选择 ChatGPT Pro 5x iOS 可覆盖档;若新号登录遇到手机号校验拦路,也可参考 Codex 注册手机验证服务。
三、仍无法更新时的临时降级与日志收集
临时切换 unelevated 后备模式(仅作过渡)
如果因公司软件中心滞后暂时无法升级到修复版,且你的组织策略未禁用后备模式,可编辑 %USERPROFILE%\.codex\config.toml,临时将 Windows 沙箱切为 unelevated:
toml
[windows]
sandbox = "unelevated"
保存后完全退出并重启 Codex 桌面端或 CLI。需要特别注意,官方明确指出 unelevated 的网络隔离弱于 elevated,也不支持「禁止读取路径」规则;因此仅建议作为过渡手段,一旦更新到新版客户端或系统支持 mxc 原生沙箱,请第一时间删除该行或恢复默认配置。关于 config.toml 的完整结构,可参考 /guides/codex-config-toml-complete-guide。
收集日志提交官方反馈
如果最新版重启后依然持续报 helper_unknown_error,可以检查官方日志路径 CODEX_HOME\.sandbox\sandbox.log(通常在 %USERPROFILE%\.codex\.sandbox\sandbox.log),记录具体的被占用文件名与错误堆栈,然后在客户端内通过 /feedback 提交给官方。提交前切记不要附带 CODEX_HOME\.sandbox-secrets\ 目录下的任何文件。若伴随网络连接中断或 401/403 报错,请改看 /guides/codex-common-errors-summary 进一步定位。
常见问题
问:为什么我把 ChatGPT 桌面端窗口点叉关掉了,还是报 os error 32?
答:Windows 桌面端默认关闭主窗口后会在系统托盘常驻后台,且关联的沙箱辅助进程或 IDE 扩展仍在占用运行文件。必须右键托盘彻底退出,并在任务管理器确认无残留进程后再重试。
问:把 .codex 目录放进 OneDrive 同步会影响沙箱刷新吗?
答:会显著增加 os error 32 概率(本站建议排查项)。沙箱刷新高频读写小文件与权限位,云同步客户端一旦介入扫描并锁定句柄,就会直接触发文件占用报错;建议将 CODEX_HOME 保留在本地非同步磁盘路径下。
问:国内没有外币卡,或者原有 Plus 额度不够想升级 Pro / 团队版怎么办理?
答:可前往本站 AI 会员充值总览 按需选购 ChatGPT Plus(含 Plus iOS 可覆盖版)或高配额 ChatGPT Pro,团队多人研发亦可选择企业定制方案。支持支付宝、微信支付与 AlipayHK,提供自助卡密兑换与增值税发票服务,具体以商品页实时展示为准;售后遵循掉订阅按剩余天数折退、封号不在质保范围内的规则。
相关教程
- Codex 沙箱初始化失败怎么办(Windows)
- Codex Windows 桌面端下载与安装指南
- Codex CLI 安装与升级教程
- Codex config.toml 完整配置指南
- Codex 常见报错总表
参考资料
- OpenAI Codex 官方文档:Windows sandbox — https://learn.chatgpt.com/docs/windows/windows-sandbox
- OpenAI Codex 官方文档:ChatGPT desktop app for Windows — https://learn.chatgpt.com/docs/windows/windows-app
- OpenAI Codex 官方文档:Troubleshooting — https://learn.chatgpt.com/docs/reference/troubleshooting
- OpenAI Codex 官方 GitHub 仓库 — https://github.com/openai/codex
0 条评论
还没有评论,来抢沙发~