Windows版Codexのhelper_unknown_errorを直す:setup refresh had errorsの確認点

Windows版Codexのhelper_unknown_error: setup refresh had errorsは、サンドボックスログでos error 32を確認し、非昇格サンドボックスに切り替えて対処します。

Codex Sandbox Fixというタイトルが入ったプラグの線画

TL;DR: Windows の Codex ビルドで、26.1002.x 前後として報告され、同梱 CLI が 0.162.0-alpha.2 の場合、helper_unknown_error: setup refresh had errors は通常、elevated sandbox の共有違反によるリグレッションである可能性が高く、更新済みビルドをインストールするまでの一時的な回避策として [windows] sandbox = "unelevated" を設定する方法が報告されています。このガイドは、GitHub ユーザーからの報告、sandbox ログ、および openai/codex の issue 内でユーザーが引用した OpenAI の Windows sandbox ドキュメントに基づいています。

対象: Windows 10 / Windows 11 上の Codex Desktop / ChatGPT Desktop のローカル実行。特に、報告されているパッケージバージョン 26.1002.6548.0 と 26.1002.7124.0、About バージョン 26.1002.51308 と 26.1002.52244、同梱 CLI/helper 0.162.0-alpha.2。最終確認: 2026-11-03。

表示される内容移動先
helper_unknown_error: setup refresh had errorshelper_unknown_error: setup refresh had errors
trusted Node process exited unexpectedly or node_repl kernel exited unexpectedlytrusted Node process exited unexpectedly

elevated sandbox での helper_unknown_error: setup refresh had errors

exec-server rejected request (-32603): helper_unknown_error: setup refresh had errors
windows sandbox failed: helper_unknown_error: setup refresh had errors

