GNOME Terminal: native scroll + right-click both captured inside Claude Code TUI

Problem

In GNOME Terminal (Linux), native mouse-wheel scrollback and right-click context menu both work everywhere — except inside a running Claude Code session. The fullscreen TUI switches the terminal into mouse-reporting + alternate-screen mode, so the terminal's own scroll and right-click are captured and stop working. Outside Claude (plain shell, SSH, other TUIs) both work fine.

This reads to users as "Claude Code broke my terminal." It is recoverable, but it is not discoverable.

Expected

Native scroll-wheel scrollback and right-click should keep working inside Claude Code by default, the same as a normal terminal — or there should be an obvious in-app toggle for it.

Current workaround (hard to find)

export CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN=1   # classic renderer: native scroll + right-click work
# or
export CLAUDE_CODE_DISABLE_MOUSE=1              # keeps fullscreen, frees mouse, loses wheel-scroll of Claude's pane

These env vars are buried in docs. Most users never find them and just think the terminal is broken.

Request

1. Make native scroll + right-click work inside the TUI by default in GNOME Terminal, or
2. Add a visible in-app setting / / command to toggle mouse capture, and surface CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN / CLAUDE_CODE_DISABLE_MOUSE more prominently (e.g. first-run hint when running in a known terminal).

Environment

• OS: Linux (Ubuntu, kernel 6.8)
• Terminal: GNOME Terminal
• Both scroll and right-click work in the terminal until Claude Code starts.