app/windows.md Codex Docs, 2026-04-23 00:46 UTC → 2026-05-12 01:59 UTC

8[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

9run 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).

10 10 

11![Codex app for Windows showing a project sidebar, active thread, and review pane](/images/codex/windows/codex-windows-light.webp)11<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/>

12 18 

13## Download and update the Codex app19## Download and update the Codex app

14 20 

44 50 

45## Customize for your dev setup51## Customize for your dev setup

46 52 

53<section class="feature-grid">

54 

55<div>

56 

47### Preferred editor57### Preferred editor

48 58 

49Choose 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

51different app from the **Open** menu for a project, that project-specific61different app from the **Open** menu for a project, that project-specific

52choice takes precedence.62choice takes precedence.

53 63 

54![Codex app settings showing the default Open In app on Windows](/images/codex/windows/open-in-windows-light.webp)64</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>

55 79 

56### Integrated terminal80### Integrated terminal

57 81 

67integrated terminal open, restart the app or start a new thread before91integrated terminal open, restart the app or start a new thread before

68expecting the new default terminal to appear.92expecting the new default terminal to appear.

69 93 

70![Codex app settings showing the integrated terminal selection on Windows](/images/codex/windows/integrated-shell-light.webp)94</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>

71 105 

72## Windows Subsystem for Linux (WSL)106## Windows Subsystem for Linux (WSL)

73 107 

93WSL1 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

94sandbox moved to `bubblewrap`, so WSL1 is no longer supported.128sandbox moved to `bubblewrap`, so WSL1 is no longer supported.

95 129 

96![Codex app settings showing the agent selector with Windows native and WSL options](/images/codex/windows/wsl-select-light.webp)130<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/>

97 138 

98You configure the integrated terminal independently from the agent. See139You configure the integrated terminal independently from the agent. See

99[Customize for your dev setup](#customize-for-your-dev-setup) for the140[Customize for your dev setup](#customize-for-your-dev-setup) for the