環境変数

CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN

1 に設定すると、フルスクリーンレンダリングを無効化し、クラシックなメインスクリーンレンダラーを使用する。会話はターミナルのネイティブなスクロールバックに残るため、Cmd+f や tmux コピーモードが通常どおり動作する。CLAUDE_CODE_NO_FLICKER および tui 設定より優先される。/tui default でも切り替えられる。エージェントビューから開いたバックグラウンドセッションには適用されない。それらは常にフルスクリーンレンダリングを使用する

使い方・用途

  • フルスクリーン レンダリングが普及していない端末エミュレータや特殊な構成で表示崩れを起こす場合に、この環境変数で強制的にクラシックなメインスクリーン レンダラへ切り替えられる。
  • 保存済みの tui 設定に関係なく恒久的にクラシック レンダラを使いたい場合に、この環境変数を設定しておくことでオーバーライドできる。
  • 会話履歴を端末のネイティブ スクロールバックに残して Cmd+f や tmux copy mode を通常どおり使いたい場合に、この環境変数でフルスクリーン レンダリングを無効化できる。
英語原文(公式ドキュメントより)

Set to 1 to disable fullscreen rendering and use the classic main-screen renderer. The conversation stays in your terminal's native scrollback so Cmd+f and tmux copy mode work as usual. Takes precedence over CLAUDE_CODE_NO_FLICKER and the tui setting. You can also switch with /tui default. Does not apply to background sessions opened from agent view, which always use fullscreen rendering

関連ドキュメント

関連する変更履歴

v2.1.210(1件)

Fixed
代替スクリーンを無効化している際、エージェントビューに戻ると画面表示が重なる問題を修正した。
英語原文を表示
Fixed returning to the agents view from a session leaving overlapping ghost frames with CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN=1

変更後

スクロールバック履歴を重視してフルスクリーン設定を切っているユーザーでも、快適にダッシュボードを利用できます。

v2.1.132(1件)

Added
フルスクリーンの代替画面レンダラーを無効化し、ターミナルのネイティブなスクロールバックに会話を残すための環境変数 CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN=1 を追加しました
英語原文を表示
Added CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN=1 env var to opt out of the fullscreen alternate-screen renderer and keep the conversation in the terminal's native scrollback

変更後

Claude Code を終了した後もターミナル上に作業の記録を残しておきたい場合や、ターミナルエミュレータ固有のスクロールバック検索を活用したいユーザーにとって便利です。

関連ドキュメント