app/windows.md +54 −11
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).
8 10
911<CodexScreenshot
12 alt="Codex app for Windows showing a project sidebar, active thread, and review pane"
13 lightSrc="/images/codex/windows/codex-windows-light.webp"
14 darkSrc="/images/codex/windows/codex-windows-dark.webp"
15 variant="no-wallpaper"
16 maxHeight="320px"
17/>
10 18
11## Download and update the Codex app19## Download and update the Codex app
12 20
42 50
43## Customize for your dev setup51## Customize for your dev setup
44 52
53<section class="feature-grid">
54
55<div>
56
45### Preferred editor57### Preferred editor
46 58
47Choose a default app for **Open**, such as Visual Studio, VS Code, or another59Choose a default app for **Open**, such as Visual Studio, VS Code, or another
49different app from the **Open** menu for a project, that project-specific61different app from the **Open** menu for a project, that project-specific
50choice takes precedence.62choice takes precedence.
51 63
5264</div>
65
66<CodexScreenshot
67 alt="Codex app settings showing the default Open In app on Windows"
68 lightSrc="/images/codex/windows/open-in-windows-light.webp"
69 darkSrc="/images/codex/windows/open-in-windows-dark.webp"
70 maxHeight={520}
71 maxWidth={784}
72/>
73
74</section>
75
76<section class="feature-grid inverse">
77
78<div>
53 79
54### Integrated terminal80### Integrated terminal
55 81
65integrated terminal open, restart the app or start a new thread before91integrated terminal open, restart the app or start a new thread before
66expecting the new default terminal to appear.92expecting the new default terminal to appear.
67 93
6894</div>
95
96<CodexScreenshot
97 alt="Codex app settings showing the integrated terminal selection on Windows"
98 lightSrc="/images/codex/windows/integrated-shell-light.webp"
99 darkSrc="/images/codex/windows/integrated-shell-dark.webp"
100 maxHeight={520}
101 maxWidth={788}
102/>
103
104</section>
69 105
70## Windows Subsystem for Linux (WSL)106## Windows Subsystem for Linux (WSL)
71 107
91WSL1 was supported through Codex `0.114`. Starting in Codex `0.115`, the Linux127WSL1 was supported through Codex `0.114`. Starting in Codex `0.115`, the Linux
92sandbox moved to `bubblewrap`, so WSL1 is no longer supported.128sandbox moved to `bubblewrap`, so WSL1 is no longer supported.
93 129
94130<CodexScreenshot
131 alt="Codex app settings showing the agent selector with Windows native and WSL options"
132 lightSrc="/images/codex/windows/wsl-select-light.webp"
133 darkSrc="/images/codex/windows/wsl-select-dark.webp"
134 maxHeight={520}
135 maxWidth={786}
136 class="mb-8"
137/>
95 138
96You configure the integrated terminal independently from the agent. See139You configure the integrated terminal independently from the agent. See
97[Customize for your dev setup](#customize-for-your-dev-setup) for the140[Customize for your dev setup](#customize-for-your-dev-setup) for the
184`%USERPROFILE%\.codex`.227`%USERPROFILE%\.codex`.
185 228
186If you also run the Codex CLI inside WSL, the CLI uses the Linux home229If you also run the Codex CLI inside WSL, the CLI uses the Linux home
187230directory by default, so it does not automatically share configuration, cacheddirectory by default, so it doesn't automatically share configuration, cached
188auth, or session history with the Windows app.231auth, or session history with the Windows app.
189 232
190To share them, use one of these approaches:233To share them, use one of these approaches:
206 249
207### Git isn't detected for projects opened from `\\wsl$`250### Git isn't detected for projects opened from `\\wsl$`
208 251
209252For now, if you want to use the Windows-native agent with a project that isFor now, if you want to use the Windows-native agent with a project also
210253also accessible from WSL, the most reliable workaround is to store the projectaccessible from WSL, the most reliable workaround is to store the project
211on the native Windows drive and access it in WSL through `/mnt/<drive>/...`.254on the native Windows drive and access it in WSL through `/mnt/<drive>/...`.
212 255
213256### Cmder is not listed in the open dialog### `Cmder` isn't listed in the open dialog
214 257
215258If Cmder is installed but doesn’t show in Codex’s open dialog, add it to theIf `Cmder` is installed but doesn't show in Codex's open dialog, add it to the
216259Windows Start Menu: right-click Cmder and choose **Add to Start**, then restartWindows Start Menu: right-click `Cmder` and choose **Add to Start**, then
217260Codex or reboot.restart Codex or reboot.