CLAUDE_CODE_DISABLE_MOUSE_CLICKS

Updated October 13, 2026 by Alex Sorokoletov

CLAUDE_CODE_DISABLE_MOUSE_CLICKS is a Claude Code environment variable: Granular mouse click disable, added in v2.1.88. Superseded by the broader CLAUDE_CODE_DISABLE_MOUSE flag. The two-tier mouse control approach lasted one version — the simpler on/off toggle won. 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_CLICKS=<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_CLICKS": "<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: Disables all mouse input handling in the terminal UI.
• 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.