Claude Media
Claude CodeのTUI(フルスクリーン)の切り替えと解除 — 仕組みと制約

Claude CodeのTUI(フルスクリーン)の切り替えと解除 — 仕組みと制約

Claude CodeのTUI(フルスクリーンレンダリング)の仕組み、起動時の切り替えダイアログへの答え方、/tui defaultで解除する方法、/tuiが切り替えを断る条件を扱います。

Claude CodeのTUI(フルスクリーンレンダリング)は、vimやhtopと同じくターミナルの代替スクリーンバッファに画面を描画し、表示中のメッセージだけを再描画するモードです。tmuxやVS Code統合ターミナルでのチラつきを消し、長い会話でもメモリ使用量を一定に保ちます。代わりにマウス操作と検索の勝手が変わり、環境によっては切り替えを断られることもあります。起動時にどちらのレンダラーになるかは、環境変数、直前の起動失敗、接続経路、保存済みのtui設定の順に決まります。

Claude CodeのTUIとは何か

TUIという呼び方は俗称で、ドキュメントとコマンド名(/tui)の表記は「フルスクリーンレンダリング(fullscreen rendering)」です。通常のレンダラーは出力をターミナルの標準スクロールバックへそのまま流します。フルスクリーンレンダリングは代替スクリーンバッファを使い、画面に見えている範囲だけをレンダーツリーに保持します。

くらべる

通常のレンダラーとフルスクリーンの違い

スクロールバック方式

通常(classic)

会話はターミナル本来のスクロールバックに残ります。Cmd+fやtmuxのコピーモードで検索でき、ターミナル標準のドラッグ選択がそのまま使えます。

代替スクリーン方式

フルスクリーン

入力欄が画面下に固定され、出力がストリームしても動きません。見えている範囲だけを保持するのでメモリは一定で、クリックやドラッグはClaude Codeが受け取ります。

差が出やすいのは、描画のスループットがボトルネックになるVS Code統合ターミナル・tmux・iTerm2です。作業中にスクロール位置が先頭へ飛ぶ、ツール出力のたびに画面がフラッシュする、といった症状が当てはまります。チラつきだけが目的で、Emacsのeatのように自動検出されない端末なら、環境変数で直す方法もあります。

「フルスクリーン」はウィンドウの最大化とは無関係です。vimが画面全体を描画で占有するのと同じ意味で、ウィンドウサイズを問わず動きます。

利用者の少ない端末や特殊な構成では描画が乱れる可能性があり、機能自体が研究プレビューです。不具合は/feedback、またはclaude-codeのGitHubリポジトリのissueで報告できます。その際は端末エミュレーターの名前とバージョンを添えます。

起動時のダイアログと、フルスクリーンの解除

通常のレンダラーで起動し、tui設定もまだ保存していないと、切り替えを勧めるダイアログが出ることがあります。試すなら承諾すると、/tui fullscreenと同じ再起動でフルスクリーンに入ります。見送るなら「Not now」を選びます。

フルスクリーンから出たいときは、/tui defaultを実行します。通常のレンダラーへ再起動し、設定も保存されます。環境変数で有効にしている場合は、CLAUDE_CODE_NO_FLICKERを外します。

自分はいまどちらのレンダラーで動いているか

入力欄が、Claudeの作業中も画面下から動かなければフルスクリーンです。引数なしの/tuiを実行すると、有効なレンダラーが表示されます。

起動時の選択は、次の順に当てはまるものが先に採用されます。

手順

