codex - 💡(How to fix) Fix Windows Sandbox feature required but cannot be installed - Codex fails to initialize [1 participants]

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…
GitHub stats
openai/codex#17135Fetched 2026-04-09 08:02:02
View on GitHub
Comments
0
Participants
1
Timeline
5
Reactions
0
Participants
Timeline (top)
labeled ×4unlabeled ×1

Error Message

Codex fails to send messages with error "Unable to send message - Set up Agent sandbox to continue". Error from sandbox log (C:\Users\dbradt.codex.sandbox\sandbox.log): 4. Observe "Unable to send message - Set up Agent sandbox to continue" error

  1. Detect that Windows Sandbox feature is not available and provide a clear error message explaining the requirement Expected error message example:

Root Cause

  1. Sandbox log shows ACL helper process gets stuck: "read ACL helper already running; skipping spawn"
  2. Testing codex sandbox windows echo "test" hangs indefinitely
  3. Root cause: Windows Sandbox feature is not installed/enabled on the system
  4. Attempted to enable Windows Sandbox via Windows Features but installation failed after 90 minutes (likely blocked by corporate IT policies)

Fix Action

Fix / Workaround

This appears to be a common issue in enterprise environments where Windows Sandbox feature cannot be enabled due to corporate security policies. A workaround or alternative sandbox mechanism would greatly improve enterprise usability.

RAW_BUFFERClick to expand / collapse

What version of the Codex App are you using (From “About Codex” dialog)?

codex-cli 0.117.0-alpha.12

What subscription do you have?

Enterprise

What platform is your computer?

Microsoft Windows NT 10.0.26200.0 x64

What issue are you seeing?

Codex fails to send messages with error "Unable to send message - Set up Agent sandbox to continue".

The sandbox initialization hangs indefinitely when attempting to execute commands. Investigation revealed:

  1. Sandbox log shows ACL helper process gets stuck: "read ACL helper already running; skipping spawn"
  2. Testing codex sandbox windows echo "test" hangs indefinitely
  3. Root cause: Windows Sandbox feature is not installed/enabled on the system
  4. Attempted to enable Windows Sandbox via Windows Features but installation failed after 90 minutes (likely blocked by corporate IT policies)

Error from sandbox log (C:\Users\dbradt.codex.sandbox\sandbox.log):

What steps can reproduce the bug?

  1. Use Windows 10 Enterprise with Windows Sandbox feature disabled/not installed
  2. Install Codex/Windsurf
  3. Open Codex and attempt to send any message
  4. Observe "Unable to send message - Set up Agent sandbox to continue" error
  5. Sandbox initialization hangs indefinitely

To verify Windows Sandbox status:

  • Open "Turn Windows features on or off"
  • Check if "Windows Sandbox" is unchecked
  • Attempting to enable it may fail on corporate-managed systems

Configuration tested:

  • config.toml with sandbox = "elevated" (with admin rights)
  • config.toml with sandbox = "none" and enabled = false
  • Cleared sandbox state directories (.sandbox, .sandbox-secrets, .tmp)
  • Killed stuck sandbox processes
  • All configurations result in same hanging behavior

Also tried to enable Windows sandbox. Machine attempted to do this update for 90 minutes and then it failed.

What is the expected behavior?

Codex should either:

  1. Detect that Windows Sandbox feature is not available and provide a clear error message explaining the requirement
  2. Provide alternative sandbox mechanisms (WSL, Docker, or restricted token mode) that don't require Windows Sandbox feature
  3. Allow graceful degradation or fallback when Windows Sandbox is unavailable
  4. Document Windows Sandbox as a system requirement in installation documentation

Expected error message example: "Windows Sandbox feature is required but not installed. Please enable it via Windows Features or contact your IT administrator."

Additional information

  • System: Windows 10 Enterprise 2009 (Build 26200)
  • Codex version: 0.117.0-alpha.12
  • Running with Administrator privileges
  • Corporate-managed system where Windows Sandbox installation is blocked by IT policy
  • Virtualization appears to be available (HyperVisorPresent check passed)
  • Issue affects both Windsurf-integrated Codex and standalone Codex app
  • Worked once briefly, then stopped working (suggesting sandbox state corruption)

This appears to be a common issue in enterprise environments where Windows Sandbox feature cannot be enabled due to corporate security policies. A workaround or alternative sandbox mechanism would greatly improve enterprise usability.

extent analysis

TL;DR

Enable the Windows Sandbox feature or use an alternative sandbox mechanism to resolve the "Unable to send message - Set up Agent sandbox to continue" error in Codex.

Guidance

  • Verify that the Windows Sandbox feature is disabled by checking "Turn Windows features on or off" and looking for the "Windows Sandbox" option.
  • If the feature is disabled, attempt to enable it, but be aware that corporate IT policies may block the installation.
  • Consider using alternative sandbox mechanisms, such as WSL or Docker, if available and compatible with Codex.
  • Check the Codex documentation for any updates on system requirements or alternative sandbox solutions.

Example

No code snippet is provided as the issue is related to system configuration and feature availability.

Notes

The issue is specific to Windows 10 Enterprise environments where the Windows Sandbox feature is disabled due to corporate security policies. The solution may require IT administrator involvement or alternative sandbox mechanisms.

Recommendation

Apply a workaround, such as using an alternative sandbox mechanism, as enabling the Windows Sandbox feature may not be possible in corporate-managed systems. This approach can improve enterprise usability while awaiting a potential fix or update from the Codex developers.

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING