Keybinds
キーバインドをカスタマイズします。
OpenCode には、tui.json を通じてカスタマイズできるキーバインドの一覧があります。
tui.json
{
"$schema": "https://opencode.ai/tui.json",
"leader_timeout": 2000,
"keybinds": {
"leader": "ctrl+x",
"app_exit": "ctrl+c,ctrl+d,<leader>q",
"app_debug": "none",
"app_console": "none",
"app_heap_snapshot": "none",
"app_toggle_animations": "none",
"app_toggle_file_context": "none",
"app_toggle_diffwrap": "none",
"app_toggle_paste_summary": "none",
"app_toggle_session_directory_filter": "none",
"command_list": "ctrl+p",
"help_show": "none",
"docs_open": "none",
"editor_open": "<leader>e",
"theme_list": "<leader>t",
"theme_switch_mode": "none",
"theme_mode_lock": "none",
"sidebar_toggle": "<leader>b",
"scrollbar_toggle": "none",
"status_view": "<leader>s",
"session_export": "<leader>x",
"session_copy": "none",
"session_new": "<leader>n",
"session_list": "<leader>l",
"session_timeline": "<leader>g",
"session_fork": "none",
"session_rename": "ctrl+r",
"session_delete": "ctrl+d",
"session_share": "none",
"session_unshare": "none",
"session_interrupt": "escape",
"session_compact": "<leader>c",
"session_toggle_timestamps": "none",
"session_toggle_generic_tool_output": "none",
"session_child_first": "<leader>down",
"session_child_cycle": "right",
"session_child_cycle_reverse": "left",
"session_parent": "up",
"stash_delete": "ctrl+d",
"model_provider_list": "ctrl+a",
"model_favorite_toggle": "ctrl+f",
"model_list": "<leader>m",
"model_cycle_recent": "f2",
"model_cycle_recent_reverse": "shift+f2",
"model_cycle_favorite": "none",
"model_cycle_favorite_reverse": "none",
"mcp_list": "none",
"provider_connect": "none",
"console_org_switch": "none",
"agent_list": "<leader>a",
"agent_cycle": "tab",
"agent_cycle_reverse": "shift+tab",
"variant_cycle": "ctrl+t",
"variant_list": "none",
"messages_page_up": "pageup,ctrl+alt+b",
"messages_page_down": "pagedown,ctrl+alt+f",
"messages_line_up": "ctrl+alt+y",
"messages_line_down": "ctrl+alt+e",
"messages_half_page_up": "ctrl+alt+u",
"messages_half_page_down": "ctrl+alt+d",
"messages_first": "ctrl+g,home",
"messages_last": "ctrl+alt+g,end",
"messages_next": "none",
"messages_previous": "none",
"messages_last_user": "none",
"messages_copy": "<leader>y",
"messages_undo": "<leader>u",
"messages_redo": "<leader>r",
"messages_toggle_conceal": "<leader>h",
"tool_details": "none",
"display_thinking": "none",
"prompt_submit": "none",
"prompt_editor_context_clear": "none",
"prompt_skills": "none",
"prompt_stash": "none",
"prompt_stash_pop": "none",
"prompt_stash_list": "none",
"workspace_set": "none",
"input_clear": "ctrl+c",
"input_paste": {
"key": "ctrl+v",
"preventDefault": false
},
"input_submit": "return",
"input_newline": "shift+return,ctrl+return,alt+return,ctrl+j",
"input_move_left": "left,ctrl+b",
"input_move_right": "right,ctrl+f",
"input_move_up": "up",
"input_move_down": "down",
"input_select_left": "shift+left",
"input_select_right": "shift+right",
"input_select_up": "shift+up",
"input_select_down": "shift+down",
"input_line_home": "ctrl+a",
"input_line_end": "ctrl+e",
"input_select_line_home": "ctrl+shift+a",
"input_select_line_end": "ctrl+shift+e",
"input_visual_line_home": "alt+a",
"input_visual_line_end": "alt+e",
"input_select_visual_line_home": "alt+shift+a",
"input_select_visual_line_end": "alt+shift+e",
"input_buffer_home": "home",
"input_buffer_end": "end",
"input_select_buffer_home": "shift+home",
"input_select_buffer_end": "shift+end",
"input_delete_line": "ctrl+shift+d",
"input_delete_to_line_end": "ctrl+k",
"input_delete_to_line_start": "ctrl+u",
"input_backspace": "backspace,shift+backspace",
"input_delete": "ctrl+d,delete,shift+delete",
"input_undo": "ctrl+-,super+z",
"input_redo": "ctrl+.,super+shift+z",
"input_word_forward": "alt+f,alt+right,ctrl+right",
"input_word_backward": "alt+b,alt+left,ctrl+left",
"input_select_word_forward": "alt+shift+f,alt+shift+right",
"input_select_word_backward": "alt+shift+b,alt+shift+left",
"input_delete_word_forward": "alt+d,alt+delete,ctrl+delete",
"input_delete_word_backward": "ctrl+w,ctrl+backspace,alt+backspace",
"input_select_all": "super+a",
"history_previous": "up",
"history_next": "down",
"dialog.select.prev": "up,ctrl+p",
"dialog.select.next": "down,ctrl+n",
"dialog.select.page_up": "pageup",
"dialog.select.page_down": "pagedown",
"dialog.select.home": "home",
"dialog.select.end": "end",
"dialog.select.submit": "return",
"dialog.prompt.submit": "return",
"dialog.mcp.toggle": "space",
"prompt.autocomplete.prev": "up,ctrl+p",
"prompt.autocomplete.next": "down,ctrl+n",
"prompt.autocomplete.hide": "escape",
"prompt.autocomplete.select": "return",
"prompt.autocomplete.complete": "tab",
"permission.prompt.fullscreen": "ctrl+f",
"plugins.toggle": "space",
"dialog.plugins.install": "shift+i",
"terminal_suspend": "ctrl+z",
"terminal_title_toggle": "none",
"tips_toggle": "<leader>h",
"plugin_manager": "none",
"plugin_install": "none",
"which_key_toggle": "ctrl+alt+k",
"which_key_layout_toggle": "ctrl+alt+shift+k",
"which_key_pending_toggle": "ctrl+alt+shift+p",
"which_key_group_previous": "ctrl+alt+left,ctrl+alt+[",
"which_key_group_next": "ctrl+alt+right,ctrl+alt+]",
"which_key_scroll_up": "ctrl+alt+up,ctrl+alt+p",
"which_key_scroll_down": "ctrl+alt+down,ctrl+alt+n",
"which_key_page_up": "ctrl+alt+pageup",
"which_key_page_down": "ctrl+alt+pagedown",
"which_key_home": "ctrl+alt+home",
"which_key_end": "ctrl+alt+end"
}
}注記: Windows では、
input_undoとterminal_suspendのデフォルトが異なります:
input_undoは、明示的に設定されていない場合ctrl+z,ctrl+-,super+zがデフォルトになります。ctrl+zバインディングが追加されるのは、Windows のターミナルが POSIX のサスペンドをサポートしていないためです。terminal_suspendはnoneに強制されます。ネイティブの Windows ターミナルが POSIX のサスペンドをサポートしていないためです。
Leader Key
OpenCode は多くのキーバインドに leader キーを使用します。これにより、ターミナルでの競合を回避します。
デフォルトでは ctrl+x がリーダーキーであり、多くのアクションでは、まずリーダーキーを押してからショートカットを押す必要があります。例えば、新しいセッションを開始するには、まず ctrl+x を押してから n を押します。
キーバインドにリーダーキーを使う必要はありませんが、使うことをおすすめします。
一部のナビゲーションキーバインドは、デフォルトでは意図的にリーダーキーを使いません。サブエージェントのセッションでは、デフォルトは session_child_first = <leader>down、session_child_cycle = right、session_child_cycle_reverse = left、session_parent = up です。
leader_timeout は、リーダーキーの後に OpenCode が次のキーを待つ時間を制御します。デフォルトは 2000 ミリ秒です。
Binding Values
文字列には、1 つのショートカット、またはカンマ区切りの複数のショートカットを含められます。複数のショートカットには配列を使うこともできます。
高度なケースでは、key、event、preventDefault、fallthrough を持つオブジェクトを使用します。
tui.json
{
"$schema": "https://opencode.ai/tui.json",
"keybinds": {
"messages_copy": ["<leader>y", "ctrl+shift+c"],
"input_paste": {
"key": "ctrl+v",
"preventDefault": false
}
}
}Disable Keybind
tui.json にキーを追加して値を "none" または false にすることで、キーバインドを無効にできます。
tui.json
{
"$schema": "https://opencode.ai/tui.json",
"keybinds": {
"session_compact": "none"
}
}Desktop Prompt Shortcuts
OpenCode デスクトップアプリのプロンプト入力は、テキスト編集用の一般的な Readline/Emacs スタイルのショートカットをサポートしています。これらは組み込みであり、現在は opencode.json で設定できません。
| Shortcut | Action |
|---|---|
ctrl+a | 現在の行の先頭に移動 |
ctrl+e | 現在の行の末尾に移動 |
ctrl+b | カーソルを 1 文字後ろに移動 |
ctrl+f | カーソルを 1 文字前に移動 |
alt+b | カーソルを 1 単語後ろに移動 |
alt+f | カーソルを 1 単語前に移動 |
ctrl+d | カーソル位置の文字を削除 |
ctrl+k | 行末まで削除 |
ctrl+u | 行頭まで削除 |
ctrl+w | 直前の単語を削除 |
alt+d | 次の単語を削除 |
ctrl+t | 文字を入れ替え |
ctrl+g | ポップオーバーをキャンセル / 実行中のレスポンスを中止 |
Shift+Enter
一部のターミナルは、デフォルトでは Enter とともに修飾キーを送信しません。Shift+Enter をエスケープシーケンスとして送信するように、ターミナルを設定する必要がある場合があります。
Windows Terminal
次の場所にある settings.json を開きます:
%LOCALAPPDATA%\Packages\Microsoft.WindowsTerminal_8wekyb3d8bbwe\LocalState\settings.jsonこれをルートレベルの actions 配列に追加します:
"actions": [
{
"command": {
"action": "sendInput",
"input": "\u001b[13;2u"
},
"id": "User.sendInput.ShiftEnterCustom"
}
]これをルートレベルの keybindings 配列に追加します:
"keybindings": [
{
"keys": "shift+enter",
"id": "User.sendInput.ShiftEnterCustom"
}
]ファイルを保存して Windows Terminal を再起動するか、新しいタブを開きます。