起動時のレンダラーが決まる順番

  1. 1

    環境変数

    CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN=1かCLAUDE_CODE_NO_FLICKER=0なら通常、CLAUDE_CODE_NO_FLICKER=1ならフルスクリーンです。両方が設定されていれば通常が勝ちます。

  2. 2

    直前の起動失敗

    この端末でフルスクリーンの起動に失敗した直後は、通常で立ち上がります。

  3. 3

    接続経路

    iTerm2のtmux -CC統合モード、またはWindows上のClaude CodeへのSSH接続は通常です。

  4. 4

    保存済みのtui設定

    settings.jsonのtuiに"fullscreen"か"default"があれば、それに従います。

  5. 5

    機能フラグと初回起動日

    機能フラグを取得するセッションは、2026年5月6日以降に初めて使った場合にフルスクリーンです。取得しないセッションは、起動時のダイアログの提案が止まったマシンなら通常、マシンで最初の起動がv2.1.239以降ならフルスクリーンです。

機能フラグを取得しないセッションとは、Amazon Bedrock・Google CloudのAgent Platform・Microsoft Foundry経由のものと、テレメトリーを切っているものです。どれにも当てはまらず、5月6日より前から使っている人は、通常のままです。

ダイアログで承諾した場合、設定は再起動後のセッションが無事に起動してから保存されます。「Not now」を選ぶとそのマシンでは二度と出ず、表示が3回に達した場合も出なくなります。

Claude Codeのスクリーンリーダーモードでは、アタッチしたバックグラウンドセッションを除いて通常レンダラーが使われ、tui設定は効きません。claude --help(v2.1.287)にも、そのためのオプションが次のとおり載っています。

claude --help
  --ax-screen-reader                    Render screen-reader friendly output
                                        (flat text, no decorative borders or
                                        animations).

v2.1.287の--helpのオプション一覧には、レンダラーを直接選ぶフラグがありません。選択は/tui・tui設定・環境変数のどれかで行います。スクリーンリーダー側の設定はスクリーンリーダーモードの手順にまとめています。

切り替え方と、設定・環境変数の優先順位

会話の途中でも/tui fullscreenを実行すれば、その場で切り替わります。tui設定に保存されるので、次回以降の起動にも引き継がれます。

/tui fullscreen

settings.jsonに直接書く場合は次の形で、どの設定ファイルのスコープでも指定できます。

{
  "tui": "fullscreen"
}

環境変数でも切り替えられます。

CLAUDE_CODE_NO_FLICKER=1 claude

環境変数はそのセッションに限ってtui設定より優先されます。/tuiは再起動するプロセスからCLAUDE_CODE_NO_FLICKERを消すので、書き込んだtui設定がそのまま効きます。保存済みのtui設定を無視していつでも通常に戻したいなら、CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN=1を使います。会話はターミナル本来のスクロールバックに残るようになります。

/tui defaultで戻すとき、切り替えた理由を尋ねる任意のフィードバック欄が先に出ることがあります。Enterで送信、Escで省略できて、どちらでも通常のレンダラーへ再起動します。

再起動で引き継がれるもの、引き継げないもの

/tuiによる切り替えは、会話を保持したままセッションを再起動する処理です。

引き継がれる要素補足
画面上の会話補足/rewindで巻き戻した場合は、巻き戻し後の状態から再起動(ディスク上の完全な履歴ではない)
権限モードとeffortレベル補足そのまま維持
直近に選択したモデル補足/modelで最後に選んだもの
起動時のフラグ補足--allowed-tools/--disallowed-toolsのルールに加え、--agent・--agents・--append-system-prompt・--system-prompt-snapshot

/rewindで最初のメッセージより前まで戻していた場合、再起動後は空の会話になります。画面に表示されていない分は、ディスクに長い履歴があっても対象外です。

/tuiが切り替えを断る場合の見分け方

再起動できないセッションでは、/tuiは設定を保存せずに中止し、理由を表示します。メッセージは2種類あり、原因も対処も違います。

くらべる

断られたときの2つのメッセージ

待てば解消

Cannot switch renderers while work is running in the background

バックグラウンドのシェルやサブエージェントが動いていて、再起動すると中断されてしまう状態です。/tasksで止めるか終わるのを待ってから、もう一度/tuiを実行します。

起動し直しが必要

Cannot switch renderers in this session

