codex - 💡(How to fix) Fix Bug: Missing optional dependency @openai/codex-win32-x64 on Windows (v0.124) [5 comments, 6 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#19243Fetched 2026-04-24 05:58:07
View on GitHub
Comments
5
Participants
6
Timeline
11
Reactions
1
Timeline (top)
commented ×5labeled ×3cross-referenced ×2subscribed ×1

Error Message

After installing @openai/[email protected] globally, running codex results in the following error: Error: Missing optional dependency @openai/codex-win32-x64.

RAW_BUFFERClick to expand / collapse

What version of Codex CLI is running?

0.124.0

What subscription do you have?

pro

Which model were you using?

No response

What platform is your computer?

OS: Windows 10 x64 Node.js: (e.g. v20.12.2) npm: (e.g. v10.5.0) Codex version: 0.124.0

What terminal emulator and version are you using (if applicable)?

No response

What issue are you seeing?

After installing @openai/[email protected] globally, running codex results in the following error:

Error: Missing optional dependency @openai/codex-win32-x64. Reinstall Codex: npm install -g @openai/codex@latest

What steps can reproduce the bug?

Install Codex:

npm install -g @openai/[email protected]

Run:

codex

What is the expected behavior?

Codex CLI should run normally.

Additional information

npm config get omit returns: (your value) NODE_ENV: (your value)

Installing @openai/codex-win32-x64 directly results in:

404 Not Found Version 0.122.x works correctly on the same environment. Suspected Cause

It seems that the Windows-specific optional dependency (*-win32-x64) may not be properly published or resolved for version 0.124.0.

extent analysis

TL;DR

The issue can likely be resolved by installing an earlier version of Codex, such as 0.122.x, which is known to work correctly on the same environment.

Guidance

  • The error message suggests a missing optional dependency @openai/codex-win32-x64 for the installed version 0.124.0, indicating a potential publishing or resolution issue.
  • Installing @openai/[email protected] globally using npm install -g @openai/[email protected] may provide a temporary workaround.
  • Verify the issue by checking if the codex command runs normally after installing the earlier version.
  • If the earlier version resolves the issue, it may be worth monitoring the @openai/codex package for updates that address the dependency issue in version 0.124.0.

Notes

The provided information suggests a version-specific issue with the @openai/codex package, particularly with the Windows-specific optional dependency. The suggested workaround involves installing an earlier version known to work, but this may not be a permanent solution.

Recommendation

Apply workaround: Install an earlier version of Codex, such as 0.122.x, as it is known to work correctly on the same environment and the issue seems to be version-specific.

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