> ## Documentation Index
> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# フルスクリーンレンダリング

> マウスサポートと安定したメモリ使用量を備えた、より滑らかでちらつきのないレンダリングモードを有効にします。

<Note>
  フルスクリーンレンダリングはオプトイン形式の[リサーチプレビュー](#research-preview)であり、Claude Code v2.1.89 以降が必要です。現在の会話で `/tui fullscreen` を実行して切り替えるか、v2.1.110 より前のバージョンで `CLAUDE_CODE_NO_FLICKER=1` を設定してください。フィードバックに基づいて動作が変わる可能性があります。
</Note>

フルスクリーンレンダリングは Claude Code CLI の代替レンダリングパスで、ちらつきを排除し、長い会話でもメモリ使用量を一定に保ち、マウスサポートを追加します。`vim` や `htop` のようにターミナルの代替スクリーンバッファにインターフェースを描画し、現在表示されているメッセージのみをレンダリングします。これにより、各更新時にターミナルに送信されるデータ量が削減されます。

この違いは、VS Code 統合ターミナル、tmux、iTerm2 など、レンダリングスループットがボトルネックになるターミナルエミュレータで最も顕著です。Claude が作業中にターミナルのスクロール位置が上部にジャンプしたり、ツール出力がストリーミングされるときに画面がフラッシュしたりする場合、このモードがそれに対応します。

<Note>
  フルスクリーンという用語は、`vim` のようにターミナルの描画サーフェスを Claude Code が占有する方法を説明しています。ターミナルウィンドウを最大化することとは関係なく、任意のウィンドウサイズで動作します。
</Note>

<h2 id="enable-fullscreen-rendering">
  フルスクリーンレンダリングを有効にする
</h2>

Claude Code の会話内で `/tui fullscreen` を実行してください。CLI は [`tui` 設定](/ja/settings#available-settings)を保存し、会話をそのままにしてフルスクリーンで再起動するため、コンテキストを失わずにセッション中に切り替えることができます。`/tui default` を実行してクラシックレンダラーに戻すか、引数なしで `/tui` を実行してどのレンダラーがアクティブかを確認してください。

Claude Code を起動する前に `CLAUDE_CODE_NO_FLICKER` 環境変数を設定することもできます。

```bash theme={null}
CLAUDE_CODE_NO_FLICKER=1 claude
```

`tui` 設定と環境変数は同等です。`/tui` コマンドは再起動されたプロセスから `CLAUDE_CODE_NO_FLICKER` をクリアして、書き込まれた設定が有効になるようにします。

<h2 id="what-changes">
  変更内容
</h2>

フルスクリーンレンダリングは CLI がターミナルに描画する方法を変更します。入力ボックスは出力がストリーミングされるときに移動するのではなく、画面の下部に固定されたままになります。Claude が作業中に入力が固定されたままの場合、フルスクリーンレンダリングがアクティブです。レンダーツリーに保持されるのは表示されているメッセージのみなので、会話の長さに関係なくメモリは一定に保たれます。

会話がターミナルのスクロールバックではなく代替スクリーンバッファに存在するため、いくつかの点で動作が異なります。

| 以前                               | 現在                                                     | 詳細                                                    |
| :------------------------------- | :----------------------------------------------------- | :---------------------------------------------------- |
| `Cmd+f` または tmux 検索でテキストを検索      | `Ctrl+o` でトランスクリプトモードに入り、`/` で検索するか `[` でスクロールバックに書き込む | [会話を検索およびレビューする](#search-and-review-the-conversation) |
| ターミナルのネイティブなクリックアンドドラッグで選択およびコピー | アプリ内選択、マウスリリース時に自動的にコピー                                | [マウスを使用する](#use-the-mouse)                            |
| `Cmd` クリックで URL を開く              | macOS では `Cmd` クリック、その他では `Ctrl` クリック                  | [マウスを使用する](#use-the-mouse)                            |

マウスキャプチャがワークフローに干渉する場合、ちらつきのないレンダリングを保持しながら[オフにする](#keep-native-text-selection)ことができます。

<h2 id="use-the-mouse">
  マウスを使用する
</h2>

フルスクリーンレンダリングはマウスイベントをキャプチャし、Claude Code 内で処理します。

* **プロンプト入力をクリック**して、入力しているテキスト内の任意の場所にカーソルを配置します。
* **`/` コマンドまたは `@` ファイルリストの候補をクリック**して受け入れます。ホバーするとカーソルの下の行がハイライトされます。
* **選択メニューのオプションをクリック**して選択します。これは権限プロンプト、`/model`、`/config`、およびオプションのリストを表示するその他のダイアログをカバーしています。ホバーするとカーソルの下の行にポインターが表示されます。{/* min-version: 2.1.187 */}Claude Code v2.1.187 以降が必要です。
* **折りたたまれたツール結果をクリック**して展開し、完全な出力を表示します。もう一度クリックして折りたたみます。ツール呼び出しとその結果は一緒に展開されます。表示するものがあるメッセージのみがクリック可能です。
* **macOS では `Cmd` を押しながら、Linux と Windows では `Ctrl` を押しながら、URL またはファイルパスをクリック**して開きます。Edit または Write の後に出力されたものなど、ツール出力内のファイルパスはデフォルトアプリケーションで開きます。プレーン `http://` および `https://` URL はブラウザで開きます。v2.1.181 以降では、`Cmd` または `Ctrl` を押さずにクリックするだけではリンクが開かなくなり、ネイティブターミナルの動作に合わせています。VS Code 統合ターミナルおよび同様の xterm.js ベースのターミナルでは、Claude Code はターミナル独自のリンクハンドラに従い、同じジェスチャーを使用します。
* **クリックしてドラッグ**して、会話内の任意の場所のテキストを選択します。ダブルクリックで単語を選択し、iTerm2 の単語境界に一致するため、ファイルパスは 1 つのユニットとして選択されます。トリプルクリックで行を選択します。
* **マウスホイールでスクロール**して会話を移動します。

選択されたテキストはマウスリリース時にクリップボードに自動的にコピーされます。これをオフにするには、`/config` で Copy on select をトグルします。

Copy on select がオフの場合、`Ctrl+Shift+c` を押して手動でコピーします。kitty、WezTerm、Ghostty、iTerm2 など kitty キーボードプロトコルをサポートするターミナルでは、`Cmd+c` も機能します。選択がアクティブな場合、`Ctrl+c` はキャンセルではなくコピーします。

選択がアクティブな場合、`Shift` を押しながら矢印キーを押して、キーボードから選択を拡張します。`Shift+↑` と `Shift+↓` は、選択が上部または下部のエッジに達したときにビューポートをスクロールします。`Shift+Home` と `Shift+End` は、現在の行の開始または終了まで拡張します。

<h2 id="scroll-the-conversation">
  会話をスクロールする
</h2>

フルスクリーンレンダリングはアプリ内でスクロールを処理します。これらのショートカットを使用してナビゲートしてください。

| ショートカット         | アクション                         |
| :-------------- | :---------------------------- |
| `PgUp` / `PgDn` | 画面の半分だけ上下にスクロール               |
| `Ctrl+Home`     | 会話の開始にジャンプ                    |
| `Ctrl+End`      | 最新のメッセージにジャンプして自動フォローを再度有効にする |
| マウスホイール         | 数行ずつスクロール                     |

MacBook キーボードのように `PgUp`、`PgDn`、`Home`、`End` キーが専用にない場合、`Fn` を矢印キーで押し続けます。`Fn+↑` は `PgUp` を送信し、`Fn+↓` は `PgDn` を送信し、`Fn+←` は `Home` を送信し、`Fn+→` は `End` を送信します。これにより `Ctrl+Fn+→` が下部へのジャンプショートカットになります。これが不便に感じられる場合は、マウスホイールで下部にスクロールしてフォローを再開するか、`scroll:bottom` を到達可能な何かに再バインドしてください。

これらのアクションは再バインド可能です。[スクロールアクション](/ja/keybindings#scroll-actions)を参照して、半ページおよび全ページバリアントを含むアクション名の完全なリストを確認してください。これらにはデフォルトバインディングがありません。

<h3 id="auto-follow">
  自動フォロー
</h3>

上にスクロールすると自動フォローが一時停止され、新しい出力があなたを下部に戻しません。`Ctrl+End` を押すか、下部にスクロールしてフォローを再開します。

自動フォローを完全にオフにして、ビューが置いた場所に留まるようにするには、`/config` を開き、Auto-scroll をオフに設定します。自動スクロールが無効な場合、ビューは独自に下部にジャンプすることはありません。権限プロンプトおよび応答が必要なその他のダイアログは、この設定に関係なく、ビューにスクロールします。

<h3 id="mouse-wheel-scrolling">
  マウスホイールスクロール
</h3>

マウスホイールスクロールには、ターミナルが Claude Code にマウスイベントを転送する必要があります。ほとんどのターミナルはアプリケーションがそれを要求するときにこれを行います。iTerm2 はそれをプロファイルごとの設定にします。ホイールが何もしませんが `PgUp` と `PgDn` が機能する場合は、\[設定] → \[プロファイル] → \[ターミナル] を開き、\[マウスレポートを有効にする] をオンにします。同じ設定は、クリックして展開とテキスト選択が機能するためにも必要です。

マウスホイールスクロールが遅く感じられる場合、ターミナルは乗数なしで物理的なノッチごとに 1 つのスクロールイベントを送信している可能性があります。Ghostty や高速スクロールが有効な iTerm2 など、一部のターミナルはすでにホイールイベントを増幅しています。VS Code 統合ターミナルを含む他のターミナルは、ノッチごとに正確に 1 つのイベントを送信します。Claude Code は検出できません。

`CLAUDE_CODE_SCROLL_SPEED` を設定してベーススクロール距離を乗算します。

```bash theme={null}
export CLAUDE_CODE_SCROLL_SPEED=3
```

値 `3` は `vim` および同様のアプリケーションのデフォルトと一致します。この設定は 1 から 20 の値を受け入れ、トラックパッドとホイールスクロールを遅くするために 1 未満の小数値（`0.5` など）を受け入れます。これらは既にホイールイベントを増幅するターミナルで使用されます。

スクロール速度を対話的に調整するには、`/scroll-speed` を実行します。ダイアログには、開いている間にスクロールできるルーラーが表示されるため、変更をすぐに感じることができます。`←` と `→` を押して調整し、`r` を押して自動検出されたデフォルトにリセットし、`Enter` を押して保存します。このコマンドは `CLAUDE_CODE_SCROLL_SPEED` 環境変数が設定する同じ値を書き込み、`~/.claude/settings.json` に永続化されます。このコマンドは JetBrains IDE ターミナルでは利用できません。

ベース速度とは別に、Claude Code はホイールを素早く回転させるときにスクロール速度を加速するため、高速回転は同じ数の遅い回転よりも多くの距離をカバーします。加速をオフにして、ノッチごとに一定の速度を保つには、[`settings.json`](/ja/settings#available-settings)で `wheelScrollAccelerationEnabled` を `false` に設定します。この設定には Claude Code v2.1.174 以降が必要です。

<h3 id="scroll-in-the-jetbrains-ide-terminal">
  JetBrains IDE ターミナルでのスクロール
</h3>

JetBrains IDE ターミナルでは、Claude Code は独自のスクロール処理を適用し、`CLAUDE_CODE_SCROLL_SPEED` を無視します。ターミナルは他のエミュレータよりもはるかに高いレートでスクロールイベントを送信するため、他の場所で調整された乗数はここでオーバーシュートします。

2025.2 では、ターミナルにはスクロールホイールのバグもあり、偽のアローキーと間違った方向のイベントが発生します。Claude Code はこれを実行時に検出し、自動的に軽減するため、トラックパッドとマウスホイールスクロールは設定なしで機能します。最適なスクロール体験を得るには、2025.3 以降にアップグレードしてください。Claude Code は、バグを検出した場合、初回スクロール時にヒントを表示します。

<h2 id="search-and-review-the-conversation">
  会話を検索およびレビューする
</h2>

`Ctrl+o` を押してノーマルプロンプトとトランスクリプトモードを切り替えます。最後のプロンプト、編集 diffstats を含むツール呼び出しの 1 行の概要、および最終応答のみを表示する、より静かなビューの場合は、`/focus` を実行してください。この設定はセッション全体で保持されます。オフにするには、`/focus` をもう一度実行してください。

トランスクリプトモードは `less` スタイルのナビゲーションと検索を取得します。

| キー                                    | アクション                                                        |
| :------------------------------------ | :----------------------------------------------------------- |
| `/`                                   | 検索を開きます。入力して一致を検索し、`Enter` で受け入れ、`Esc` でキャンセルしてスクロール位置を復元します |
| `n` / `N`                             | 次または前の一致にジャンプします。検索バーを閉じた後に機能します                             |
| `j` / `k` または `↑` / `↓`               | 1 行スクロール                                                     |
| `g` / `G` または `Home` / `End`          | 上部または下部にジャンプ                                                 |
| `Ctrl+u` / `Ctrl+d`                   | ページの半分をスクロール                                                 |
| `Ctrl+b` / `Ctrl+f` または `Space` / `b` | ページ全体をスクロール                                                  |
| `Ctrl+o`、`Esc`、または `q`                | トランスクリプトモードを終了してプロンプトに戻る                                     |

ターミナルの `Cmd+f` と tmux 検索は、会話がネイティブスクロールバックではなく代替スクリーンバッファに存在するため、会話を見ることができません。コンテンツをターミナルに戻すには、`Ctrl+o` を押してトランスクリプトモードに最初に入ってから、以下を実行します。

* **`[`**: すべてのツール出力が展開された完全な会話をターミナルのネイティブスクロールバッファに書き込みます。会話はターミナル内の通常のテキストになるため、`Cmd+f`、tmux コピーモード、その他のネイティブツールで検索または選択できます。長いセッションはこれが発生している間、一瞬一時停止する可能性があります。これは `Esc` または `q` でトランスクリプトモードを終了するまで続き、フルスクリーンレンダリングに戻ります。次の `Ctrl+o` は新たに開始します。
* **`v`**: 会話を一時ファイルに書き込み、`$VISUAL` または `$EDITOR` で開きます。

`Esc` または `q` を押してプロンプトに戻ります。

<h2 id="clear-the-conversation">
  会話をクリアする
</h2>

2 秒以内に `Ctrl+L` を 2 回押して `/clear` を実行し、新しい会話を開始します。最初のプレスは画面を再描画してヒントを表示します。2 番目のプレスは会話をクリアします。macOS では、`Cmd+K` をダブルプレスしても `/clear` が実行されます。

<h2 id="use-with-tmux">
  tmux で使用する
</h2>

フルスクリーンレンダリングは tmux 内で機能しますが、3 つの注意点があります。

マウスホイールスクロールには tmux のマウスモードが必要です。`~/.tmux.conf` がまだ有効にしていない場合は、この行を追加して設定をリロードしてください。

```bash theme={null}
set -g mouse on
```

マウスモードがない場合、ホイールイベントは Claude Code ではなく tmux に送信されます。`PgUp` と `PgDn` を使用したキーボードスクロールはどちらの方法でも機能します。Claude Code は起動時に tmux がマウスモードオフで検出された場合、1 回限りのヒントを出力します。

フルスクリーンレンダリングは iTerm2 の tmux 統合モード（`tmux -CC` で入るモード）と互換性がありません。統合モードでは、iTerm2 は各 tmux ペインをネイティブスプリットとしてレンダリングし、tmux がターミナルに描画することを許可しません。代替スクリーンバッファとマウストラッキングはそこで正しく機能しません。マウスホイールは何もしませんし、ダブルクリックはターミナル状態を破損する可能性があります。`tmux -CC` セッションでフルスクリーンレンダリングを有効にしないでください。`-CC` なしの iTerm2 内の通常の tmux は正常に機能します。

tmux は同期出力をサポートしていないため、Claude Code を直接ターミナルで実行する場合よりも、再描画中により多くのちらつきが見える可能性があります。特に SSH 経由でちらつきが目立つ場合は、Claude Code を tmux の外の独自のターミナルタブで実行してください。

<h2 id="keep-native-text-selection">
  ネイティブテキスト選択を保持する
</h2>

マウスキャプチャは最も一般的な摩擦点です。特に SSH 経由または tmux 内です。Claude Code がマウスイベントをキャプチャすると、ターミナルのネイティブなコピーオンセレクトが機能しなくなります。クリックアンドドラッグで行う選択は Claude Code 内に存在し、ターミナルの選択バッファには存在しないため、tmux コピーモード、Kitty ヒント、および同様のツールはそれを見ることができません。

Claude Code は選択をシステムクリップボードに書き込みます。使用するパスはセットアップに依存します。ローカルセッションではネイティブクリップボードツールを実行します。

* **macOS**: `pbcopy`
* **Linux**: Wayland では `wl-copy`、X11 では `xclip` または `xsel`（インストールされているもの）。Claude Code はクリップボードと PRIMARY 選択の両方に書き込むため、中クリックペーストが機能します。
* **Windows と WSL**: PowerShell `Set-Clipboard`

tmux 内では tmux ペーストバッファにも書き込みます。SSH 経由では OSC 52 エスケープシーケンスにフォールバックします。Claude Code は各コピー後にトーストを表示し、使用したパスを通知します。

一部のターミナルはデフォルトで OSC 52 をブロックします。iTerm2 は Settings → General → Selection → Applications in terminal may access clipboard をオンにするまでブロックします。iTerm2 で [`/terminal-setup`](/ja/terminal-config) を実行すると、これが有効になります。

一度限りのネイティブ選択の場合、使用するキーはターミナルに依存します。

* **Terminal.app**: `Fn`
* **iTerm2**: `Option`
* **VS Code、Cursor、Devin Desktop**: `Shift`、または macOS で `terminal.integrated.macOptionClickForcesSelection` 設定が有効な場合は `Option`
* **その他のほとんどのターミナル**: `Shift`

そのキーを押しながらクリックアンドドラッグします。ターミナルが選択を自分で処理し、Claude Code に渡さないため、`Cmd+C` などのコピーショートカットが選択に対して機能します。Claude Code は画面上のヒントに正しいキーも表示します。

SSH 経由または tmux 内では、Claude Code が接続元のターミナルを常に検出できるとは限らないため、ヒントは候補キーのリストを表示します。

ネイティブ選択に常に依存する場合、`CLAUDE_CODE_DISABLE_MOUSE=1` を設定してマウスキャプチャをオプトアウトしながら、ちらつきのないレンダリングとフラットメモリを保持します。

```bash theme={null}
CLAUDE_CODE_NO_FLICKER=1 CLAUDE_CODE_DISABLE_MOUSE=1 claude
```

マウスキャプチャが無効な場合、`PgUp`、`PgDn`、`Ctrl+Home`、`Ctrl+End` を使用したキーボードスクロールは引き続き機能し、ターミナルはネイティブに選択を処理します。クリックしてカーソルを配置、クリックしてツール出力を展開、URL クリック、Claude Code 内でのホイールスクロールが失われます。

ホイールスクロールを保持しながらクリック、ドラッグ、ホバー処理をオフにするには、代わりに `CLAUDE_CODE_DISABLE_MOUSE_CLICKS=1` を設定します。Claude Code v2.1.195 以降が必要です。両方の変数が設定されている場合、`CLAUDE_CODE_DISABLE_MOUSE` が優先されます。

クリックが無効な場合、Claude Code はまだマウスをキャプチャするため、ホイールとタッチパッドは会話をスクロールしますが、左クリックは Claude Code 内では何もしません。ネイティブなクリックアンドドラッグ選択のためにターミナルのキーを押し続ける必要があります。右クリックと中クリックペーストは、それをサポートするターミナルで引き続き機能します。

<h2 id="research-preview">
  リサーチプレビュー
</h2>

フルスクリーンレンダリングはリサーチプレビュー機能です。一般的なターミナルエミュレータでテストされていますが、あまり一般的でないターミナルまたは異常な設定でレンダリングの問題が発生する可能性があります。

問題が発生した場合は、Claude Code 内で `/feedback` を実行して報告するか、[claude-code GitHub リポジトリ](https://github.com/anthropics/claude-code/issues)で issue を開いてください。ターミナルエミュレータの名前とバージョンを含めてください。

フルスクリーンレンダリングをオフにするには、`/tui default` を実行するか、その方法で有効にした場合は `CLAUDE_CODE_NO_FLICKER` をアンセットしてください。保存された `tui` 設定に関係なくクラシックレンダラーを強制するには、`CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN=1` を設定してください。クラシックレンダラーはターミナルのネイティブスクロールバックに会話を保持するため、`Cmd+f` と tmux コピーモードは通常通り機能します。

[agent view](/ja/agent-view) または `claude attach` から開かれたバックグラウンドセッションは常にフルスクリーンレンダリングを使用します。アタッチするターミナルは代替スクリーンバッファに入ってセッションを表示し、クラシックレンダラーはそこではスクロールバックまたはマウスハンドリングがないため、`tui` 設定と `CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN` はそれらに適用されません。
