Configure your terminal for Claude Code changedterminal-config
Nearest release: v2.1.283, published 2 hours before upstream edited the page. Shown because the two are within 24 hours of each other. Nothing here says the release caused the edit.
Upstream edited this page at 25 Sep 2026 20:51 UTC, give or take a minute or two: the time comes from Anthropic’s own sitemap rather than from a commit. This site recorded the change at 28 Sep 2026 23:37 UTC.
Upstream edited
Recorded here
Lines+51added
Lines−51removed
From line
20
where the diff opens
First seen
14 Aug 2026
this site's first read of the page
Recorded edits25to this page, all time
The whole hunk
from line 20, old and new numbered
/
from line 20
2020
2121In most terminals you can also press Shift+Enter, but support varies by terminal emulator:
2222
23| Terminal | Shift+Enter for newline |
24| :------------------------------------------------------------------------------------------------- | :---------------------------------------------------------- |
25| Ghostty, Kitty, iTerm2, WezTerm, Warp, Apple Terminal, Windows Terminal | Works without setup |
23| Terminal | Shift+Enter for newline |
24| :- | :- |
25| Ghostty, Kitty, iTerm2, WezTerm, Warp, Apple Terminal, Windows Terminal | Works without setup |
2626| Other terminals that support the kitty keyboard protocol, such as foot and Alacritty 0.16 or later | Works without setup. Requires Claude Code v2.1.269 or later |
27| VS Code, Cursor, Devin Desktop, Alacritty before 0.16, Zed | Run `/terminal-setup` once |
28| gnome-terminal, JetBrains IDEs such as PyCharm and Android Studio | Not available; use Ctrl+J or `\` then Enter |
27| VS Code, Cursor, Devin Desktop, Alacritty before 0.16, Zed | Run `/terminal-setup` once |
28| gnome-terminal, JetBrains IDEs such as PyCharm and Android Studio | Not available; use Ctrl+J or `\` then Enter |
2929
3030For VS Code, Cursor, Devin Desktop, Alacritty before 0.16, and Zed, `/terminal-setup` writes a Shift+Enter keybinding into the terminal's configuration file. On the first run you see a confirmation such as `Installed VSCode terminal Shift+Enter key binding`. Existing bindings are left in place; if you see a message such as `VSCode terminal Shift+Enter key binding already configured`, no change was made. Run `/terminal-setup` directly in the host terminal rather than inside tmux or screen, since it needs to write to the host terminal's configuration.
3131
from line 140
140140
141141Each custom theme is a JSON file in `~/.claude/themes/`. The filename without the `.json` extension is the theme's slug, and selecting the theme stores `custom:<slug>` as your theme preference. The file has three optional fields:
142142
143| Field | Type | Description |
144| :---------- | :----- | :---------------------------------------------------------------------------------------------------------------------------------------------- |
145| `name` | string | Display label shown in `/theme`. Defaults to the filename slug |
146| `base` | string | Built-in preset the theme starts from: `dark`, `light`, `dark-daltonized`, `light-daltonized`, `dark-ansi`, or `light-ansi`. Defaults to `dark` |
147| `overrides` | object | Map of color token names to color values. Tokens not listed here fall through to the base preset |
143| Field | Type | Description |
144| :- | :- | :- |
145| `name` | string | Display label shown in `/theme`. Defaults to the filename slug |
146| `base` | string | Built-in preset the theme starts from: `dark`, `light`, `dark-daltonized`, `light-daltonized`, `dark-ansi`, or `light-ansi`. Defaults to `dark` |
147| `overrides` | object | Map of color token names to color values. Tokens not listed here fall through to the base preset |
148148
149149Color values accept `#rrggbb`, `#rgb`, `rgb(r,g,b)`, `ansi256(n)`, or `ansi:<name>` where `<name>` is one of the 16 standard ANSI color names such as `red` or `cyanBright`. Unknown tokens and invalid color values are ignored, so a typo cannot break rendering.
150150
from line 187
187187
188188 Control the primary brand accent and the foreground text shades used throughout the interface.
189189
190 | Token | Controls |
191 | :------------ | :--------------------------------------------------------------- |
192 | `claude` | Primary brand accent, used for the spinner and assistant label |
193 | `text` | Default foreground text |
190 | Token | Controls |
191 | :- | :- |
192 | `claude` | Primary brand accent, used for the spinner and assistant label |
193 | `text` | Default foreground text |
194194 | `inverseText` | Text drawn on top of a colored background, such as status badges |
195 | `inactive` | Secondary text such as hints, timestamps, and disabled items |
196 | `subtle` | Faint borders and de-emphasized secondary text |
197 | `suggestion` | Autocomplete suggestions and selection highlight in pickers |
198 | `permission` | Dialog borders, including permission prompts and pickers |
199 | `remember` | Memory and `CLAUDE.md` indicators |
195 | `inactive` | Secondary text such as hints, timestamps, and disabled items |
196 | `subtle` | Faint borders and de-emphasized secondary text |
197 | `suggestion` | Autocomplete suggestions and selection highlight in pickers |
198 | `permission` | Dialog borders, including permission prompts and pickers |
199 | `remember` | Memory and `CLAUDE.md` indicators |
200200
201201 #### Status colors
202202
203203 Signal success, failure, and warning states across messages and indicators.
204204
205 | Token | Controls |
206 | :-------- | :------------------------------------------------------ |
207 | `success` | Success messages and passing checks |
208 | `error` | Error messages and failures |
205 | Token | Controls |
206 | :- | :- |
207 | `success` | Success messages and passing checks |
208 | `error` | Error messages and failures |
209209 | `warning` | Warnings, caution messages, and the auto mode indicator |
210 | `merged` | Merged pull request status |
210 | `merged` | Merged pull request status |
211211
212212 #### Input box and mode indicators
213213
214214 Set the input box border color and the accent shown while a permission mode or indicator is active.
215215
216 | Token | Controls |
217 | :------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
218 | `promptBorder` | Input box border |
219 | `planMode` | Plan mode accent, plan messages, and plan-mode dialogs |
220 | `autoAccept` | Accept-edits mode accent |
221 | `bashBorder` | Input box border when entering a `!` shell command |
222 | `ide` | IDE connection indicator |
223 | `fastMode` | Fast mode indicator |
224 | `effortUltra` | The `ultracode` tag on the input box border while [ultracode](/docs/en/model-config#adjust-effort-level) is on. Your override of this color takes effect on Claude Code v2.1.239 or later |
216 | Token | Controls |
217 | :- | :- |
218 | `promptBorder` | Input box border |
219 | `planMode` | Plan mode accent, plan messages, and plan-mode dialogs |
220 | `autoAccept` | Accept-edits mode accent |
221 | `bashBorder` | Input box border when entering a `!` shell command |
222 | `ide` | IDE connection indicator |
223 | `fastMode` | Fast mode indicator |
224 | `effortUltra` | The `ultracode` tag on the input box border while [ultracode](/docs/en/model-config#adjust-effort-level) is on. Your override of this color takes effect on Claude Code v2.1.239 or later |
225225
226226 #### Diff rendering
227227
228228 Color added and removed code in file edits and reviews.
229229
230 | Token | Controls |
231 | :------------------ | :---------------------------------------------------------------------------- |
232 | `diffAdded` | Background of added lines |
233 | `diffRemoved` | Background of removed lines |
234 | `diffAddedDimmed` | Background of added lines in the dimmed diff shown after you reject an edit |
230 | Token | Controls |
231 | :- | :- |
232 | `diffAdded` | Background of added lines |
233 | `diffRemoved` | Background of removed lines |
234 | `diffAddedDimmed` | Background of added lines in the dimmed diff shown after you reject an edit |
235235 | `diffRemovedDimmed` | Background of removed lines in the dimmed diff shown after you reject an edit |
236 | `diffAddedWord` | Word-level highlight within an added line |
237 | `diffRemovedWord` | Word-level highlight within a removed line |
236 | `diffAddedWord` | Word-level highlight within an added line |
237 | `diffRemovedWord` | Word-level highlight within a removed line |
238238
239239 #### Fullscreen mode
240240
241241 Claude Code paints `userMessageBackground`, `bashMessageBackgroundColor`, and `memoryBackgroundColor` in both the default and fullscreen renderers. It uses `userMessageBackgroundHover` and `selectionBg` only in [fullscreen rendering mode](/docs/en/fullscreen).
242242
243 | Token | Controls |
244 | :--------------------------- | :------------------------------------------------------------ |
245 | `userMessageBackground` | Background behind your messages in the transcript |
246 | `userMessageBackgroundHover` | Background behind a message while hovered or expanded |
243 | Token | Controls |
244 | :- | :- |
245 | `userMessageBackground` | Background behind your messages in the transcript |
246 | `userMessageBackgroundHover` | Background behind a message while hovered or expanded |
247247 | `bashMessageBackgroundColor` | Background behind `!` shell command entries in the transcript |
248 | `memoryBackgroundColor` | Background behind `#` memory entries in the transcript |
249 | `selectionBg` | Background of text selected with the mouse |
248 | `memoryBackgroundColor` | Background behind `#` memory entries in the transcript |
249 | `selectionBg` | Background of text selected with the mouse |
250250
251251 #### Usage meter and speaker labels
252252
253253 Adjust the bar shown in the `/usage` view and the labels that distinguish your messages from Claude's.
254254
255 | Token | Controls |
256 | :----------------- | :------------------------------------------------ |
257 | `rate_limit_fill` | Filled portion of the usage meter |
258 | `rate_limit_empty` | Unfilled portion of the usage meter |
259 | `briefLabelYou` | Color of the `You` label on your messages |
255 | Token | Controls |
256 | :- | :- |
257 | `rate_limit_fill` | Filled portion of the usage meter |
258 | `rate_limit_empty` | Unfilled portion of the usage meter |
259 | `briefLabelYou` | Color of the `You` label on your messages |
260260 | `briefLabelClaude` | Color of the `Claude` label on assistant messages |
261261
262262 #### Shimmer variants and subagent colors
No line in this hunk matches that.