1# Developer settings1# Settings
2 2
3> For the complete documentation index, see [llms.txt](https://learn.chatgpt.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to the page URL.3> For the complete documentation index, see [llms.txt](https://learn.chatgpt.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to the page URL.
4 4
5The Codex IDE extension has two settings layers:5Use the settings panel to personalize the app and manage everyday preferences.
6Open [**Settings**](codex://settings) from the app menu or press
6 7
7- **Codex settings** control agent behavior shared with Codex CLI, including the8<kbd>Cmd</kbd>+<kbd>,</kbd> on macOS or <kbd>Ctrl</kbd>+<kbd>,</kbd> on Windows.
8 model, reasoning effort, permissions, sandbox, MCP servers, and
9 personalization. Codex reads these settings from `config.toml`.
10- **Editor settings** control how the extension behaves inside VS Code and
11 compatible editors. These settings use `chatgpt.*` keys in the editor's
12 settings system.
13 9
14## Open Codex settings10## General
15 11
16Select the gear icon in the Codex sidebar, then select **Codex Settings**. Use12Require <kbd>Cmd</kbd>+<kbd>Enter</kbd> for multiline prompts, or turn on
17the settings panel for common agent controls, or select **Open config.toml** to13**Prevent sleep while running** so local chats can continue while you step away.
18edit the active configuration layer directly.14Under **Follow-up behavior**, choose whether a message sent while ChatGPT works
15should steer the current run or wait for the next run.
19 16
20For the configuration layer order and common keys, see [Config17## Profile
21basics](https://learn.chatgpt.com/docs/config-file/config-basic). For every supported `config.toml` key, see the
22[Configuration reference](https://learn.chatgpt.com/docs/config-file/config-reference).
23 18
24## Change an editor setting19Use **Profile** to review activity insights, lifetime tokens, peak tokens,
20streaks, your longest task, and token activity. You can also update your profile
21details, such as your picture, display name, and username, and save a profile
22card with usage highlights. Sharing profile cards is available on consumer
23ChatGPT plans.
25 24
26To change a setting, follow these steps:25Eligible users can also send Codex invitations from the profile menu. Choose
26**Invite a friend** on an eligible personal plan or **Invite a coworker** in an
27eligible Business workspace. See
28[Invite friends and coworkers](https://learn.chatgpt.com/docs/pricing#invite-friends-and-coworkers) for
29current rewards, limits, and eligibility.
27 30
281. Open your editor settings.31## Keyboard shortcuts
292. Search for `@ext:openai.chatgpt`, `Codex`, or the setting name.
303. Update the value.
31 32
32The extension also honors VS Code's built-in chat font settings for Codex chat surfaces.33Open **Keyboard Shortcuts** to review commands, change bindings, or reset custom
34shortcuts to their defaults. Use the search field to find shortcuts by command
35name, or switch to keystroke search and press a key combination to find the
36command that uses it.
33 37
34## Editor settings reference38## Notifications
35 39
36| Setting | Default | Description |40Choose when turn completion notifications appear, and whether the app should prompt for
37| -------------------------------------------- | -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |41notification permissions.
38| `chatgpt.commentCodeLensEnabled` | `true` | Show CodeLens above `TODO` comments so Codex can address them. |
39| `chatgpt.openOnStartup` | `false` | Focus the Codex sidebar when the extension finishes starting. |
40| `chatgpt.followUpQueueMode` | `queue` | Choose whether messages sent during a run wait for the next run (`queue`) or steer the current run (`steer`). The extension treats the legacy `interrupt` value as `steer`. Press <kbd>Cmd</kbd>/<kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>Enter</kbd> to invert the behavior for one message. |
41| `chatgpt.composerEnterBehavior` | `enter` | Choose whether <kbd>Enter</kbd> always sends (`enter`), <kbd>Cmd</kbd>/<kbd>Ctrl</kbd>+<kbd>Enter</kbd> sends multiline prompts (`cmdIfMultiline`), or the modifier is always required (`cmdAlways`). |
42| `chatgpt.reviewDelivery` | `inline` | Run `/review` in the current chat when possible (`inline`) or start a separate review chat (`detached`). |
43| `chatgpt.localeOverride` | Auto | Set the preferred language for the Codex UI. Leave empty to detect it automatically. |
44| `chatgpt.runCodexInWindowsSubsystemForLinux` | `false` | Windows only: Run Codex in WSL when WSL is available. Use this when your repositories and tooling live in WSL2 or when you need Linux-native tooling. Changing this setting reloads VS Code. |
45| `chatgpt.cliExecutable` | Unset | Development only: Set the path to the Codex CLI executable. You don't need this setting unless you're developing the Codex CLI; manually overriding the bundled executable can prevent parts of the extension from working. |
46| `chat.fontSize` | Editor default | Control chat text in the Codex sidebar, including chat content and the composer. |
47| `chat.editor.fontSize` | Editor default | Control code-rendered content in Codex chats, including code snippets and diffs. |
48 42
49The `chatgpt.*` keys above belong to the IDE extension and don't go in43## Appearance
50`config.toml`. For shared agent settings, use [Config44
51basics](https://learn.chatgpt.com/docs/config-file/config-basic), [Advanced configuration](https://learn.chatgpt.com/docs/config-file/config-advanced),45In **Settings**, you can change the app appearance by choosing a base theme,
52and the [Configuration reference](https://learn.chatgpt.com/docs/config-file/config-reference).46adjusting accent, background, and foreground colors, and changing the UI and
47code fonts. You can also share your custom theme with friends.
48
49<CodexScreenshot
50 alt="ChatGPT desktop app Appearance settings showing theme selection, color controls, and font options"
51 lightSrc="/images/codex/app/theme-selection-light.webp"
52 darkSrc="/images/codex/app/theme-selection-dark.webp"
53 maxHeight="720px"
54 class="mb-8"
55/>
56
57## Pets
58
59
60
61
62
63 Pets are optional animated companions for the app. In **Settings > Pets**,
64 choose a built-in or custom pet, then use `/pet`, **Wake Pet**, or
65 **Tuck Away Pet** to control the floating overlay.
66
67 See [Pets](https://learn.chatgpt.com/docs/pets?surface=app) to understand pet status, follow
68 activity across chats, or create your own pet.
69
70
71
72
73 <CodexPetsDemo client:load />
74
75
76
77<a id="browser-use"></a>
78
79## Browser
80
81Use these settings to install or enable the bundled Browser plugin, set up the
82[Chrome extension](https://learn.chatgpt.com/docs/chrome-extension), and manage allowed and blocked
83websites. ChatGPT asks before using a website unless you've allowed it. Removing
84a blocked site lets ChatGPT ask again before using it in the browser.
85
86See [Built-in browser](https://learn.chatgpt.com/docs/browser?surface=app) for browser preview, comment, and
87Computer Use workflows.
88
89## Computer Use
90
91Check your Computer Use settings to review desktop-app access and related
92preferences after setup. On macOS, revoke system-level access by updating Screen
93Recording or Accessibility permissions in macOS Privacy & Security settings.
94
95## Personalization
96
97Choose **Friendly**, **Pragmatic**, or **None** as your default personality. Use
98**None** to disable personality instructions. You can update this at any time.
99
100You can also add your own custom instructions. Editing custom instructions updates your
101[personal instructions in `AGENTS.md`](https://learn.chatgpt.com/docs/agent-configuration/agents-md).
102
103## Suggested prompts
104
105Use context-aware suggestions to surface follow-ups and tasks you may want to resume when you
106start or return to ChatGPT.
107
108## Memories
109
110Enable Memories, where available, to let ChatGPT carry useful context from past
111chats into future work. See [Memories](https://learn.chatgpt.com/docs/customization/memories)
112for setup, storage, and controls for individual chats.
113
114<a id="archived-tasks"></a>
115
116## Archived chats
117
118The **Archived chats** section lists archived chats with dates and project
119context. Use **Unarchive** to restore a chat.
120
121<a id="keep-an-app-task-near-your-work"></a>
122<a id="keep-an-app-chat-near-your-work"></a>
123<a id="keep-a-task-near-your-work"></a>
124
125## Keep a chat near your work
126
127In the ChatGPT desktop app, pop out an active chat into a separate window and place it
128next to your browser, editor, or design preview. Turn on **Always on top** when
129you want the chat to remain visible while you work in another app.
130
131<CodexScreenshot
132 alt="ChatGPT desktop app chat displayed in a floating pop-out window"
133 lightSrc="/images/codex/app/popover-light.webp"
134 darkSrc="/images/codex/app/popover-dark.webp"
135 maxHeight="400px"
136 class="my-8"
137/>