再起動後のプロセスに渡せない制約があるセッションです。メッセージの括弧内に原因が出ます。制約のない新しいセッションで/tuiを実行すると、以降のセッションにも切り替えが効きます。

後者の括弧内に出る原因は、次の4系統です。

  • 起動フラグ: --system-prompt・--system-prompt-file・--append-system-prompt-file、--toolsの許可リスト、--setting-sources、--permission-prompt-tool
  • フックやSDKの権限更新が、そのセッション限定(sessionの保存先)で追加したdenyやaskのルール。セッション限定のallowルールは拒否の理由にならず、再起動で消えて再び確認が出ます
  • フックやSDKが追加したaskルールのうち、--allowed-toolsなどコマンドラインで表現できないもの
  • 権限ルールや追加ディレクトリのうち、コマンドラインが元のままの値で運べないもの

v2.1.234より前は、制約があっても再起動し、再起動後のセッションは制約なしで動いていました。CI・自動化・ラッパー経由で--toolsや--system-promptを指定して起動している場合、そのセッションで/tuiによる切り替えは想定できません。原因ごとの見分け方は「Cannot switch renderers in this session」の意味と対処法で詳しく扱っています。--toolsそのものの使い方は--toolsフラグの解説にあります。

起動時に「fullscreen renderer didn't finish starting」と出たら

フルスクリーンのセッションが、最初の描画を終えて10秒生きるか/exit・Ctrl+C・Ctrl+Dで終わる前に落ちると、次の起動は通常レンダラーになります。画面には失敗回数に応じて、次の2行のどちらかが出ます。

  • 1回目の失敗: Claude Code's fullscreen renderer didn't finish starting last time on this machine。次のセッションではフルスクリーンを再び試します
  • 2回目の失敗: Claude Code's fullscreen renderer has repeatedly failed to start on this machine。Claude Codeを更新するか/tui fullscreenを実行するまで通常のままで、以降のセッションは何も表示しません

失敗回数はバージョンごとに数え、フルスクリーンが一度成功すると戻ります。CLAUDE_CODE_NO_FLICKER=1で起動したセッションは失敗しても数えず、常にフルスクリーンで立ち上がります。通常になった理由がこの失敗かどうかは、引数なしの/tuiのCurrent renderer行に出ます。v2.1.236より前は、失敗してもフルスクリーンで起動し続けていました。

マウス操作とネイティブ選択の使い分け

フルスクリーンはマウスイベントを捕捉して、Claude Code内で処理します。入力欄のクリックによる位置指定、/や@の候補のクリック選択、権限プロンプトの選択肢のクリック、折りたたまれたツール結果のクリック展開、ドラッグによるテキスト選択がそれにあたります。URLやファイルパスは、macOSならCmd、LinuxとWindowsならCtrlを押しながらクリックすると開きます。修飾キーなしのクリックでは開きません。

ダブルクリックは単語を選び、ファイルパスは1つのまとまりとして選択されます。URLをダブルクリックするとスキームまで含めて選べ、トリプルクリックで行全体です。選択中にShiftを押しながら矢印キーを押すと、キーボードで範囲を広げられます。捕捉中にBashツールのsshがパスフレーズを求めて操作が壊れる報告は、原因と回避策にまとめています。

選択メニューもクリックで操作できます。複数選択メニューの選択肢のクリックは切り替え、送信ボタンのクリックで確定します(v2.1.208以降)。/configパネルでは設定値のクリックで変更でき、リストのホイールスクロールもできます(v2.1.271以降)。/skills・/mcpなどの長いリストには、ポインターを重ねるとスクロールバーが現れます(v2.1.281以降)。

選択したテキストは、マウスを離した瞬間にクリップボードへ自動コピーされます。ローカルのセッションでの経路は次のとおりです。

  • macOS: pbcopy
  • Linux: Waylandならwl-copy、X11ならxclipかxsel
  • WindowsとWSL: PowerShellのSet-Clipboard

