[DOCS] Settings page missing `spinnerTipsOverride` configuration documentation
Documentation Type
Missing documentation (feature not documented)
Documentation Location
https://code.claude.com/docs/en/settings
Section/Topic
"Customization settings" table
Current Documentation
The settings page documents two spinner-related settings:
|spinnerVerbs| Customize the action verbs shown in the spinner and turn duration messages. Setmodeto"replace"to use only your verbs, or"append"to add them to the defaults |{"mode": "append", "verbs": ["Pondering", "Crafting"]}| |spinnerTipsEnabled| Show tips in the spinner while Claude is working. Set tofalseto disable tips (default:true) |false|
No documentation exists for spinnerTipsOverride.
What's Wrong or Missing?
Claude Code v2.1.45 added a spinnerTipsOverride setting that allows users to customize spinner tip content. The setting supports:
- A
tipsarray of custom tip strings - An optional
excludeDefault: trueflag to show only custom tips instead of the built-in ones
The settings page documents spinnerTipsEnabled (toggle tips on/off) and spinnerVerbs (customize action verbs), but does not document spinnerTipsOverride (customize the actual tip text). Users who want to customize what tips are shown have no way to discover this setting from the documentation.
Suggested Improvement
Add a row to the Customization settings table:
| Setting | Description | Example |
|---------|-------------|---------|
| spinnerTipsOverride | Customize the tips shown in the spinner while Claude is working. Configure tips with an array of custom tip strings. Set excludeDefault: true to show only your custom tips instead of the built-in ones | {"tips": ["Try /compact to save context", "Use @file to reference files"], "excludeDefault": true} |
Place it adjacent to the existing spinnerVerbs and spinnerTipsEnabled rows to group all spinner customization together.
Impact
Medium - Makes feature difficult to understand
Additional Context
Affected Pages:
| Page | Context |
|------|---------|
| https://code.claude.com/docs/en/settings | Customization settings table — missing spinnerTipsOverride row |
Total scope: 1 page affected
Source: Changelog v2.1.45 — "Added spinnerTipsOverride setting to customize spinner tips — configure tips with an array of custom tip strings, and optionally set excludeDefault: true to show only your custom tips instead of the built-in ones"
This issue has 2 comments on GitHub. Read the full discussion on GitHub ↗