Skip to content
OpenCode
首页文档

快捷键绑定

自定义您的快捷键绑定。

OpenCode 提供了一系列可自定义的键盘快捷键，您可以通过 OpenCode 配置文件进行调整。

opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "keybinds": {
    "leader": "ctrl+x",
    "app_exit": "ctrl+c,ctrl+d,<leader>q",
    "editor_open": "<leader>e",
    "theme_list": "<leader>t",
    "sidebar_toggle": "<leader>b",
    "username_toggle": "none",
    "status_view": "<leader>s",
    "session_export": "<leader>x",
    "session_new": "<leader>n",
    "session_list": "<leader>l",
    "session_timeline": "<leader>g",
    "session_share": "none",
    "session_unshare": "none",
    "session_interrupt": "escape",
    "session_compact": "<leader>c",
    "session_child_cycle": "<leader>right",
    "session_child_cycle_reverse": "<leader>left",
    "session_parent": "<leader>up",
    "messages_page_up": "pageup",
    "messages_page_down": "pagedown",
    "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_copy": "<leader>y",
    "messages_undo": "<leader>u",
    "messages_redo": "<leader>r",
    "messages_last_user": "none",
    "messages_toggle_conceal": "<leader>h",
    "model_list": "<leader>m",
    "model_cycle_recent": "f2",
    "model_cycle_recent_reverse": "shift+f2",
    "variant_cycle": "ctrl+t",
    "command_list": "ctrl+p",
    "agent_list": "<leader>a",
    "agent_cycle": "tab",
    "agent_cycle_reverse": "shift+tab",
    "input_clear": "ctrl+c",
    "input_paste": "ctrl+v",
    "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",
    "history_previous": "up",
    "history_next": "down",
    "terminal_suspend": "ctrl+z"
  }
}

引导键

OpenCode 使用 leader 键（引导键）作为大多数快捷键的前缀。这可以避免与您的终端快捷键发生冲突。

默认情况下，ctrl+x 是引导键，大多数操作需要您先按下引导键，然后再按快捷键。例如，要开始一个新会话，您需要先按 ctrl+x，然后按 n。

您不一定非要为您的快捷键使用引导键，但我们建议这样做。

禁用快捷键

您可以通过在配置文件中将某个键的值设置为 “none” 来禁用它。

opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "keybinds": {
    "session_compact": "none"
  }
}

桌面应用提示符快捷键

OpenCode 桌面应用的提示符输入支持常见的 Readline/Emacs 风格的文本编辑快捷键。这些是内置的，目前无法通过 opencode.json 进行配置。

快捷键动作
ctrl+a移动到当前行的开头
ctrl+e移动到当前行的末尾
ctrl+b将光标向后移动一个字符
ctrl+f将光标向前移动一个字符
alt+b将光标向后移动一个单词
alt+f将光标向前移动一个单词
ctrl+d删除光标下的字符
ctrl+k删除到行尾
ctrl+u删除到行首
ctrl+w删除前一个单词
alt+d删除下一个单词
ctrl+y粘贴最后删除的文本
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 或打开一个新标签页。