tmux内ではtmuxのペーストバッファにも書き、SSH越しではOSC 52のエスケープシーケンスにフォールバックします。iTerm2はOSC 52を既定でブロックするため、/terminal-setupを実行するか、設定の「Applications in terminal may access clipboard」を有効にします。自動コピーを切りたい場合は、/configのCopy on selectをオフにします。その場合はCtrl+Shift+cで手動コピーします。

マウス捕捉がいちばん摩擦を生むのは、SSH越しやtmux内です。ターミナル本来のコピーモードやKittyのヒントが、Claude Code内の選択を見られなくなるためです。1回だけネイティブ選択を使うなら、ドラッグ中に端末ごとのキーを押し続けます。

端末押し続けるキー
Terminal.app押し続けるキーFn
iTerm2押し続けるキーOption
VS Code・Cursor・Devin Desktop押し続けるキーShift(macOSでterminal.integrated.macOptionClickForcesSelectionが有効ならOption)
そのほか多くの端末押し続けるキーShift

常にネイティブ選択を使うなら、CLAUDE_CODE_DISABLE_MOUSE=1でマウス捕捉をやめます。チラつき防止とメモリの安定は残りますが、クリックによるカーソル移動・展開・URLクリック・ホイールスクロールは使えなくなります。クリック系だけ無効にしてホイールスクロールを残すCLAUDE_CODE_DISABLE_MOUSE_CLICKS=1はv2.1.195以降で、両方設定するとCLAUDE_CODE_DISABLE_MOUSEが優先されます。GNOME Terminalでコピーできない症状はコピーできない原因と回避策にあります。

スクロールの操作とホイールが効かないとき

PgUp/PgDnで半画面ずつ、Ctrl+Homeで会話の先頭、Ctrl+Endで最新メッセージへ移動します。コンパクション後も、フルスクリーンのスクロールバックには以前のメッセージがすべて残ります。

MacBookのキーボードのようにPgUpやEndキーがない場合は、Fnと矢印キーの組み合わせで代用します。Fn+↑がPgUp、Fn+↓がPgDnです。Ctrl+EndはMacのキーボードからClaude Codeに届かないため、最下部へ戻るには「Jump to bottom」ボタンのクリックか、ホイールで最下部までスクロールします。scroll:bottomを届くキーに割り当て直す手もあります。

上へスクロールすると自動追従が止まり、新しい出力は「3 new messages」のような件数で示されます。応答の完了時にも、スクロールした位置は動きません。追従自体が不要なら、/configのAuto-scrollをオフにします。権限プロンプトのように応答が必要なダイアログは、オフでも画面内にスクロールされます。設定キーと空白が出るときの対処はautoScrollEnabledで全画面の自動スクロールを止めるにあります。

ホイールが反応しないときは、端末がマウスイベントを転送しているかを疑います。iTerm2はプロファイルごとの設定で、Settings → Profiles → Terminalの「Enable mouse reporting」が必要です。同じ設定が、クリックによる展開とテキスト選択にも要ります。

ホイールが遅いときは、CLAUDE_CODE_SCROLL_SPEEDで基準の移動量を掛け算できます。値は20までの正の数で、3がvimの既定と同じです。0.25のような小数は、すでにホイールを増幅する端末で動きを遅くするのに使います。対話的に調整するなら/scroll-speedが使えます。ダイアログの上限は10で、設定は~/.claude/settings.jsonに保存されます。JetBrainsのIDEターミナルでは独自のスクロール処理が働くため、この変数は無視されます。素早く回したときの加速そのものは、settings.jsonのwheelScrollAccelerationEnabledをfalseにして止めます(v2.1.174以降)。手順はwheelScrollAccelerationEnabledでスクロール加速を切るにあります。

検索したいとき・古い文字が残るとき

会話は代替スクリーンバッファにあるため、ターミナル本来のCmd+fやtmuxのコピーモード検索は、会話の中身を見つけられません。Ctrl+oでトランスクリプトモードに入ると、lessに近い操作が使えます。次のキーはトランスクリプトモードでの動作です。

