codex - 💡(How to fix) Fix Codex App for Windows fail to startup in WSL Agent mode [2 comments, 2 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#17254Fetched 2026-04-10 03:43:20
View on GitHub
Comments
2
Participants
2
Timeline
5
Reactions
0
Author
Timeline (top)
labeled ×3commented ×2
RAW_BUFFERClick to expand / collapse

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

26.406.31014

What subscription do you have?

free

What platform is your computer?

Microsoft Windows NT 10.0.26200.0 x64

What issue are you seeing?

When using the setting "runcodexinwindowssubsystemforlinux": true, the app always stuck in the login UI.

I have to modify the file $env:USERPROFILE\.codex\.codex-global-state.json to remove the following code: "runcodexinwindowssubsystemforlinux": true.

It fails to startup in VSCode extension too.

What steps can reproduce the bug?

  1. Go to settings page, switch Agent environment to Windows Subsystem for Linux.
  2. Exit the App and restart it.
  3. Stuck in the login UI.
  4. open $env:USERPROFILE\.codex\.codex-global-state.json, and remove the following code: "runcodexinwindowssubsystemforlinux": true
  5. Open the App again, and it runs fine.

What is the expected behavior?

No response

Additional information

No response

extent analysis

TL;DR

Removing the "runcodexinwindowssubsystemforlinux": true setting from the .codex-global-state.json file may resolve the issue of the app getting stuck in the login UI.

Guidance

  • Verify that the issue is specific to the "runcodexinwindowssubsystemforlinux": true setting by testing with it enabled and disabled.
  • Check if the issue persists when using the VSCode extension, as it is mentioned to also fail during startup.
  • Try modifying the Agent environment setting to a different value to see if the issue is related to the Windows Subsystem for Linux specifically.
  • Consider resetting the app's settings to their default values to rule out any other configuration-related issues.

Example

No code snippet is provided as the issue does not require a code-level fix, but rather a configuration change.

Notes

The provided solution may not be a permanent fix, but rather a workaround. Further investigation into the root cause of the issue may be necessary to provide a more robust solution.

Recommendation

Apply workaround: Remove the "runcodexinwindowssubsystemforlinux": true setting from the .codex-global-state.json file, as it has been shown to resolve the issue in the provided reproduction steps.

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