Primary navigation

Codex IDE extension settings

Reference for Codex IDE extension settings

Use these settings to customize the Codex IDE extension.

Change a setting

To change a setting, follow these steps:

  1. Open your editor settings.
  2. Search for Codex or the setting name.
  3. 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 Basic Config.

Settings reference

SettingDescription
chatgpt.cliExecutableDevelopment 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.commentCodeLensEnabledShow CodeLens above to-do comments so you can complete them with Codex.
chatgpt.localeOverridePreferred language for the Codex UI. Leave empty to detect automatically.
chatgpt.openOnStartupFocus the Codex sidebar when the extension finishes starting.
chatgpt.runCodexInWindowsSubsystemForLinuxWindows only: Run Codex in WSL when Windows Subsystem for Linux (WSL) is available. Recommended for improved sandbox security and better performance. Codex agent mode on Windows currently requires WSL. Changing this setting reloads VS Code to apply the change.