windows.md Codex Docs, 2026-04-14 12:29 UTC → 2026-05-07 17:08 UTC

3Use Codex on Windows with the native [Codex app](https://developers.openai.com/codex/app/windows), the3Use Codex on Windows with the native [Codex app](https://developers.openai.com/codex/app/windows), the

4[CLI](https://developers.openai.com/codex/cli), or the [IDE extension](https://developers.openai.com/codex/ide).4[CLI](https://developers.openai.com/codex/cli), or the [IDE extension](https://developers.openai.com/codex/ide).

5 5 

6[![](/images/codex/codex-banner-icon.webp)6The Codex app on Windows supports core workflows such as parallel agent threads,

7 7worktrees, automations, Git functionality, the in-app browser, artifact previews,

8Use the Codex app on Windows8plugins, and skills.

9 9 

10Work across projects, run parallel agent threads, and review results in one place with the native Windows app.](https://developers.openai.com/codex/app/windows)10<div class="mb-8">

11 <CodexCallout

12 href="/codex/app/windows"

13 title="Use the Codex app on Windows"

14 description="Work across projects, run parallel agent threads, and review results in one place with the native Windows app."

15 iconSrc="/images/codex/codex-banner-icon.webp"

16 />

17</div>

11 18 

12Depending on the surface and your setup, Codex can run on Windows in three19Depending on the surface and your setup, Codex can run on Windows in three

13practical ways:20practical ways:

130 137 

131 This prints your distribution name.138 This prints your distribution name.

132 139 

133If you don’t see “WSL: …” in the status bar, press `Ctrl+Shift+P`, pick140If you don't see "WSL: ..." in the status bar, press `Ctrl+Shift+P`, pick

134 `WSL: Reopen Folder in WSL`, and keep your repository under `/home/...` (not141 `WSL: Reopen Folder in WSL`, and keep your repository under `/home/...` (not

135 `C:\`) for best performance.142 `C:\`) for best performance.

136 143 

137If the Windows app or project picker does not show your WSL repository, type144If the Windows app or project picker does not show your WSL repository, type

138`\wsl$` into the file picker or Explorer, then navigate to your145 <code>\\wsl$</code> into the file picker or Explorer, then navigate to your

139 distro's home directory.146 distro's home directory.

140 147 

141### Use Codex CLI with WSL148### Use Codex CLI with WSL

167 174 

168### Working on code inside WSL175### Working on code inside WSL

169 176 

170- Working in Windows-mounted paths like `/mnt/c/…` can be slower than working in Windows-native paths. Keep your repositories under your Linux home directory (like `~/code/my-app`) for faster I/O and fewer symlink and permission issues:177- Working in Windows-mounted paths like <code>/mnt/c/...</code> can be slower than working in Windows-native paths. Keep your repositories under your Linux home directory (like <code>~/code/my-app</code>) for faster I/O and fewer symlink and permission issues:

171 

172 ```bash178 ```bash

173 mkdir -p ~/code && cd ~/code179 mkdir -p ~/code && cd ~/code

174 git clone https://github.com/your/repo.git180 git clone https://github.com/your/repo.git

175 cd repo181 cd repo

176 ```182 ```

177- If you need Windows access to files, they’re under `\wsl$\Ubuntu\home<user>` in Explorer.183- If you need Windows access to files, they're under <code>\\wsl$\Ubuntu\home\&lt;user&gt;</code> in Explorer.

178 184 

179## Troubleshooting and FAQ185## Troubleshooting and FAQ

180 186 

315 321 

316Large repositories feel slow in WSL322Large repositories feel slow in WSL

317 323 

318- Make sure you’re not working under `/mnt/c`. Move the repository to WSL (for example, `~/code/…`).324- Make sure you're not working under <code>/mnt/c</code>. Move the repository to WSL (for example, <code>~/code/...</code>).

319- Increase memory and CPU for WSL if needed; update WSL to the latest version:325- Increase memory and CPU for WSL if needed; update WSL to the latest version:

320 

321 ```powershell326 ```powershell

322 wsl --update327 wsl --update

323 wsl --shutdown328 wsl --shutdown