Windows 上の Codex で helper_unknown_error: setup refresh had errors が表示される場合、elevated sandbox のセットアップが、実行中の cua_node ファイルに対する実行時の読み取り / 実行 ACL 検証中に失敗している可能性が高く、sandbox ログには Windows の os error 32 / ERROR_SHARING_VIOLATION が報告されています(openai/codex#51601、openai/codex#51634、openai/codex#51590 で報告)。Get-Location のような通常の sandboxed コマンドが PowerShell の起動前に失敗し、ログで %LOCALAPPDATA%\OpenAI\Codex\runtimes\cua_node\... 配下の node_repl.exe、node.exe、または VCRUNTIME140_1.dll が示されている場合は、このケースに該当します(openai/codex#51601 で報告)。

  1. Codex の sandbox ログで、致命的な実行時検証の行を検索します。
    Select-String -Path "$env:USERPROFILE\.codex\.sandbox\sandbox.*.log" `
      -Pattern "runtime read/execute validation failed","os error 32","helper_unknown_error" `
      -Context 0,3
  2. ログに cua_node のランタイムファイルに対する runtime read/execute validation failed と os error 32 が含まれている場合は、Windows sandbox 設定を含む Codex の config.toml ファイルを探します。
    Get-ChildItem -Path $env:USERPROFILE -Filter config.toml -Recurse -ErrorAction SilentlyContinue |
      Select-String -Pattern '^\s*sandbox\s*=\s*"(elevated|unelevated)"' -List |
      Select-Object -ExpandProperty Path
  3. 報告された config.toml ファイルを開き、Windows sandbox ブロックを、報告されている一時的な回避策に変更します。
    [windows]
    sandbox = "unelevated"
  4. Codex Desktop または ChatGPT Desktop を完全に終了してから、アプリを再度開き、sandbox 設定を再読み込みさせます。設定を変更せずにアプリを再起動するだけでは、elevated sandbox の失敗は解消しなかったと報告されています(openai/codex#51601 および openai/codex#51590 で報告)。
  5. build、test、Browser Use、または Computer Use のワークフローを再試行する前に、Codex から Get-Location など最小限の sandboxed コマンドを 1 つ実行します。

動作確認の方法: 要求したコマンドが、プロセス作成前に失敗するのではなく、起動して完了するはずです。回避策が成功したという報告では、unelevated に切り替えた後、sandboxed PowerShell コマンドが完了し、Browser Control が初期化されました(openai/codex#51590 で回避策として報告)。

それでも失敗する場合: %USERPROFILE%\.codex\.sandbox\sandbox.<date>.log と %USERPROFILE%\.codex\.sandbox\setup_error.json を収集し、Codex のパッケージバージョン、About バージョン、同梱 CLI/helper バージョン、Windows バージョン、sandbox 設定、失敗しているランタイムパス、正確な runtime read/execute validation failed 行を、既存の GitHub issue に報告してください。次の修正として手動の ACL 事前付与に頼らないでください。再帰的な (RX) ACE を追加しても失敗は変わらなかったという報告があるためです(openai/codex#51634 で報告)。ローカル実行が動作するようになった後、次のエラーが API / provider のエラーである場合は、general error-handling guide を使って、再試行可能な API 失敗と、このローカル Windows sandbox 起動失敗を切り分けてください。

Computer Use での trusted Node process exited unexpectedly

trusted Node process exited unexpectedly
node_repl kernel exited unexpectedly
windows sandbox failed: helper_unknown_error: setup refresh had errors

Computer Use、Browser Use、または Node REPL が、同じ Windows sandbox のセットアップ更新に先に失敗することで失敗する場合、Codex は trusted Node process exited unexpectedly または node_repl kernel exited unexpectedly を表示することがあります(openai/codex#51590、openai/codex#51601、openai/codex#51634 で報告)。await cua.getState()、sky.list_apps()、またはブラウザー / アプリ検出がタブやアプリを返す前に失敗し、通常の sandboxed shell コマンドも実行前に失敗する場合は、このケースに該当します(openai/codex#51590 で報告)。

  1. Node エラーの背後に、同じ sandbox セットアップ失敗があることを確認します。
    Select-String -Path "$env:USERPROFILE\.codex\.sandbox\sandbox.*.log" `
      -Pattern "node_repl.exe","VCRUNTIME140_1.dll","runtime read/execute validation failed","setup refresh had errors" `
      -Context 0,3
  2. ログに同じ実行時の読み取り / 実行検証失敗が示されている場合は、同じ一時的な sandbox 設定を適用します。
    [windows]
    sandbox = "unelevated"
  3. Codex Desktop または ChatGPT Desktop を完全に終了してから再度開きます。node_repl.exe だけを終了しても、永続的な復旧にはならなかったと報告されています。失敗が VCRUNTIME140_1.dll など、別の使用中のランタイムファイルに移ることがあるためです(openai/codex#51601 および openai/codex#51634 で報告)。
  4. 影響を受けている最小の操作から再試行します。まず sandboxed Get-Location を実行し、その後 Browser Use または Computer Use の初期化を再試行します。

動作確認の方法: Computer Use または Browser Use が、ブラウザーやアプリの一覧取得前に失敗するのではなく、初期化されるはずです。また、再試行時の sandbox ログには、致命的な runtime read/execute validation failed 行が出なくなるはずです。後のユーザー報告の 1 つでは、最新の確認で PowerShell、node_repl、Computer Use、sky.list_apps() が動作し、sandbox refresh が errors=[] を報告したとされていますが、その復旧について maintainer のリリースノートは資料に含まれていませんでした(openai/codex#51590 で報告)。

それでも失敗する場合: updater がより新しい Codex Windows ビルドを提示している場合は、それをインストールし、同じ最小コマンドで再テストしてください。updater がアプリはすでに最新だと報告する場合は、ランタイムディレクトリを繰り返しリセットするのではなく、sandbox ログとバージョン詳細を GitHub issue に添付してください。再インストールまたはロールバックを行い、ローカル実行が再び動作した後に provider 設定が欠けている場合は、Codex model-provider configuration を使って Codex 側の provider 設定を作り直してください。

確認方法

  • elevated Windows sandbox の ACL 共有違反の可能性: 2026-10-07 と 2026-10-08 の複数のユーザー報告に、実行中の cua_node ファイルに対する runtime read/execute validation failed、open ACL target for root-only update、os error 32 の sandbox ログ行が含まれていました(openai/codex#51601、openai/codex#51634、openai/codex#51590)。
  • unelevated 回避策: あるユーザーは 2026-10-08 に、config.toml を [windows] sandbox = "unelevated" に変更すると、Codex Desktop 26.1002.7124.0 で sandboxed PowerShell と Browser Control が復旧したと報告しました。同じ報告では、unelevated は elevated より分離が弱い fallback であると説明する OpenAI ドキュメントが引用されていました(openai/codex#51590)。
  • downgrade はユーザー側の回避策であり、ここでの主な修正ではありません。ユーザーは、同梱 CLI 0.160.1 を含むパッケージ 26.930.7945.0 など、以前の完全な desktop build へ downgrade した後に復旧したと報告しましたが、資料には公式の rollback 手順や maintainer の推奨は含まれていませんでした(openai/codex#51590 および openai/codex#51601)。

ドキュメント: ローカルコマンド実行が再び動作するようになった後、Codex provider 設定を復旧または更新するには、Codex model-provider configuration を使用してください。 → Codex model-provider configuration

関連ドキュメント

ローカルコマンド実行を復旧した Codex ユーザーは、provider 設定と sandbox 以外のエラー処理に以下のドキュメントを利用できます。

出典

この記事の Codex Windows sandbox に関する知見は、公開 GitHub issue の報告と、それらの報告内で引用された公式の Windows sandbox ドキュメントに基づいています。

  • openai/codex#51601: Windows アプリ 26.1002.51308 / build 13417 で、実行中のランタイムファイルを検証している間に共有違反が発生し、sandbox setup が失敗する。
  • openai/codex#51634: cua_node のランタイムファイルが使用中の場合に、Windows sandbox provisioning が os error 32 で失敗する。0.162.0-alpha.2 に対して報告。
  • openai/codex#51590: Windows sandbox が ACL update のために実行中の node_repl.exe を開く処理に失敗する。unelevated 回避策と、その後の復旧確認に関する報告を含む。
  • openai/codex#51590 でユーザーが引用した OpenAI Windows sandbox ドキュメント: https://learn.chatgpt.com/docs/windows/windows-sandbox

よくある質問

WindowsでCodexのhelper_unknown_error: setup refresh had errorsが出る場合は?
報告されているWindowsでの多くのケースは、昇格サンドボックス実行時のACL共有違反である可能性があります。一時的な回避策としてCodexのWindowsサンドボックス設定を非昇格に切り替えるか、アップデーターで提供されている場合は修正済みの新しいビルドをインストールしてください。
Windowsアップデート後にCodexがtrusted Node process exited unexpectedlyと表示するのはなぜですか?
このNodeエラーは、同じWindowsサンドボックス設定失敗の二次的な症状である可能性があります。この場合、Computer UseやBrowser Useを初期化する前にCodexが失敗します。
os error 32が同じCodexサンドボックスのバグかどうかは、どう確認しますか?
Codexのサンドボックスログで、node_repl.exe、node.exe、またはVCRUNTIME140_1.dllに対するruntime read/execute validation failedとos error 32を検索します。