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
環境変数
CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN=1かCLAUDE_CODE_NO_FLICKER=0なら通常、CLAUDE_CODE_NO_FLICKER=1ならフルスクリーンです。両方が設定されていれば通常が勝ちます。 - 2
直前の起動失敗
この端末でフルスクリーンの起動に失敗した直後は、通常で立ち上がります。
- 3
接続経路
iTerm2の
tmux -CC統合モード、またはWindows上のClaude CodeへのSSH接続は通常です。 - 4
保存済みのtui設定
settings.jsonのtuiに"fullscreen"か"default"があれば、それに従います。 - 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 fullscreensettings.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設定ガイドにあります。
参照した一次ソース
この記事の記述は、次の一次ソースと照合しています。更新時に参照先が変わった場合は一覧も更新します。