Interface Settings

These keys change how Claude Code looks and feels in the terminal. They cover the theme, the spinner, notices, view modes, and vim keys. Many boolean keys are written as the thing to hide, so check each row before you pick a value.

Use /config for some keys. Most boolean keys switch one display feature.

Keys

Source: Settings Reference for rows marked

Documented: An official docs page names this item.

. For rows marked

Undocumented: Only the program shows this item. It can change without notice.

, Source: the program (its bundled settings schema). Where to Set It tells you which files may set the key. See Settings Files and Scopes.

Key	Status	Type	Default	What It Does	Where to Set It
autoScrollEnabled	Documented: An official docs page names this item.	boolean	-	Follow new output to the bottom in fullscreen rendering.	Any settings file
breakReminder	Undocumented: Only the program shows this item. It can change without notice.	object	-	Show a dismissible nudge after long continuous use. It never blocks.	Settings files
companyAnnouncements	Documented: An official docs page names this item.	array of string	-	Show your organization's announcements at startup.	Any settings file
editorMode	Documented: An official docs page names this item.	string	-	Use vim key bindings in the input prompt.	Any settings file
emojiCompletionEnabled	Documented: An official docs page names this item.	boolean	-	Turn off :shortcode: emoji suggestions and replacement in the prompt input.	Any settings file
feedbackDrafts	Documented: An official docs page names this item.	enum: notify, quiet, off	-	Control whether Claude queues feedback drafts for you to review.	User or managed settings
feedbackSurveyRate	Documented: An official docs page names this item.	number	-	Change how often the session quality survey appears.	Any settings file
footerLinksRegexes	Documented: An official docs page names this item.	array	-	Make issue or review IDs in output into clickable links below the input box.	User or managed settings
maxProseWidth	Documented: An official docs page names this item.	integer	-	Cap how wide the prose in Claude's responses runs in a wide terminal.	Any settings file
preferredNotifChannel	Documented: An official docs page names this item.	string	-	Choose a terminal bell or desktop notification for task completion.	Any settings file
prefersReducedMotion	Documented: An official docs page names this item.	boolean	-	Reduce or turn off spinner, shimmer, and flash animations.	Any settings file
promptSuggestionEnabled	Documented: An official docs page names this item.	boolean	-	Hide the grayed-out prompt suggestions in the input box.	Any settings file
prUrlTemplate	Documented: An official docs page names this item.	string	-	Point PR links at an internal code-review tool instead of github.com.	Any settings file
quietHours	Undocumented: Only the program shows this item. It can change without notice.	object	-	Show one soft nudge per session during a local-time window you set. It never blocks.	Settings files
showClearContextOnPlanAccept	Documented: An official docs page names this item.	boolean	false	Show a "clear context" option on the plan accept screen.	Any settings file
showMessageTimestamps	Undocumented: Only the program shows this item. It can change without notice.	boolean	-	Stamp each message with its arrival time. The docs name a VS Code extension setting with this name, not this settings key.	Settings files
showTurnDuration	Documented: An official docs page names this item.	boolean	-	Hide the "Cooked for" duration after each response.	Any settings file
spellcheck	Documented: An official docs page names this item.	object	-	Underline misspelled words in the prompt input with a spell checker you install.	User or managed settings
spinnerTipsEnabled	Documented: An official docs page names this item.	boolean	-	Hide tips in the spinner while Claude works.	Any settings file
spinnerTipsOverride	Documented: An official docs page names this item.	object	-	Add your own tips to the spinner rotation, or replace the built-in tips.	Any settings file
spinnerVerbs	Documented: An official docs page names this item.	object	-	Add or replace the verbs shown while a turn runs.	Any settings file
syntaxHighlightingDisabled	Documented: An official docs page names this item.	boolean	-	Turn off syntax highlighting in diffs and code blocks.	Any settings file
terminalProgressBarEnabled	Documented: An official docs page names this item.	boolean	-	Hide the terminal progress bar in terminals that support it.	Any settings file
terminalTitleFromRename	Documented: An official docs page names this item.	boolean	true	Stop /rename and --name from changing the terminal tab title.	Any settings file
theme	Documented: An official docs page names this item.	string	-	Pick the interface color theme, built-in or custom.	Any settings file
timeFormat	Documented: An official docs page names this item.	string	-	Show the times in the interface on a 12-hour or 24-hour clock, in UTC, or with a strftime pattern.	Any settings file
timeZone	Documented: An official docs page names this item.	string	The system time zone	Show the times in the interface in a time zone other than your system's.	Any settings file
tui	Documented: An official docs page names this item.	enum: default, fullscreen	-	Choose the fullscreen or classic terminal renderer.	Any settings file
verbose	Documented: An official docs page names this item.	boolean	-	Show full tool output instead of truncated summaries. viewMode takes precedence when you set both.	Any settings file
viewMode	Documented: An official docs page names this item.	enum: default, verbose, focus	-	Start every session in default, verbose, or focus view.	Any settings file
vimInsertModeRemaps	Documented: An official docs page names this item.	object	-	Map a two-key INSERT-mode sequence such as jj to Escape.	User or managed settings
voice	Documented: An official docs page names this item.	object	-	Turn on voice dictation and pick hold or tap mode.	Any settings file
wheelScrollAccelerationEnabled	Documented: An official docs page names this item.	boolean	-	Turn off mouse-wheel acceleration in fullscreen rendering.	Any settings file

Example

Calm Terminal

This file hides spinner tips. It reduces animation. It starts every session in focus view. It picks the fullscreen renderer.

~/.claude/settings.json

{
  "$schema": "https://clawdipedia.cc/schemas/claude-code-settings.json",
  "spinnerTipsEnabled": false,
  "prefersReducedMotion": true,
  "viewMode": "focus",
  "tui": "fullscreen"
}

Related Pages

• Settings Files and Scopes explains the scopes, precedence, and managed settings.
• Settings Reference is the official page for each key.
• Customize Keyboard Shortcuts covers key bindings.
• Keybindings lists every context and action with its default key.
• Status Line and Output Styles cover two related features.
• UI and Terminal Variables lists the matching environment variables.