settings.json

tui

TUIレンダリングモードを設定します(仮想スクロールバックの fullscreen または従来の default)。

使い方・用途

  • 長い会話での画面のチラつき(フリッカー)を抑え、メモリ使用量を一定に保ちたい場合に fullscreen を選択します。
  • フルスクリーンモードではマウス操作や選択時の自動コピーに対応しており、vim のような快適な操作感を提供します。
英語原文(公式ドキュメントより)

TUI rendering mode. Use "fullscreen" for the flicker-free alt-screen renderer with virtualized scrollback; "default" for the classic main-screen renderer. Corresponds to the /tui command. See https://code.claude.com/docs/en/settings#available-settings

関連ドキュメント

関連する変更履歴

v2.1.234(1件)

Fixed
/tui コマンドで再起動した際、起動時に指定していたツールの明示的な許可・不許可ルール(--allowed-tools/--disallowed-tools)が破棄されてしまう問題を修正しました。今後は、再起動時に引き継げない制約がセッションに含まれている場合、移行を行わずにその理由を通知します。
英語原文を表示
Fixed /tui dropping launch --allowed-tools/--disallowed-tools rules when it restarts; it now declines to switch, with the reason, when the session has restrictions a restart can't carry over

変更前

/tui コマンドでフルスクリーンモードへ切り替えた際に、ユーザーが引数制限したツール利用の禁止ポリシーがクリアされ、予期せず広範なツールの使用許可がモデルに付与されてしまうセキュリティの抜け道がありました。

変更後

切り替え時もツール制約パラメータが正確に維持され、万が一プロセスの再起動プロセスで制約情報を安全に持ち越せないと判断された場合は、切り替えを安全に拒否して理由を説明するメッセージが表示されます。

ユーザーへの恩恵

フルスクリーンモードへの切り替えコマンドを実行した際に、自分が課したツールの使用制限ルールが外れていないかをわざわざ再設定して確認する手間がなくなります。

関連ドキュメント

v2.1.232(1件)

Fixed
/update コマンドによるアップデートや、/tui でのフルスクリーン表示切替の際、バックグラウンドで実行中のタスクがあることを理由にセッションの再起動を拒否する問題を修正しました
英語原文を表示
Fixed /update and /tui refusing to restart while work that survives the relaunch was running

変更前

バックグラウンドで安全に隔離・永続化されたタスクが実行中であるにもかかわらず、インストーラーが「実行中のプロセスがある」と誤判定し、アプリの更新や表示モードの切り替えをブロックしていました。

変更後

プロセス再起動をまたいで生存可能な(survives relaunch)バックグラウンドワークのプロセスIDを正確に除外分類し、それらが稼働したままでもスムーズにアプリを再起動・更新します。

ユーザーへの恩恵

長時間稼働するテストスイートなどの実行中に、Claude Code自体のアップデートや、ターミナル表示のフルスクリーン・通常モード間の切り替えを躊躇なく行えるようになります。

v2.1.228(1件)

Fixed
前回の応答以降に/modelでモデルを変更していた場合、/tuiを実行すると以前のモデルにセッションが戻ってしまう問題を修正しました。
英語原文を表示
Fixed /tui reverting the session to an earlier model when /model had been changed since the last response

変更前

会話中に/modelコマンドを使用して対話モデルを切り替えた後、/tuiを実行してフルスクリーンレンダリングモードに移行すると、モデルの選択状態が維持されず切り替え前の古いモデルに戻っていました。

変更後

/tuiコマンドによるレンダリングモード切り替え時のプロセス再起動において、ユーザーが最新のターンで選択していたモデル情報が正しく引き継がれます。

ユーザーへの恩恵

フルスクリーンモードの有効化・無効化を切り替えても、選択したモデルが維持されるため、モデルを再設定し直す必要がなくなります。

関連ドキュメント

v2.1.227(1件)

Fixed
会話を最初のメッセージよりも前の状態まで巻き戻した後に /tui コマンドを実行すると、巻き戻されたはずの会話が復活してしまう不具合を修正しました。
英語原文を表示
Fixed /tui bringing back a conversation that had been rewound to before its first message

変更前

メッセージを最初の発言より前まで巻き戻した後にフルスクリーンレンダラー(/tui)に切り替えると、削除されたはずの会話履歴が画面上に再度表示されてしまい一貫性が失われていました。

変更後

巻き戻された履歴状態が /tui の切り替え時にも正しく同期され、完全にリセットされた状態から画面が開始されます。

ユーザーへの恩恵

会話を巻き戻した後に画面をフルスクリーン表示へ切り替えても、不要な古い文脈を引き継がずに新しいセッションを開始できます。

関連ドキュメント

v2.1.187(1件)

