claude-code - 💡(How to fix) Fix [DOCS] `/terminal-setup` GPU acceleration disablement for VS Code/Cursor/Windsurf undocumented

Documentation Type

Missing documentation (feature not documented)

Documentation Location

https://code.claude.com/docs/en/terminal-config

Section/Topic

The "Enter multiline prompts" section, specifically the /terminal-setup command description for VS Code, Cursor, and Windsurf terminals.

Current Documentation

From the terminal-config page:

For VS Code, Cursor, Windsurf, Alacritty, and Zed, /terminal-setup writes Shift+Enter and other keybindings into the terminal's configuration file. In VS Code, Cursor, and Windsurf it also sets terminal.integrated.mouseWheelScrollSensitivity in the editor settings for smoother scrolling in fullscreen mode.

From the commands reference:

/terminal-setup — Configure terminal keybindings for Shift+Enter and other shortcuts. Only visible in terminals that need it, like VS Code, Cursor, Windsurf, Alacritty, or Zed

Neither page mentions that /terminal-setup disables GPU acceleration.

What's Wrong or Missing?

As of v2.1.157, /terminal-setup now disables GPU acceleration in VS Code, Cursor, and Windsurf integrated terminals to prevent garbled-text rendering. This behavior change is documented in the changelog but not in the terminal-config or commands reference pages.

Users who run /terminal-setup may notice GPU acceleration is disabled without understanding why, and users experiencing garbled text may not know that /terminal-setup can resolve the issue — since the documentation only describes keybinding and scroll-sensitivity changes.

Suggested Improvement

Add a sentence to the /terminal-setup description on the terminal-config page (after the existing mouseWheelScrollSensitivity sentence):

It also disables GPU acceleration (terminal.integrated.gpuAcceleration) in the editor settings. GPU acceleration can cause garbled-text rendering in Claude Code's fullscreen mode in these terminals, so disabling it prevents display corruption.

Similarly, update the commands reference entry to mention GPU acceleration handling.

Impact

Medium - Makes feature difficult to understand

Additional Context

Affected Pages:

Total scope: 2 pages affected

The changelog for v2.1.157 reports: "/terminal-setup now disables GPU acceleration in VS Code/Cursor/Windsurf integrated terminals to prevent garbled-text rendering." The terminal-config page already documents the keybinding and scroll-sensitivity changes that /terminal-setup applies; the GPU acceleration change belongs alongside those.