Add Windows as supported OS in install docs
Resolved 💬 2 comments Opened Jan 5, 2026 by davidgilbertson Closed Jan 5, 2026
💡 Likely answer: A maintainer (etraut-openai, contributor)
responded on this thread — see the highlighted reply below.
What is the type of issue?
_No response_
What is the issue?
The page at https://github.com/openai/codex/blob/main/docs/install.md currently makes it sound like installing on Windows (without WSL) isn't an option, but the GitHub action does this and I found it just as easy to get started on Windows as Linux.
I think making it sound like Windows isn't supported might deter contributors from helping to fix Windows issues.
The only small tweak I needed to make to the codebase was in the justfile:
- remove
set positional-arguments - replace
$@with{{args}} - add
set windows-shell := ["powershell.exe", "-NoProfile", "-Command"]near the top
I'm happy to do a PR with both Windows install instructions and the justfile fix if desired.
Where did you find it?
_No response_
2 Comments
Use of Codex on Windows _without WSL_ is still considered experimental because there is no sandbox mechanism by default. We have been actively working on implementing an OS-level sandbox mechanism, which can be enabled in its current experimental form. You can read about it here. Once this feature is complete and it's enabled by default, we'll change the documentation to indicate that Codex on Windows is fully supported.
To be clear, I was referring to the install docs and messaging _for contributors_, not for end users.