CLAUDE_CODE_DISABLE_MOUSE

Updated October 13, 2026 by Alex Sorokoletov

CLAUDE_CODE_DISABLE_MOUSE is a Claude Code environment variable: Disables all mouse input handling in the terminal UI. Claude Code captures mouse events for interactive elements like clickable buttons and text selection, but this can interfere with the terminal emulator's native mouse behavior — copy-paste via mouse selection, right-click context menus, and scroll-to-history. Added between v2.1.87 and v2.1.88 and still present in v2.1.294. It is listed in the official reference.

How to set it

For one session, export it in the shell that starts Claude Code:

export CLAUDE_CODE_DISABLE_MOUSE=<value>
claude

To apply it to every session, add it to the env object of a settings file:

// ~/.claude/settings.json
{
  "env": {
    "CLAUDE_CODE_DISABLE_MOUSE": "<value>"
  }
}

Release notes that mention it

• Claude Code v2.1.89 — 4 New Environment Variables: Agent Cost Steering, Session Resume Controls, and 50% StructuredOutput Fix
• Claude Code v2.1.88 — 7 New Environment Variables: Mouse Control, REPL Mode, and Flicker-Free Rendering
• Claude Code Version Tracker: Undocumented Env Vars, Feature Gates & Models

Related variables

• CLAUDE_CODE_DISABLE_MOUSE_CLICKS: Granular mouse click disable, added in v2.1.88.
• CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN: Prevents the TUI from using the terminal alternate screen buffer.
• CLAUDE_CODE_DISABLE_TERMINAL_TITLE: Stop Claude Code from setting the terminal title.
• CLAUDE_CODE_DISABLE_VIRTUAL_SCROLL: Disable virtual scrolling in terminal UI.
• CLAUDE_RUNNER_DISABLE_AWAITING_ACTION_OVERRIDE
• CLAUDE_AX_PREPARK_MS
• CLAUDE_AX_SCREEN_READER
• CLAUDE_AX_STARTUP_QUIET_MS: Startup quiet window (milliseconds) for screen-reader mode.

Frequently asked questions

All variables, searchable: Claude Code environment variables.