app/windows.md Codex Docs, 2026-04-13 00:44 UTC → 2026-05-02 06:45 UTC

2 2 

3The [Codex app for Windows](https://get.microsoft.com/installer/download/9PLM9XGG6VKS?cid=website_cta_psi) gives you one interface for3The [Codex app for Windows](https://get.microsoft.com/installer/download/9PLM9XGG6VKS?cid=website_cta_psi) gives you one interface for

4working across projects, running parallel agent threads, and reviewing results.4working across projects, running parallel agent threads, and reviewing results.

5The Windows app supports core workflows such as worktrees, automations, Git

6functionality, the in-app browser, artifact previews, plugins, and skills.

5It runs natively on Windows using PowerShell and the7It runs natively on Windows using PowerShell and the

6[Windows sandbox](https://developers.openai.com/codex/windows#windows-sandbox), or you can configure it to8[Windows sandbox](https://developers.openai.com/codex/windows#windows-sandbox), or you can configure it to

7run in [Windows Subsystem for Linux 2 (WSL2)](#windows-subsystem-for-linux-wsl).9run in [Windows Subsystem for Linux 2 (WSL2)](#windows-subsystem-for-linux-wsl).

184`%USERPROFILE%\.codex`.186`%USERPROFILE%\.codex`.

185 187 

186If you also run the Codex CLI inside WSL, the CLI uses the Linux home188If you also run the Codex CLI inside WSL, the CLI uses the Linux home

187directory by default, so it does not automatically share configuration, cached189directory by default, so it doesn't automatically share configuration, cached

188auth, or session history with the Windows app.190auth, or session history with the Windows app.

189 191 

190To share them, use one of these approaches:192To share them, use one of these approaches:

206 208 

207### Git isn't detected for projects opened from `\\wsl$`209### Git isn't detected for projects opened from `\\wsl$`

208 210 

209For now, if you want to use the Windows-native agent with a project that is211For now, if you want to use the Windows-native agent with a project also

210also accessible from WSL, the most reliable workaround is to store the project212accessible from WSL, the most reliable workaround is to store the project

211on the native Windows drive and access it in WSL through `/mnt/<drive>/...`.213on the native Windows drive and access it in WSL through `/mnt/<drive>/...`.

212 214 

213### Cmder is not listed in the open dialog215### `Cmder` isn't listed in the open dialog

214 216 

215If Cmder is installed but doesn’t show in Codex’s open dialog, add it to the217If `Cmder` is installed but doesn't show in Codex's open dialog, add it to the

216Windows Start Menu: right-click Cmder and choose **Add to Start**, then restart218Windows Start Menu: right-click `Cmder` and choose **Add to Start**, then

217Codex or reboot.219restart Codex or reboot.