app/windows.md +47 −4
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