Windows
Coding agents on Windows, natively
Claude Code, Codex and OpenCode all run on Windows without WSL now. Here is what to install, what differs from macOS, and how to drive all three from one conversation.
Claude Code
Install it from PowerShell with irm https://claude.ai/install.ps1 | iex; no admin rights or
Node.js needed (official setup guide). The installer puts
claude.exe in %USERPROFILE%\.local\bin and may ask you to add that folder to
your PATH yourself. Two more Windows details matter:
- Shell. With Git for Windows installed, Claude runs
commands in Git Bash; set
CLAUDE_CODE_USE_POWERSHELL_TOOL=1to add its PowerShell tool. Without Git, PowerShell is its shell. Either works with OpenMimir. - Permission rules. PowerShell commands follow
PowerShell(...)rules, notBash(...)ones, so a rule likeBash(git push *)needs aPowerShell(git push *)twin. Claude Code matches aliases, soPowerShell(Remove-Item *)also coversrmanddel.
Codex
npm install -g @openai/codex gives you the Codex CLI on Windows. It runs commands in its own
Windows sandbox: on recent Windows 11 builds it uses Microsoft's new
isolation (no admin needed), and elsewhere a sandbox that an administrator sets up once. Windows 11 is the
recommended base; Windows 10 works on a best-effort basis.
One thing to know: until a sandbox is chosen, Codex can read your code but every write is rejected, even
with sandbox_mode = "workspace-write". Run codex once and pick one, or add this to
%USERPROFILE%\.codex\config.toml:
[windows]sandbox = "mxc"
OpenCode
This is where most people trip up: npm install -g opencode-ai still installs
OpenCode 1. OpenCode 2 is npm install -g @opencode/cli, or a standalone zip from the
OpenCode 2 docs (Windows x64 and ARM64). Check with
opencode --version. Its background server works on Windows too:
opencode service start.
Native or WSL?
Native is simplest when your projects live on the Windows drive and you use Windows tools. WSL 2 gives you a Linux toolchain and Claude Code's sandboxing, at the cost of a second file system. Agents installed inside WSL keep their history inside WSL too, so tools running on Windows don't see those sessions.
One conversation over all three
OpenMimir runs natively on Windows 10 and 11 (x64 and Arm). Install it from PowerShell, no admin rights needed:
irm https://openmimir.com/install.ps1 | iex
- It finds Claude Code, Codex and OpenCode however you installed them, including npm's
.cmdshims and install folders that never made it onto your PATH, and reads their history from%USERPROFILE%. - It uses your OpenCode background service when it runs, so its messages show up live in OpenCode, and starts its own OpenCode server otherwise.
- It sends prompts to the agents on standard input, so nothing gets mangled by Windows command-line quoting or cut off by its length limit.
- Its safety rules cover PowerShell and cmd as well as Bash:
Remove-Item -Recurse,rd /s,irm ... | iex,Stop-Computerand friends wait for an on-screen approval, and voice can never approve them. - Stopping a session stops the agent and everything it started, and closing Mimir's window or pressing Ctrl+C takes its agents down with it.
mimir doctortells you if something is missing, such as Codex's Windows sandbox.- Press CtrlShiftSpace in the browser to talk.
Try OpenMimir
Free and open source. Runs on your Mac or Windows PC with your own API keys.
curl -fsSL https://openmimir.com/install.sh | bash
In Terminal. Apple Silicon or Intel.
Questions
Does Claude Code work on Windows without WSL?
Yes. The native installer works from PowerShell or CMD on Windows 10 1809 and later. Git for Windows is optional.
Does the Codex CLI work on Windows?
Yes, natively, with its own Windows sandbox. Windows 11 is recommended.
Why does OpenMimir say my OpenCode is too old?
You probably have OpenCode 1 from npm install -g opencode-ai. OpenMimir needs OpenCode 2: npm install -g @opencode/cli.
Why can't Codex edit files on Windows?
Codex rejects writes until one of its Windows sandboxes is chosen. Run codex once and pick one, or add [windows] with sandbox = "mxc" to %USERPROFILE%\.codex\config.toml.
Does OpenMimir need admin rights on Windows?
No. It installs into your user profile and adds itself to your user PATH.