快捷键（OpenCode 1.x）

配置位置与示例核验：2026-10-15，依据官方快捷键文档↗。V2 设置见 V2 迁移指南。

自定义你的快捷键。

将自定义快捷键放在全局 ~/.config/opencode/tui.json(c) 或项目的 tui.json(c) 中。它们会与内置默认值合并，无需复制整个快捷键表。旧 opencode.json(c) 的迁移边界见 TUI 配置。

# 自定义配置示例#

json
1{
2  "$schema": "https://opencode.ai/tui.json",
3  "keybinds": {
4    "leader": "ctrl+x",
5    "command_list": "ctrl+p",
6    "session_new": "<leader>n"
7  }
8}

# Leader 键#

OpenCode 使用 leader 键来触发大多数快捷键。这避免了终端中的冲突。

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

你不需要为快捷键使用 leader 键，但我们建议这样做。

# 禁用快捷键#

你可以通过在配置中添加值为 "none" 的键来禁用快捷键。

json
1{
2  "$schema": "https://opencode.ai/tui.json",
3  "keybinds": {
4    "session_compact": "none"
5  }
6}

# 桌面提示快捷键#

OpenCode 桌面应用的提示输入支持常见的 Readline/Emacs 风格的文本编辑快捷键。这些是内置的，不属于本页 V1 tui.json(c) 的终端快捷键设置。

快捷键	操作
`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：

%LOCALAPPDATA%\Packages\Microsoft.WindowsTerminal_8wekyb3d8bbwe\LocalState\settings.json

将下面对象中的动作条目合并到现有 settings.json 的根级 actions 数组，保留已有条目：

json
1{
2  "actions": [
3    {
4      "command": {
5        "action": "sendInput",
6        "input": "\u001b[13;2u"
7      },
8      "id": "User.sendInput.ShiftEnterCustom"
9    }
10  ]
11}

同样将下面的快捷键条目合并到根级 keybindings 数组；不要用示例覆盖整个设置文件：

json
1{
2  "keybindings": [
3    {
4      "keys": "shift+enter",
5      "id": "User.sendInput.ShiftEnterCustom"
6    }
7  ]
8}

保存文件并重启 Windows Terminal 或打开新标签页。