Back to rankings

Claude Code Lets You Opt Out of Fullscreen Renderer to Restore Native Terminal Scrollback

Claude Code

Claude Code 2.1.132 adds a new setting that lets users disable the alternate-screen (fullscreen) terminal renderer, restoring native terminal scrollback buffer behavior. Developers who rely on their terminal emulator's built-in scroll history — particularly those in tmux, screen, or terminals that do not buffer alternate-screen output — can now opt out of fullscreen rendering without sacrificing Claude Code functionality. The setting is designed for power users who prefer native terminal UX over the default TUI experience.

Sources & Mentions

5 external resources covering this update

Scrollback buffer lost with alternate screen renderer

GitHub

Option to disable fullscreen/alternate screen mode

GitHub

Terminal scrollback not preserved after TUI exit

GitHub

Discussion: Claude Code alternate screen scrollback fix

X (Twitter)

Claude Code terminal configuration docs

Claude Code Docs

The Problem: Alternate Screen Wipes Scrollback

Claude Code's default rendering mode uses the terminal alternate screen — a second virtual buffer that takes over the display when the TUI is active. While this enables rich fullscreen rendering, it comes with a significant trade-off: most terminal emulators do not preserve alternate-screen output in their scrollback buffer. When the TUI exits, the content disappears.

For developers who rely heavily on scrollback — reviewing a long list of tool calls, tracing back through multi-step reasoning, or copying output into another tool — this behavior is a persistent friction point. Threads tracking this issue in the Claude Code repository accumulated hundreds of reactions, making it one of the most-requested quality-of-life improvements.

The Fix: DISABLE_ALTERNATE_SCREEN Setting

Version 2.1.132 introduces an option to disable the alternate-screen renderer entirely. When the setting is active, Claude Code renders its output directly into the primary terminal buffer, which behaves like any other terminal program and preserves all output in the scrollback history.

To enable this mode, set the environment variable or configuration flag:

CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN=1

Or via the Claude Code settings file:

{
  "disableAlternateScreen": true
}

With this setting active, the terminal behaves as it would with any standard CLI program. Every line of output scrolls normally, and users can scroll back through the entire session using their terminal's native scroll mechanism.

Trade-Offs

Disabling the alternate screen means losing some TUI features that depend on controlled cursor positioning — specifically, in-place progress indicators and the spinner animations that appear while Claude is thinking. Output will be more linear and less visually polished, but fully preservable and navigable via scrollback.

This is an intentional power-user trade-off: Claude Code is exposing a configuration knob rather than changing the default for all users.

Who Benefits Most

  • Developers in tmux or GNU screen sessions, where alternate-screen output is routinely discarded
  • Users of terminal multiplexers that buffer only primary-screen output
  • Anyone who frequently needs to copy or review Claude Code output in bulk after a session
  • Teams running Claude Code in CI or logging pipelines where terminal output needs to be captured verbatim
Mentioned onGitHubGitHubGitHubX (Twitter)Claude Code Docs
Claude Code: Opt Out of Fullscreen Renderer, Restore Terminal Scrollback | Yet Another Changelog