Skip to main content
設定とセキュリティ

UIとショートカット

Qoder CLIのテーマ、ステータスバー、ショートカットキー、Vimモード、音声入力

Qoder CLI のインタラクティブインターフェース(TUI)では、テーマ、ステータスバー、ショートカットキー、Vim 編集モード、音声入力などのカスタマイズ項目が提供されています。これらのインターフェースオプションを適切に構成することで、ターミナルでの使用体験をよりスムーズにし、個人の習慣に合わせることができます。 本ページでは、インターフェース関連の構成と操作について説明します。構成ファイルの階層化とマージルールについては、構成ファイルと適用順序 を参照してください。

表示言語

ローカルのインタラクティブインターフェースでは、簡体字中国語と英語を使用できます。 ui.language が未設定の場合、インターフェースは英語を使用します。システム言語に合わせるには、設定で Auto を明示的に選択してください。

設定画面で切り替える

  1. Qoder CLI で /settings を実行します。
  2. Display Language を検索して選択します。
  3. Auto、Simplified Chinese、または English を選択します。
変更は再起動せずにすぐに反映されます。現在のセッション、入力内容、表示中の処理状態は保持され、再描画されるインターフェースのテキストに新しい言語が適用されます。

構成ファイルで設定する

settings.json で ui.language を設定することもできます:
{
  "ui": {
    "language": "en"
  }
}
値動作
autoシステム言語に応じて自動的に選択します。zh で始まる言語では簡体字中国語、それ以外では英語を使用します。
zh-CN常に簡体字中国語を使用します。
en常に英語を使用します。
ui.language はインターフェースの言語だけを制御します。トップレベルの language 設定は AI の応答に使用する優先言語を制御します。この 2 つは個別に設定できます。たとえば、英語のインターフェースを使用しながら、AI に中国語での応答を指定できます。 一部のモデル説明とリリースノートは動的に読み込まれます。選択した言語のコンテンツを利用できない場合、インターフェースは英語にフォールバックします。 Auto で想定した言語が選択されない場合は、ui.language を zh-CN または en に明示的に設定してください。構成ファイルの場所と優先順位については、構成ファイルと適用順序 を参照してください。

テーマ

テーマはインターフェースのカラースキームを制御します。/theme を使用すると、インタラクティブインターフェース内で切り替えることができ、構成で指定することもできます:
{
  "ui": {
    "theme": "Tokyo Night",
    "autoThemeSwitching": true
  }
}

組み込みテーマ

Qoder CLI は複数の組み込みテーマを提供しています:AyuDark、AyuLight、AtomOneDark、Dracula、DefaultLight、DefaultDark、GitHubDark、GitHubLight、GoogleCode、Holiday、ShadesOfPurple、SolarizedDark、SolarizedLight、XCode、TokyoNight、ANSI、ANSILight。

自動切り替え

ui.autoThemeSwitching(デフォルトで有効)は、ターミナルの背景色に応じて、デフォルトのライト/ダークテーマ間を自動的に切り替えます。ターミナルの背景色のポーリング間隔は ui.terminalBackgroundPollingInterval(デフォルト 60 秒)によって制御されます。

カスタムテーマ

ui.customThemes を使用して独自のカラースキームを定義し、ui.theme でその名前を参照できます。

ステータスバー

ステータスバーは入力ボックスの下部に表示されます。組み込みのデフォルトステータスバーには、モデル · ワークスペース · +N -N(モデル名、作業ディレクトリ、コードの追加・削除行数)などの情報が表示され、ターミナルの幅が不足している場合は、優先度の低いセグメントが優先順位に従って省略されます。

カスタムステータスバーコマンド

カスタムシェルコマンドを実行して、ステータスバーのコンテンツを生成できます。このコマンドは、stdin を介してセッションデータの JSON(セッション ID、作業ディレクトリ、モデル、コンテキスト使用状況、Git ブランチ、Vim モードなどを含む)を受け取り、その標準出力(ANSI カラーを含む)が入力ボックスの下部に表示されます:
{
  "statusLine": {
    "type": "command",
    "command": "~/.qoder/statusline-command.sh",
    "padding": 0
  }
}
インタラクティブインターフェースで /statusline を実行すると、組み込みのステータスバー構成機能を利用して、シェル構成を自動的に読み取り、スクリプトを生成できます。

段落カラー