キー動作
/動作検索を開く。Enterで確定、Escでキャンセルしてスクロール位置を戻す
n/N動作次/前のマッチへ(検索バーを閉じた後も有効)
{/}動作前/次のプロンプトへジャンプ
g/G動作先頭/最下部へジャンプ
[動作会話全体をターミナルのネイティブスクロールバックに書き出す
v動作会話を一時ファイルに書き出し$VISUAL/$EDITORで開く

[で書き出すとツール出力もすべて展開され、Cmd+fやtmuxのコピーモードがそのまま使えます。この状態はEscかqでトランスクリプトモードを抜けるまでで、次のCtrl+oはまっさらな状態から始まります。長いセッションでは、書き出しの間に一瞬止まることがあります。v2.1.89以降に報告が相次いだscrollback消失の経緯はscrollbackが消える問題の原因と対処法にあります。

直近のプロンプトとツール呼び出しの要約、最終応答だけに表示を絞る/focusは、フルスクリーンのドキュメントで案内されています。設定はセッションをまたいで残ります。VS Code拡張のFocus viewとの違いは/focusビューで応答だけに集中するで比べています。/diffはフルスクリーンだと会話の横にパネルを開き、Claudeの作業中に変更が積み上がる様子を追えます。

Windows Terminalなど一部のConPTY系ターミナルでは、前フレームの断片が画面に残ることがあります。フルスクリーンは変わったセルだけを送るため、端末が位置指定の書き込みをまとめて処理してしまうのが原因で、ウィンドウをリサイズするまで消えません。CLAUDE_CODE_ALT_SCREEN_FULL_REPAINT=1を設定すると、毎フレーム全セルを再描画します。Windowsのバックグラウンドセッションとagentビューでは、この全体再描画が自動で有効です。

表示が崩れたり部分的に空白になったりしたら、Ctrl+Lで再描画します。会話と入力中の内容は残ります。

tmuxで使うときの3つの注意点

フルスクリーンはtmux内でも動きますが、制約が3つあります。

注意点

tmux内での3つの制約

  • ホイールにはマウスモードが必要

    ~/.tmux.confにset -g mouse onがないと、ホイールイベントはtmuxに渡ります。PgUp/PgDnは、マウスモードの有無にかかわらず動きます。tmuxでマウスモードが切れていると、Claude Codeは起動時に1度だけヒントを表示します。

  • tmux -CCとは非互換

    iTerm2の統合モードはtmuxペインをネイティブ分割として描画するため、代替スクリーンとマウストラッキングが正しく働きません。ホイールが無反応になり、ダブルクリックで端末の状態が壊れることもあります。-CCなしの通常のtmuxは問題ありません。

  • 3.6系までは同期出力に非対応

    再描画時のチラつきが、直接実行より目立つことがあります。新しいtmuxへの更新か、tmux外のタブでの実行が回避策です。

まとめ

チラつきやメモリの伸びが悩みなら、/tui fullscreenで試せます。ただしClaude Code側の既定は経路ごとに分かれるため、5月6日以降の新規ユーザー向けと思い込まず、引数なしの/tuiで実際のレンダラーを見るのが確実です。ラッパーやCIで起動フラグを固定している環境では、切り替えを断られる前提で、環境変数による指定を選ぶことになります。キーボード操作の全体はClaude Codeショートカット一覧、tui設定を含む全体像はClaude Code設定ガイドにあります。

参照した一次ソース

この記事の記述は、次の一次ソースと照合しています。更新時に参照先が変わった場合は一覧も更新します。

  1. code.claude.com/docs/en/fullscreen
  2. code.claude.com/docs/en/settings
  3. code.claude.com/docs/en/settings-reference
  4. code.claude.com/docs/en/env-vars
  5. code.claude.com/docs/en/errors
  6. code.claude.com/docs/en/changelog
  7. code.claude.com/docs/en/keybindings
この記事を共有:XはてブLinkedIn