Codex IDE extension settings
Use these settings to customize the Codex IDE extension.
Change a setting
To change a setting, follow these steps:
- Open your editor settings.
- Search for
Codexor the setting name. - Update the value.
The Codex IDE extension uses the Codex CLI. Configure some behavior, such as the default model, approvals, and sandbox settings, in the shared ~/.codex/config.toml file instead of in editor settings. See Config basics.
The extension also honors VS Code's built-in chat font settings for Codex conversation surfaces.
Settings reference
| Setting | Description |
|---|---|
chat.fontSize |
Controls chat text in the Codex sidebar, including conversation content and the composer. |
chat.editor.fontSize |
Controls code-rendered content in Codex conversations, including code snippets and diffs. |
chatgpt.cliExecutable |
Development only: Path to the Codex CLI executable. You don't need to set this unless you're actively developing the Codex CLI. If you set this manually, parts of the extension might not work as expected. |
chatgpt.commentCodeLensEnabled |
Show CodeLens above to-do comments so you can complete them with Codex. |
chatgpt.localeOverride |
Preferred language for the Codex UI. Leave empty to detect automatically. |
chatgpt.openOnStartup |
Focus the Codex sidebar when the extension finishes starting. |
chatgpt.runCodexInWindowsSubsystemForLinux |
Windows only: Run Codex in WSL when Windows Subsystem for Linux (WSL) is available. Use this when your repositories and tooling live in WSL2 or when you need Linux-native tooling. Otherwise, Codex can run natively on Windows with the Windows sandbox. Changing this setting reloads VS Code to apply the change. |