快捷键 (Keybinds)

自定义您的快捷键

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

引导键 (Leader key)

OpenCode 的大多数快捷键都使用“引导键（Leader key）”。这可以避免与您的终端快捷键发生冲突。

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

虽然您可以不使用引导键来配置快捷键，但我们建议您保留此设置。

配置示例 (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",
    "status_view": "<leader>s",
    "session_export": "<leader>x",
    "session_new": "<leader>n",
    "session_list": "<leader>l",
    "session_timeline": "<leader>g",
    "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_copy": "<leader>y",
    "messages_undo": "<leader>u",
    "messages_redo": "<leader>r",
    "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_submit": "return",
    "input_newline": "shift+return,ctrl+return,alt+return,ctrl+j",
    "history_previous": "up",
    "history_next": "down",
    "tips_toggle": "<leader>h"
  }
}

禁用快捷键 (Disable keybind)

您可以通过将快捷键的值设置为 "none" 来禁用它。

{
  "keybinds": {
    "session_compact": "none"
  }
}

桌面端提示框快捷键 (Desktop prompt shortcuts)

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+t`	交换字符
`ctrl+g`	取消弹出层 / 中止运行中的响应

Shift+Enter 设置

某些终端默认不会随 Enter 键发送修饰键。您可能需要配置终端将 Shift+Enter 作为转义序列发送。

Windows Terminal 配置示例

在 settings.json 中添加以下内容：

在 actions 数组中添加：

{
  "command": {
    "action": "sendInput",
    "input": "\u001b[13;2u"
  },
  "id": "User.sendInput.ShiftEnterCustom"
}

在 keybindings 数组中添加：

{
  "keys": "shift+enter",
  "id": "User.sendInput.ShiftEnterCustom"
}

保存并重启终端即可。

Intro (入门)

Usage (使用指南)

Configure (详细配置)