Codex cli silently exits on fresh windows installs
Resolved 💬 2 comments Opened Mar 30, 2026 by JKamsker Closed Mar 30, 2026
What version of Codex CLI is running?
v0.117.0
What subscription do you have?
pro
Which model were you using?
_No response_
What platform is your computer?
Microsoft Windows NT 10.0.26200.0 x64
What terminal emulator and version are you using (if applicable)?
WT, Pwsh 7.6
What issue are you seeing?
starting "codex" didnt do anything. no ui, no error - nothing:
PS C:\Users\Jonas> npm install -g @openai/codex@latest
changed 2 packages in 1s
PS C:\Users\Jonas> codex
PS C:\Users\Jonas> codex
What steps can reproduce the bug?
- Install fresh windows
- Install nvm
- Install npm: `
nvm install latest&&nvm use latest` - type "codex"
What is the expected behavior?
codex opens
Additional information
Seems like some deps were missing.
Kinda awkward i had claude code fix the bug for me:
Description:
When the Visual C++ Redistributable (UCRT) is not installed, codex fails with a confusing error that gives no indication of
the actual problem:
C:/nvm4w/nodejs/node.exe: error while loading shared libraries: ?: cannot open shared object file: No such file or directory
The root cause is that the native binary (codex.exe from @openai/codex-win32-x64) depends on
api-ms-win-crt-utility-l1-1-0.dll, which is part of the Visual C++ Redistributable. When that DLL is missing, the error
surfaces through the Node.js shim and doesn't mention the actual missing DLL at all.
Steps to reproduce:
1. Windows 11 machine without Visual C++ Redistributable installed
2. npm install -g @openai/codex@latest
3. codex -h
Expected behavior:
A clear error message like: "Missing required dependency: Visual C++ Redistributable. Install it from
https://aka.ms/vs/17/release/vc_redist.x64.exe"
Actual behavior:
Opaque shared library error with ? as the library name.
Suggested fixes:
- Add a pre-flight check in codex.js that attempts to spawn the native binary and catches the failure with a user-friendly
message pointing to the VC++ Redistributable
- Document the Visual C++ Redistributable as a prerequisite in the Windows installation instructions
- Consider statically linking the CRT (/MT) in the native binary to avoid this dependency entirely
Environment:
- OS: Windows 11 Pro (10.0.26200)
- Node: v25.8.2 (via nvm4w)
- Codex: @openai/codex@0.117.0This issue has 2 comments on GitHub. Read the full discussion on GitHub ↗