Skip to content
← Back to release · 2.1.271
New features / v2.1.271

Mouse support in /config panel

CHANGELOG · original

Added mouse support to the /config panel in fullscreen mode: the wheel scrolls the settings list, a click on a setting's value changes it, and the row under the pointer is highlighted
Open official changelog ↗

Documentation

Documentation excerpt

Use the mouse

Fullscreen rendering captures mouse events and handles them inside Claude Code:

  • Click in the prompt input to position your cursor anywhere in the text you're typing.
  • Click a suggestion in the / command or @ file list to accept it. Hovering highlights the row under your cursor.
  • Click an option in a select menu to choose it. This covers permission prompts, /model, /config, and other dialogs that show a list of options. Hovering shows a pointer on the row under your cursor. Requires Claude Code v2.1.187 or later.
  • Click an option in a multi-select menu to toggle it, and click the submit button to confirm your choices. Clicking a free-text row, such as the Other row in a multiple-choice question, focuses its input field so you can type an answer. Requires Claude Code v2.1.208 or later.
  • Click a setting's value in the /config panel to change it, and scroll the settings list with the mouse wheel. Requires Claude Code v2.1.271 or later.
  • Click a collapsed tool result to expand it and see the full output. Click again to collapse. The tool call and its result expand together. Only messages that have more to show are clickable.
    • Clicking also expands the output of a ! shell command, whether an older truncated result or the live progress row while the command runs. Requires Claude Code v2.1.257 or later.
  • Hold Cmd on macOS, or Ctrl on Linux and Windows, and click a URL or file path to open it. Plain http:// and https:// URLs open in your browser, and file paths in tool output, like the ones printed after an Edit or Write, open in your default application. A plain click without the modifier doesn't open links, matching native terminal behavior.
    • Claude Code renders a network (UNC) path, such as \\server\share\file.ts, as plain text with no link, because opening a network path can send your Windows credentials to the host it names.
    • Some macOS terminals forward Cmd+click to the running app instead of opening the link themselves, and the terminal mouse protocol has no way to encode the Cmd key, so Claude Code receives a plain click. In Ghostty, and in Warp on macOS, Claude Code detects this and lets a plain click on a link open it, and holding Cmd still works.
    • In the VS Code integrated terminal and similar xterm.js-based terminals, Claude Code defers to the terminal's own link handler, which uses the same gesture.
  • Click and drag to select text anywhere in the conversation. Double-click selects a word, matching iTerm2's word boundaries so a file path selects as one unit. Double-clicking a URL selects the whole URL, including the scheme. Triple-click selects the line.
  • Scroll with the mouse wheel to move through the conversation.

Selected text copies to your clipboard automatically on mouse release. To turn this off, toggle Copy on select in /config.

With Copy on select off, press Ctrl+Shift+c to copy manually. On terminals that support the kitty keyboard protocol, such as kitty, WezTerm, Ghostty, and iTerm2, Cmd+c also works. If you have a selection active, Ctrl+c copies instead of cancelling.

With a selection active, hold Shift and press the arrow keys to extend it from the keyboard. Shift+↑ and Shift+↓ scroll the viewport when the selection reaches the top or bottom edge. Shift+Home and Shift+End extend to the start or end of the current line.

In the normal prompt view, what happens to an active selection depends on the key you press:

  • Esc: Claude Code performs the key's usual action, such as interrupting the running response or dismissing an open dialog, and the selection stays highlighted.
  • PgUp, PgDn, Ctrl+Home, Ctrl+End, or Shift, Alt or Option, or Cmd, Win, or Super with an arrow, Home, or End key: the selection stays.
  • Any other key, including plain arrow keys, Enter, and typed characters: Claude Code clears the selection.
  • A key bound to selection:clear: Claude Code clears the selection, even when the key is Esc or another key that otherwise keeps it. The action has no default binding.

In transcript mode, the navigation and search keys listed there also keep the selection.

Documentation snapshot · 2026-09-23

Change details