settings.json

tui

型string記述場所どの設定ファイルでも可

TUI のレンダリングモードです。ちらつきのない仮想スクロールバック対応の alt スクリーンレンダラーには "fullscreen"、従来のメインスクリーンレンダラーには "default" を使用します。/tui コマンドに対応します。

既定値: 未設定の場合、Claude Code がレンダラーを選択します。

取りうる値

fullscreen仮想スクロールバック対応の、ちらつきのない alt スクリーンレンダラーです。
default従来のメインスクリーンレンダラーです。

記述例

{
  "tui": "fullscreen"
}

使い方・用途

  • ターミナル UI のレンダラーを「フルスクリーン(alt スクリーン)」と「従来型(メインスクリーン)」から選ぶ設定で、/tui fullscreen や /tui default の実行時に自動的に書き込まれる
  • デフォルトは未設定で、Claude Code がレンダラーを自動選択。フルスクリーンはちらつきがなく仮想スクロールバックを持つが、リサーチプレビュー扱い
  • スクリーンリーダーモードでは一部のバックグラウンドセッションを除き常に従来型レンダラーが使われ、tui 設定は無効
  • CLAUDE_CODE_NO_FLICKER 環境変数や CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN=1 でも制御でき、/tui での切り替え時にはモデル選択やツール制約、巻き戻した会話状態が引き継がれるよう修正されている
英語原文(公式ドキュメントより)

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.295(1件)

Fixed
Claude Code を再起動できなかった際に /tui がメッセージなし、または生のシステムエラーとともに終了する問題を修正
英語原文を表示
Fixed /tui exiting without a message, or with a raw system error, when Claude Code could not be started again

関連ドキュメント

v2.1.293(1件)

Fixed
--chrome で開始したセッションにおいて、/tui が Chrome 内の Claude を切断する問題や、--no-chrome が無視される問題を修正した
英語原文を表示
Fixed /tui disconnecting Claude in Chrome in a session started with --chrome, and ignoring --no-chrome

関連ドキュメント

v2.1.288(1件)

Fixed
Claude Code が自己再起動した後(初回サインインの Claude アプリゲートウェイ経由時、プロバイダ設定時、/tui 実行時)に Windows でキーボードが効かなくなる問題を修正した
英語原文を表示
Fixed the keyboard not working on Windows after Claude Code restarts itself (first sign-in to a Claude apps gateway, provider setup, /tui)

v2.1.273(1件)

Fixed
エージェントチームのチームメイトが作業を終えてエージェントパネルに表示されなくなっているために /tui の再起動が拒否される問題を修正する
英語原文を表示
Fixed /tui refusing to restart because of an agent-team teammate that had already finished its work and was no longer shown in the agents panel

関連ドキュメント

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

関連ドキュメント

v2.1.232(1件)

Fixed
再起動後も存続する処理の実行中に、/update と /tui が再起動を拒否する問題を修正しました。
英語原文を表示
Fixed /update and /tui refusing to restart while work that survives the relaunch was running

関連ドキュメント

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

変更後

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

関連ドキュメント

v2.1.227(1件)

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

変更後

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

関連ドキュメント

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

変更後

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

関連ドキュメント

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

変更後

表示モードの変更による不慮のデータ消失や作業の中断を防ぎ、安心して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)

変更後

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

関連ドキュメント

v2.1.116(1件)

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

変更後

作業ディレクトリの切り替えを伴う柔軟な開発ワークフローの中でも、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

変更後

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

関連ドキュメント

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

変更後

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

関連ドキュメント