Claude CodeのTUI活用術｜fullscreenモードとテーマ設定

「tui claude code」で検索する人が知りたいこと

TUI(Terminal User Interface)とは、GUI のようにマウスとウィンドウで操作するのではなく、ターミナル(端末エミュレータ)の文字描画だけで構成されたインターフェースのことだ。Claude Code はまさにこの TUI アプリケーションで、claude コマンドを打つと入力欄・スピナー・差分表示・メニューがすべてターミナル内に描画される。

「tui claude code」という検索には、主に次の 3 つの意図が混ざっている。

1. Claude Code 本体の TUI 表示(ちらつき・スクロール・見た目)を改善したい
2. /tui コマンドや fullscreen モードの使い方を知りたい
3. Claude Code を監視・拡張する周辺 TUI ツールを探したい

本記事はこの 3 つを順に扱う。

/tui コマンドと fullscreen モード — v2.1.110 で追加

Claude Code の CHANGELOG によると、v2.1.110 で /tui コマンドと tui 設定が追加された。セッション中に /tui fullscreen と打つだけで、会話内容を保ったままちらつきのないレンダリングへ切り替わる。

従来の標準モードは、ターミナルの通常のスクロールバック(過去出力の履歴)に会話を追記していく方式だった。これに対し fullscreen モードは、ターミナルがフルスクリーンアプリ用に確保している「別画面(alternate screen)」に描画する。vim や less が起動時に画面を切り替えるのと同じ仕組みだ。

公式の terminal-config ドキュメントでは、fullscreen モードの利点として次の点が挙げられている。

• 描画のちらつきとスクロール位置のジャンプが解消される
• スクロールバックに追記しないためメモリ使用量が一定に保たれる
• マウスによるスクロール・テキスト選択に対応する
• 選択したテキストの自動コピーが使える

注意点として、fullscreen モードではターミナル本来のスクロールバックではなく、Claude Code 内のスクロール(マウスホイールや PageUp)で履歴をたどることになる。

fullscreen を既定にする設定と戻し方

セッションごとに /tui fullscreen を打つのが面倒なら、環境変数で既定にできる。手順は次のとおり。

1. Bash / Zsh なら CLAUDE_CODE_NO_FLICKER=1 claude で起動する
2. 常用するなら ~/.claude/settings.json の env に "CLAUDE_CODE_NO_FLICKER": "1" を追加する
3. 逆に alternate screen を使わず従来のスクロールバック方式に固定したい場合は CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN=1 を設定する

補助設定も用意されている。fullscreen 中の自動スクロールを止めたいときは autoScrollEnabled 設定(v2.1.110 追加)、マウスホイールの加速が合わないときは wheelScrollAccelerationEnabled 設定、クリック操作を無効にしてホイールだけ残したいときは CLAUDE_CODE_DISABLE_MOUSE_CLICKS が使える(いずれも CHANGELOG 記載)。

なお /tui での切り替えは CLI の再起動を伴うため、バックグラウンドのシェルや並行タスクが動いている間は実行を拒否し、完了を待つよう促す挙動になっている。

TUI の見た目を変える — /theme とカスタムテーマ

Claude Code の配色は /theme コマンド(または /config 内のテーマピッカー)で変更できる。auto を選ぶとターミナルのライト / ダーク背景を検出し、OS の外観変更に追従する。

v2.1.118 以降はカスタムテーマも定義できる。手順は次のとおり。

1. /theme の一覧末尾にある「New custom theme…」を選ぶか、~/.claude/themes/ に JSON ファイルを置く
2. base に出発点となるプリセット(dark / light など 6 種)を指定する
3. overrides に色トークン(ブランドアクセントの claude、error、success、差分表示の diffAdded など)を上書き指定する

たとえば {"name": "Dracula", "base": "dark", "overrides": {"claude": "#bd93f9"}} のようなファイルを置くだけでよい。Claude Code は ~/.claude/themes/ を監視しており、ファイルを編集すると再起動なしで実行中のセッションに反映される。未知のトークンや不正な色値は無視されるため、タイプミスで描画が壊れる心配もない。

画面下部の表示は statusline(ステータスライン)として別途カスタマイズでき、現在のモデル・作業ディレクトリ・git ブランチなどを常時表示できる。

ターミナル側を整える — /terminal-setup・tmux・通知

TUI の快適さは Claude Code 側の設定だけでなく、ターミナル側が正しいシグナルを送れるかにも左右される。公式ドキュメントの要点は次のとおり。

1. Shift+Enter で改行できない: VS Code・Cursor・Alacritty・Zed では /terminal-setup を一度実行するとキーバインドが書き込まれる。Ghostty・iTerm2・Windows Terminal などは設定不要。どの環境でも Ctrl+J は使える。
2. tmux 内で使う: ~/.tmux.conf に set -g allow-passthrough on と extended-keys の 2 行を追加しないと、通知が外側のターミナルへ届かず Shift+Enter も効かない。
3. 完了通知が欲しい: デスクトップ通知が標準で届くのは Ghostty・Kitty・iTerm2。それ以外は preferredNotifChannel を "terminal_bell" にするか、Notification hook で任意のサウンドを鳴らす。
4. Vim 派: /config の Editor mode を vim にすると、プロンプト入力欄で hjkl 移動や d/c/y オペレータが使える。

ちらつき問題の改善履歴 — 環境別の修正

「Claude Code の TUI がちらつく」という報告は環境依存のものが多く、CHANGELOG を見ると継続的に修正されてきたことがわかる。

つまり「ちらつくから使いにくい」と感じたら、まず Claude Code 本体を最新版へ更新し、それでも残る場合に /tui fullscreen へ切り替えるのが正攻法だ。

Claude Code を拡張する周辺 TUI ツール

「tui claude code」の検索結果には、本体の機能だけでなくコミュニティ製の TUI ツールも並ぶ。代表的なものを 2 つ挙げる。

• claude-tui(slima4): Claude Code のセッション内にリアルタイムのステータスライン(コンテキスト使用量・コスト・使用量バー・スパークライン)とライブモニタ、セッション分析を追加するツール。
• tui(SCKelemen): 「Claude Code のような CLI 体験」を自作アプリで構築するための TUI フレームワーク。Claude Code の UI 設計がターミナルアプリの参照実装として扱われている例だ。

いずれも Anthropic 公式ではないコミュニティプロジェクトのため、導入時は README とコードを確認してから使いたい。

まとめ — TUI 設定の優先順位

Claude Code の TUI を快適にする手順を優先順に整理する。

1. 本体を最新版に更新する(環境別のちらつき修正が続いているため)
2. ちらつき・スクロール飛びが残るなら /tui fullscreen に切り替える
3. 常用するなら CLAUDE_CODE_NO_FLICKER=1 を settings.json に入れる
4. /terminal-setup と tmux 設定でキー入力・通知を整える
5. /theme のカスタムテーマと statusline で見た目を仕上げる

TUI は「ターミナルで動くから簡素」ではなく、マウス対応・テーマ・通知まで作り込まれた Claude Code の主戦場だ。手元の環境に合わせて調整すれば、エディタに劣らない作業環境になる。

出典: Claude Code 公式ドキュメント(ターミナル設定) / Claude Code CHANGELOG