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.
  • 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.
  • 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.
  • Scroll a select or multi-select menu with the mouse wheel when it has more options than it shows at once, such as the /model list in a short terminal window. The wheel scrolls the list while the pointer is over its options. Requires Claude Code v2.1.280 or later.
  • Scroll an overflowing list with its scrollbar. In list panels such as /skills, /mcp, and /plugin's Installed list, a scrollbar appears beside a list with more rows than fit while the pointer is over it. Click the track to jump to that point, or drag the thumb. Requires Claude Code v2.1.281 or later.
    • Where the bar has ↑ and ↓ arrows at its ends, click an arrow to scroll a single row, or hold it to keep scrolling. The arrows require Claude Code v2.1.286 or later.
  • Click the ↑ N more or ↓ N more row at the edge of a list to jump to that end of the list without choosing an option. Requires Claude Code v2.1.286 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.
    • Clicking also expands a dim Message from @<sender> line when the sender is a teammate or another agent running in your session.
  • 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. When Claude Code handles the click, file paths in tool output, like the ones printed after an Edit or Write, open in your file manager with the file selected. A plain click without the modifier doesn't open links, matching native terminal behavior.
    • On Linux and WSL, clicking a file path needs a file manager that provides the org.freedesktop.FileManager1 D-Bus interface. Without one, nothing opens.
    • 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 keys listed there also keep the selection.

Documentation snapshot · 2026-11-20

Change details