[Windows] Codex Desktop app fails to start after update with "Unable to locate the Codex CLI binary"
Nobody has claimed this yet.
- Dominant language
- Rust
- Stars
- 125k
- Forks
- 19.4k
- PR merge metrics
- PR metrics pending
Description
What version of the Codex App are you using (From “About Codex” dialog)?
26.820.7780.0
What subscription do you have?
Plus
What platform is your computer?
win11 26200.9168
What issue are you seeing?
The Codex Desktop app fails to start immediately after updating to the latest version. A dialog box appears with the error:
"ChatGPT failed to start. Unable to locate the Codex CLI binary. Set CODEX_CLI_PATH or ensure the Electron resources include bin/codex."
The app cannot proceed beyond this dialog—only "Check for Updates" and "Quit" buttons are available.
Steps to reproduce:
- Previously had Codex Desktop working normally on Windows with WSL2 mode enabled.
- Updated the app to the latest version via the in-app update prompt.
- After the update, the app restarted and showed this error.
- The app never reaches the main interface.
What I have tried:
- Verified that Codex CLI works in WSL2: running
codex --versionoutputs the correct version without errors. - Set
CODEX_CLI_PATHenvironment variable pointing to the WSL-installed binary. - Completely exited all Codex processes via Task Manager and restarted.
Workaround found:
- Setting
runCodexInWindowsSubsystemForLinux = falsein%USERPROFILE%\.codex\config.tomlallows the app to start, but this disables WSL integration, which is not acceptable as a permanent solution.
This appears to be a regression introduced in the latest Windows update. I have seen multiple reports from other users with the same issue after the recent update.
What steps can reproduce the bug?
- Use Codex Desktop app on Windows with WSL2 mode enabled (runCodexInWindowsSubsystemForLinux = true in config.toml).
- Update the app to the latest version (26.609.4994.0) via the in-app update prompt.
- After the update completes, the app attempts to restart.
- A dialog appears with the error: "Unable to locate the Codex CLI binary. Set CODEX_CLI_PATH or ensure the Electron resources include bin/codex."
- The app cannot proceed past this dialog and never reaches the main interface.
Note: Codex CLI is installed and working correctly in WSL2. Running codex --version in WSL terminal outputs the expected version without errors.
This is not a code execution bug—it is an application startup regression. No code snippet is applicable as the app fails to launch entirely.
What is the expected behavior?
The Codex Desktop app should start normally after updating, with WSL2 integration continuing to work as it did in the previous version. The app should detect the Codex CLI binary correctly in the WSL environment and proceed to the main interface.
In the previous version, this worked perfectly with the exact same configuration, so the expected behavior is that the update does not break existing WSL functionality.
Additional information
No response
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Reproduce the post-update startup path with WSL2 enabled and inspect the Electron resources/bin/codex lookup, CODEX_CLI_PATH handling, and %USERPROFILE%.codex\config.toml setting. Done means the updated Windows app starts with runCodexInWindowsSubsystemForLinux=true and reaches the main interface while locating the CLI binary.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- electron, linux
- Domain
- desktop, devtools
- Issue type
- Bug
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Activity status
- Active
- Clarity
- Mostly clear
- Newbie friendliness
- 48/100