組み込みのデフォルトステータスバーでは、statusLine.colors を使用して各セグメントの色(model、branch、separator など)をカスタマイズできます。色の値は、16 進数(#ff6600 など)、ANSI 名(red、cyan など)、または自然言語の色名(ocean blue など)を指定できます。空欄の場合は、テーマのデフォルト色が使用されます。コンテキストプログレスバーはカスタムカラーを無視し、使用量に応じて自動的に色(緑/黄/赤)が変化します。

ショートカットキー

インタラクティブインターフェースで /shortcuts を実行すると、現在のショートカットキーの一覧を確認できます。よく使われるショートカットキーは以下の通りです:
ショートカットキー機能
Enter入力を送信します。
Shift+Enter / Ctrl+J改行します(送信しません)。
Ctrl+Enterモデルの応答中:現在の入力をキューに追加し、応答を中断して、キュー内のメッセージをすぐに送信します。それ以外のときは改行します。修飾キー付きの Enter を区別できるターミナルが必要です。
Ctrl+C現在の操作を中断 / 入力をクリアします。
Ctrl+D終了します。
Ctrl+A / Home行頭に移動します。
Ctrl+E / End行末に移動します。
Ctrl+左 / Alt+左左に 1 単語移動します。
Ctrl+右 / Alt+右右に 1 単語移動します。
Ctrl+Wカーソルの前の単語を削除します。
Ctrl+K行末まで削除します。
Ctrl+U行頭まで削除します。
Ctrl+P / Ctrl+N履歴を参照します(上/下)。
Ctrl+R履歴を逆順検索します。
Shift+Up / Shift+Down上 / 下にスクロールします。
Ctrl+X外部エディターを開いて入力を編集します。
Ctrl+Vクリップボードの内容を貼り付けます。
Alt+Vクリップボードの画像を貼り付けます。
Shift+Tab権限モードを切り替えます。
Ctrl+Y権限バイパスモードを切り替えます。
Ctrl+T完全なタスクリストを展開して表示します。
Ctrl+L画面をクリアします。
具体的なキー割り当ては、ターミナルやプラットフォームによって若干異なる場合があります。/shortcuts に表示されるものを基準としてください。

外部エディター

/editor を実行すると、入力を編集するための外部エディターを構成できます。構成後、Ctrl+X を押すと、現在の入力内容がそのエディターで開かれ、長いプロンプトの作成に適しています。

Vim モード

/vim を実行すると、Vim 編集モードを切り替えることができます。有効にすると、入力ボックスで一般的な Vim 操作がサポートされます:
  • 移動:h / j / k / l(左/下/上/右)。
  • 単語移動:w(次の単語)、b(前の単語)、e(単語の末尾)。
  • 行頭・行末:0(行頭)、$(行末)。
  • 編集モードへの移行:i(挿入)、a(追加)、o(新規行)。
  • 編集操作:d(削除)、c(変更)、y(コピー)、x(文字削除)。
  • 元に戻す/やり直し:u(元に戻す)、Ctrl+R(やり直し)。
ステータスバーには、現在の Vim モード(INSERT / NORMAL)が表示されます。

音声入力

/voice を実行すると音声入力を有効にでき、音声認識によって音声をテキスト入力に変換します。音声認識サービスのアドレスは、環境変数 QODER_ASR_URL で指定できます。

ターミナルへの状態通知

対話セッションは OSC 7501(Program Status Protocol)で実行状態をターミナルに通知します。このプロトコルに対応したターミナルやマルチプレクサは、タブやサイドバーなどに Qoder CLI が処理中か、操作待ちか、完了したかを表示できます。
状態意味
idle入力待ち。リクエストを中断した場合もこの状態に戻ります。
workingリクエストを処理中、または送信待ちのメッセージがあります。
blockedユーザーの操作待ち:permission(ツール呼び出しなどの確認)、question(エージェントの質問への回答)、auth(サインインが必要)。
doneこのターンが完了しました。
errorこのターンが失敗しました。エラーメッセージの 1 行目を含みます。
バックグラウンドで実行中のサブエージェントとワークフローはそれぞれ子レコードを通知し、終了時に削除されます。終了時にはすべてのレコードを削除します。通知内容は固定の説明、エラーの 1 行目、手動で設定したセッション名のみで、プロンプトやモデルの出力は含みません。 起動時にターミナルの対応を確認し、応答がなければ何も送信しません。通知するのは対話 UI のみで、-p などの非対話モードでは通知しません。環境変数 QODER_PROGRAM_STATUS=0 で通知を無効にし、1 で確認を省略して常に通知します。

その他のインターフェースオプション

ui グループには他にも多くの調整可能な項目があり、よく使われるものには以下が含まれます:
構成項目デフォルト値説明
ui.hideBannerfalse起動バナーを非表示にします。
ui.hideFooterfalseフッターを非表示にします。
ui.showLineNumberstrue会話内に行番号を表示します。
ui.loadingPhrasesoff読み込み時に表示します:tips / witty / all / off。
ui.dynamicWindowTitletrueステータスアイコンを使用してターミナルウィンドウのタイトルを動的に更新します。
ui.accessibility.screenReaderfalseスクリーンリーダーモード。プレーンテキストを出力します(再起動が必要)。
完全なインターフェース構成項目については、構成項目リファレンス を参照してください。

次のステップ