[DOCS] [Fullscreen] New `wheelScrollAccelerationEnabled` setting added in v2.1.174 is undocumented in `fullscreen.md` and the settings table

Documentation Type

Missing documentation (feature not documented)

Documentation Location

https://code.claude.com/docs/en/fullscreen

Section/Topic

The "Mouse wheel scrolling" section in docs/en/fullscreen.md and the Available settings table in docs/en/settings.md. The new setting lets users disable terminal-specific wheel-event acceleration (e.g. macOS, iTerm2 "Faster scrolling", Ghostty amplification) in fullscreen mode, but neither page mentions it.

Current Documentation

docs/en/fullscreen.md (line 87) currently says:

"If mouse wheel scrolling feels slow, your terminal may be sending one scroll event per physical notch with no multiplier. Some terminals, like Ghostty and iTerm2 with faster scrolling enabled, already amplify wheel events. Others, including the VS Code integrated terminal, send exactly one event per notch. Claude Code cannot detect which. Set CLAUDE_CODE_SCROLL_SPEED to multiply the base scroll distance: ``bash theme={null} export CLAUDE_CODE_SCROLL_SPEED=3 ` A value of 3 matches the default in vim` and similar applications. The setting accepts values from 1 to 20."

docs/en/settings.md lists every scroll-related setting in the Available settings table (autoScrollEnabled, CLAUDE_CODE_SCROLL_SPEED in env-vars) but has no row for wheelScrollAccelerationEnabled.

What's Wrong or Missing?

A. The new wheelScrollAccelerationEnabled setting is not documented anywhere

The v2.1.174 changelog entry reads:

"Added wheelScrollAccelerationEnabled setting to disable mouse-wheel scroll acceleration in fullscreen mode"

The setting is the documented escape hatch for the very problem the "Mouse wheel scrolling" section calls out: terminals that amplify wheel events and make CLAUDE_CODE_SCROLL_SPEED overshoot. The page already explains the symptom; it just doesn't name the setting that turns acceleration off.

B. The settings table does not list wheelScrollAccelerationEnabled

Users browsing settings.md for scroll-related knobs find autoScrollEnabled but nothing about wheel acceleration. The env-var cross-reference is also missing.

C. The /scroll-speed command description does not mention acceleration

commands.md line 119 documents /scroll-speed as tuning "the same value the CLAUDE_CODE_SCROLL_SPEED environment variable sets." The new setting sits alongside CLAUDE_CODE_SCROLL_SPEED semantically (one is the multiplier, the other controls whether the multiplier is needed at all) and should be cross-referenced from /scroll-speed's description.

Suggested Improvement

Option A: Comprehensive fix

1. In docs/en/fullscreen.md, add a new subsection after the "Mouse wheel scrolling" examples:

> "### Disable terminal scroll acceleration
>
> Some terminals amplify wheel events (macOS system preference, iTerm2 with Faster scrolling enabled, Ghostty). The amplification can make Claude Code's scroll distance feel uneven because Claude Code cannot tell the amplified from the non-amplified stream. Set wheelScrollAccelerationEnabled to false in your settings file to make Claude Code treat all wheel events the same regardless of any terminal-side acceleration:
>
> ``json theme={null}
> {
> "wheelScrollAccelerationEnabled": false
> }
> `
>
> This pairs with [CLAUDE_CODE_SCROLL_SPEED](#mouse-wheel-scrolling) and the [/scroll-speed`](https://code.claude.com/docs/en/commands) command: turn acceleration off first, then tune the multiplier. Added in v2.1.174."

1. In docs/en/settings.md, add an Available settings row for wheelScrollAccelerationEnabled near the autoScrollEnabled row, linking to the new subsection.

1. In docs/en/commands.md, append a sentence to the /scroll-speed description:

> "If your terminal amplifies wheel events (e.g. macOS, iTerm2 with Faster scrolling, Ghostty), set wheelScrollAccelerationEnabled to false first, then use /scroll-speed to tune the multiplier."

Option B: Minimum fix

Add the new subsection to docs/en/fullscreen.md only. Leave settings.md and commands.md updates for a later pass; users who need the setting will find it from the new subsection's [settings file] link.

Impact

Medium - Makes feature difficult to understand

Additional Context

Affected Pages:

| Page | Line(s) | Context |
|------|---------|---------|
| https://code.claude.com/docs/en/fullscreen | 87-95 | "Mouse wheel scrolling" section describes the symptom (terminal amplification) but does not name the new setting that turns it off |
| https://code.claude.com/docs/en/settings | (table) | No row for wheelScrollAccelerationEnabled in the Available settings table |
| https://code.claude.com/docs/en/commands | 119 | /scroll-speed description does not mention wheelScrollAccelerationEnabled as the prerequisite for tuning terminals that amplify wheel events |
| https://code.claude.com/docs/en/env-vars | (table) | CLAUDE_CODE_SCROLL_SPEED row has no cross-reference to the new wheelScrollAccelerationEnabled setting |
| https://code.claude.com/docs/en/changelog | 13 | Sole mention of the v2.1.174 setting; no cross-references to the affected docs |

Total scope: 4 pages affected, plus the changelog.

Cross-references:

• https://code.claude.com/docs/en/keybindings — fullscreen toggle is mentioned there; the new setting is a related fullscreen-only control
• https://code.claude.com/docs/en/settings#available-settings — the new row should be added in alphabetical order with the other scroll-related rows

Version: v2.1.174 (June 12, 2026)