Fixed
エージェントビューの切り替えや /bg/tui 等の実行後にチャンネル接続が切断される問題を修正
英語原文を表示
Fixed channel connections dropping after navigating to the agents view and back, and after /bg, /tui, or /update

変更前

エージェントビューへの移動や表示モードの切り替え、/update などの操作を行うたびに、通知用のチャンネル接続が途切れてしまうことがありました。

変更後

セッションの状態変更やモードの移行後も、Telegram や Discord 等との連携接続が安定して維持されるようになりました。

ユーザーへの恩恵

バックグラウンドでの作業中も、外部メッセージングツールへの通知を確実に受け取り続けることができます。

関連ドキュメント

v2.1.141(1件)

Fixed
バックグラウンド作業中に/tuiコマンドを実行した際、実行中のプロセスがサイレントに終了されるのを防ぐように改善。
英語原文を表示
Fixed /tui silently dropping running background shells and subagents — now refuses and asks to wait for them to finish

変更前

フルスクリーンモードへの切り替え( /tui fullscreen )を行う際、背後で動いているシェルやサブエージェントが警告なしに強制終了されてしまうリスクがありました。

変更後

実行中のタスクがある場合は切り替えを拒否し、作業の完了を待つようユーザーに促すメッセージが表示されます。

ユーザーへの恩恵

表示モードの変更による不慮のデータ消失や作業の中断を防ぎ、安心してUI設定を変更できます。

関連ドキュメント

v2.1.132(1件)

Updated
/tui fullscreenの起動バナーを更新し、レンダリングモードの利点(メモリ使用量の削減、マウスサポート、選択時の自動コピーなど)を詳しく説明するように変更
英語原文を表示
Updated the /tui fullscreen startup banner to describe additional renderer benefits (lower memory usage, mouse support, auto-copy on select)

変更前

フルスクリーンモード(/tui fullscreen)の起動時に表示される説明が簡素で、通常のレンダリングモードと比較してどのような技術的メリットがあるのかがユーザーに十分に伝わっていませんでした。

変更後

起動時のバナーに、低いメモリ消費、マウス操作への対応、テキスト選択時の自動クリップボードコピーといった、フルスクリーンモード特有の具体的な利点が表示されるようになります。

ユーザーへの恩恵

新しいレンダリングモードが自分の作業環境においてどのように役立つのかを即座に理解でき、最適なモードを選択しやすくなります。

関連ドキュメント

v2.1.116(1件)

Fixed
セッションの途中で worktree に入った後、/update/tui が機能しなくなる問題を修正
英語原文を表示
Fixed /update and /tui not working after entering a worktree mid-session

変更前

セッション実行中に git worktree を作成して移動すると、その後のアップデート操作や UI モードの変更(/tui)が正常に動作しなくなる不当な挙動がありました。

変更後

worktree への移動後も、カレントディレクトリやセッション状態が正しく維持され、すべてのコマンドが継続して利用できるよう修正されました。

ユーザーへの恩恵

作業ディレクトリの切り替えを伴う柔軟な開発ワークフローの中でも、Claude Code のすべての機能を一貫して利用し続けることができます。

関連ドキュメント

v2.1.110(2件)

Added
/tuiコマンドとtui設定の追加 — 同一の会話内で/tui fullscreenを実行することで、チラつきのないレンダリングモードに切り替え可能に
英語原文を表示
Added /tui command and tui setting — run /tui fullscreen to switch to flicker-free rendering in the same conversation

変更前

長い会話になると画面がチラついたり、VS Codeの統合ターミナルなどでスクロール位置が勝手にジャンプしたりすることがありました。また、メモリ使用量も会話の長さに応じて増加する傾向がありました。

変更後

/tui fullscreenを実行すると、vimのように端末の代替画面バッファを使用して描画を行うモードに切り替わります。現在見えているメッセージのみをレンダリングするためチラつきが抑えられ、メモリ使用量も一定に保たれます。

ユーザーへの恩恵

長時間にわたる複雑な開発作業でも、画面の乱れや動作の重さを気にせず、マウスサポートも含めた快適な操作感でAIとの対話を継続できるようになります。

関連ドキュメント

Fixed
CLIの再起動後(/tuiへの切り替えやプロバイダ設定時など)に、キー入力がこぼれる問題を修正
英語原文を表示
Fixed dropped keystrokes after the CLI relaunches (e.g. /tui, provider setup wizards)

変更前

内部的なCLIの再起動が発生した直後、最初に入力した数文字が無視されてしまい、コマンドを打ち直す必要がありました。

変更後

再起動後の入力受け付けが即座に、かつ正確に行われるように改善されました。

ユーザーへの恩恵

モードの切り替えや設定変更の際、操作を遮られることなくスムーズに入力を続けられるようになります。

関連ドキュメント