快捷键速查表 ​

打印这页贴在显示器旁边，三天就能肌肉记忆

📝 课程笔记 ​

本课核心知识点整理：

Leader 键 ​

OpenCode 使用 Leader 键 避免与终端快捷键冲突。

默认 Leader 键：Ctrl+X

使用方式：先按 Ctrl+X，松开，再按第二个键。

TUI 快捷键 ​

基础操作 ​

Leader 键操作 ​

Diff viewer ​

输入 /diff 或从命令面板打开 diff viewer；diff_open 默认未绑定按键，也可以自行配置。viewer 默认启用，支持文件树、文件/hunk 导航、单个或全部 patch、统一/分栏视图，以及工作区和最后一轮 AI 改动；当前分支不是默认分支时，还可选择主分支对比。

会话导航 ​

消息滚动 ​

输入区操作 ​

模型切换 ​

权限确认 ​

IDE 扩展快捷键 ​

VS Code / Cursor ​

Desktop 输入快捷键 ​

OpenCode 桌面应用的输入框支持 Readline/Emacs 风格快捷键，这些快捷键内置且不可通过 opencode.json 配置：

自定义快捷键 ​

在独立的 tui.json 或 tui.jsonc 中配置扁平的 keybinds 映射：

{
  "$schema": "https://opencode.ai/tui.json",
  "keybinds": {
    "leader": "ctrl+x",
    "session_new": "<leader>n",
    "session_list": "<leader>l",
    "model_list": "<leader>m"
  }
}

禁用快捷键 ​

设置为 "none" 或 false 禁用：

{
  "keybinds": {
    "session_compact": false
  }
}

多键绑定 ​

用逗号分隔多个按键：

{
  "keybinds": {
    "app_exit": "ctrl+c,ctrl+d,<leader>q"
  }
}

配置位置与迁移 ​

加载顺序为：全局配置目录、OPENCODE_TUI_CONFIG、普通项目 tui.json / tui.jsonc、沿途 .opencode、OPENCODE_CONFIG_DIR，后者优先。普通项目文件按根侧到当前目录应用，越近当前目录越优先；多个 .opencode 目录按当前侧到根侧合并，冲突时更靠根侧者后加载并取胜。OPENCODE_CONFIG_DIR 最后加载。

升级时，启动 TUI 会检查全局、项目沿途、配置目录和 OPENCODE_CONFIG 指定的旧主配置，把其中的 theme、keybinds 和 tui 字段迁到同目录的 tui.json。目标 tui.json 已存在时跳过；只有 tui.jsonc 不会阻止迁移。成功写入并创建或复用 .tui-migration.bak 后，才从原配置删除旧字段。主配置已不再读取这些字段。

光标外观 ​

cursor 与 keybinds 同级；style 支持 block、underline、line、default，blinking 控制闪烁。default 会保留终端设置并忽略 blinking。

常用可配置键绑定 ​

来源：v1.18.22 keybind.ts

新增项：后台会话、Skill、cursor

基础键绑定 ​

会话管理 ​

模型与 Agent ​

Diff viewer ​

m 是 viewer 内置的“标记已审阅”按键，不属于 keybinds 配置项。

界面控制 ​

消息操作 ​

输入框操作 ​

历史与终端 ​

Shift+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"
    }
  ]
}

快捷键速记口诀 ​

Tab 切 Agent，Ctrl+C 清
Leader 加字母，功能随便挑
n 新建 l 列表 m 模型
u 撤销 r 重做不用愁
方向键左右，子会话来回走

相关资源 ​

• v1.18.22 TUI 配置加载 - 配置位置和优先级
• v1.18.22 TUI 配置迁移 - 自动迁移与跳过条件
• v1.18.22 diff viewer - 当前导航、视图和来源能力
• 配置选项参考 - 完整配置说明
• 5.6b 快捷键 - 快捷键定制教程
• 5.6a 主题系统 - 主题定制教程