CLAUDE_CODE_DISABLE_VIRTUAL_SCROLL

Updated October 13, 2026 by Alex Sorokoletov

CLAUDE_CODE_DISABLE_VIRTUAL_SCROLL is a Claude Code environment variable: Disable virtual scrolling in terminal UI. Useful if virtual scroll causes rendering issues in certain terminal emulators or when piping output. Added between v2.1.70 and v2.1.72 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_VIRTUAL_SCROLL=<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_VIRTUAL_SCROLL": "<value>"
  }
}

Release notes that mention it

• Claude Code v2.1.72 — 6 New Environment Variables: Brief Mode, Cron Control & Two-Stage Classifier

Related variables

• CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN: Prevents the TUI from using the terminal alternate screen buffer.
• CLAUDE_CODE_DISABLE_MOUSE: Disables all mouse input handling in the terminal UI.
• CLAUDE_CODE_DISABLE_MOUSE_CLICKS: Granular mouse click disable, added in v2.1.88.
• CLAUDE_CODE_DISABLE_TERMINAL_TITLE: Stop Claude Code from setting the terminal title.
• CLAUDE_CODE_SCROLL_SPEED: Controls the scroll speed within the terminal UI.
• CLAUDE_CODE_SCROLL_SPEEDI
• CLAUDE_CODE_SCROLL_SPEEDI30
• CLAUDE_RUNNER_DISABLE_AWAITING_ACTION_OVERRIDE

Frequently asked questions

All variables, searchable: Claude Code environment variables.