このページは英語版ドキュメントの翻訳です。コマンド、識別子、例はそのままです。ランタイム 7.24.4 · SDK 2.6.7。 英語版

ターミナル描画

ステータス: 現行 対象範囲: TUI のターミナルプロファイル選択、上書き、視覚能力の境界 最終確認: 2026-10-03 所有者: AX Code TUI のメンテナー

AX Code は起動時に、環境からターミナルプロファイルを選びます。プロファイルが制御するのはターミナルのセットアップであり、モニター解像度やフォントの鋭さではありません。

明示的な TERM_PROGRAM は、継承された外側ターミナルの印より優先されます。dumb、linux、vt100 のような限られたターミナル種別も互換のままです。Ubuntu または WSL の同一性だけでは、高度プロファイルは有効になりません。

高度プロファイルは代替画面、ネイティブ描画スレッド、ターミナル能力の検出を使います。互換プロファイルは、ネイティブ描画スレッドなしで主画面を使います。どちらもマウス操作（マウス捕捉 を参照）とキーボードプロトコルの交渉を有効にし、60 FPS を目標にします。実際のフレームレートは作業負荷とターミナルに依存します。

Windows Terminal は、直接セッションが識別されると、どちらのプロファイルでも 24 ビットの視覚効果を保ちます。色のサポートは、ピクセルグラフィックスや Nerd Font のサポートを意味しません。高度モードはフォント、フォントサイズ、表示倍率を変えません。

マウス捕捉

AX Code は既定でターミナルのマウス入力を捕捉し、TUI 内のコントロールをクリックできるようにします。フッターのショートカットチップ（高速モデル、自律、サンドボックス）、ダイアログと自動補完の選択肢、クリックによるフォーカス、ドラッグ選択、TUI 内のホイールスクロールです。捕捉がオンのあいだ、ターミナルはマウスを実行中のプログラムへ渡すため、ターミナル自身の右クリックメニューとネイティブのテキスト選択は表示されません。多くのターミナルは、修飾キーでそれらを引き続き出します。通常は Shift と右クリック、ときには Option または Alt で、ターミナルと、そのあいだに tmux、screen、Zellij があるかによります。

マウスをターミナルへ戻すには、mouse を false に設定します。場所は tui.json です。

{
  "mouse": false
}

AX_CODE_DISABLE_MOUSE=1 は、tui.json にかかわらず捕捉を無効にします。存在する理由は、プロジェクト単位の tui.json ファイルが信頼されない入力だからです。リポジトリが、利用者の意思に反してターミナル自身のマウス挙動を抑止し続けられるようにしてはなりません。この変数は捕捉を無効にするだけで、強制的にオンにすることは決してありません。

オプトアウトはトレードオフであり、純粋な得ではありません。

• 戻るもの: ターミナルのネイティブな右クリックメニュー、ネイティブなテキスト選択、コピーと貼り付け。互換プロファイルでは、ターミナル自身のスクロールバックがホイールを扱います。
• 失うもの: フッターのショートカットチップ、クリックによるフォーカス、クリックできるダイアログと自動補完の選択肢、ドラッグ選択、そして高度（代替画面）プロファイルではターミナルのスクロールバックがないため、TUI 内のホイールスクロール。それらの操作にはキーボード制御が引き続き使えます。

捕捉がオンのあいだ、右クリックはターミナルのものではなく TUI 自身のコンテキストメニューを開きます。クリック位置にある小さなコピー / 貼り付けメニューです。コピーは画面上に選択があるときに有効で、貼り付けはテキスト入力にフォーカスがあるとき、プロンプトとダイアログ内の入力を含めて有効です。メニューは Escape、任意のキー、スクロール、または外側のクリックで閉じます。捕捉がオフになると、クリックはターミナルが扱います。

プロファイルを上書きする

高度モードを求めるには AX_CODE_TUI_ADVANCED_TERMINAL=1 を、互換モードを求めるには 0 を設定します。明示的な上書きは、リモートや多重化されたセッションを含め、自動検出より優先されます。変数を取り除くと自動選択に戻ります。true/false、yes/no、on/off も受け付けられます。

PowerShell では、現在のシェルとその子プロセスに対して次のようにします。

$env:AX_CODE_TUI_ADVANCED_TERMINAL = "1"
ax-code

# Use compatible mode if startup or rendering has problems.
$env:AX_CODE_TUI_ADVANCED_TERMINAL = "0"
ax-code

# Restore automatic selection.
Remove-Item Env:AX_CODE_TUI_ADVANCED_TERMINAL -ErrorAction SilentlyContinue

Bash または Zsh では、1 回の起動に対して次のようにします。

AX_CODE_TUI_ADVANCED_TERMINAL=1 ax-code
AX_CODE_TUI_ADVANCED_TERMINAL=0 ax-code

シェルの起動ファイルがその変数をエクスポートしている場合は、そのエクスポートを取り除き、unset AX_CODE_TUI_ADVANCED_TERMINAL を実行して自動選択を復元します。

ピクセルアニメーション

開始と終了のアニメーションがピクセルを使うのは、レンダラーが Kitty グラフィックス、有効なピクセル寸法、ローカル TTY、代替画面、マルチプレクサなしを確認したときだけです。能力が欠ける、またはグラフィックスが失敗すると、テキストのフォールバックを使います。自動の高度モードは、これらの検査を迂回しません。

すべてのピクセルアニメーションのフレーム（Digital Code、Foliage、ランドマークの場面）は 1920x1080 に制限されます。これらのアニメーションフレームは、レンダラーの 60 FPS 目標とは別に、20 FPS のスケジュールで更新されます。プレビューは TUI の開始と終了のアニメーション を参照してください。

確認された Sixel サポートがあり（Kitty グラフィックスはない）Windows Terminal のセッションは、テキストフォールバックの代わりに、640x360 と 256 KiB に制限された静的な Sixel スプラッシュフレームを 1 枚表示します。AX_CODE_SIXEL_SPLASH=0 はそれを無効にします。=1 は、任意の Sixel ターミナルにそれを表示させます（試験経路）。解体時は、Sixel に画像 ID の削除がないため、スプラッシュ領域をオーバーレイの背景で塗り直します。

Windows Terminal のフォント

AX Code はターミナルのフォントを変更できません。ファイル種別のアイコン（Nerd Font の私用領域グリフ）が Windows Terminal で描画されるのは、パッチ済みフォントがインストールされているときだけです。推奨フォントは Cascadia Code NF です。インストールし、設定 > プロファイル > 外観 > フォントフェイスでプロファイルのフォントに設定してください。アプリ内の 1 回限りのヒントが、Windows Terminal の利用者をこのセットアップへ導きます。アイコンがすでに描画されるとき、または AX_CODE_NERD_FONT=0 がオプトアウトするときは、決して表示されません。