OpenCode 快捷键完全指南：从 ctrl+t 切换变体到全套键位

OpenCode 的 TUI（终端用户界面）提供了丰富的快捷键体系，但官方文档的键位列表像一本未加注释的乐谱——看得见音符，不知道节奏。本文把 50+ 个快捷键按使用场景分类梳理，让你像弹钢琴一样自然地操作 OpenCode。

用熟这套键位之后，你会发现 ctrl+t 切换变体、ctrl+x 前缀键组合、f2 切换模型，这几个是最常用的「高频三件套」。

一、tui.json 放在哪？默认有没有？ 链接到标题

这是第一个要搞清楚的问题。

tui.json 默认不存在，需要手动创建。 OpenCode 不会在安装时自动生成任何配置文件，所有配置都是可选的。你需要自己在正确的位置新建它。

配置文件有两个路径可选：

键位配置可以直接写在 opencode.json 的 keybinds 字段中，不需要单独的 tui.json：

1
2
3
4
5
6
7
8

{
  "$schema": "https://opencode.ai/config.json",
  "keybinds": {
    "variant_cycle": "ctrl+t",
    "model_cycle_recent": "f2",
    "agent_cycle": "tab"
  }
}

官方文档中展示的 tui.json 实际上是一种命名惯例——你可以用 tui.json 单独存放键位配置，然后通过 opencode.json 引用，但绝大多数场景下直接在 opencode.json 中写 keybinds 字段更方便。

如果你执意要用独立的 tui.json，把它放在和 opencode.json 相同的目录下（~/.config/opencode/ 或项目根目录）。

二、前置知识：Leader 前导键 链接到标题

OpenCode 大量使用前导键（Leader） 模式，和 Vim/Tmux 的设计理念一致：先按前导键，再按功能键，避免和终端其他快捷键冲突。

默认前导键：ctrl+x

也就是说，文档中 "session_new": "<leader>n" 的意思就是：先按 ctrl+x，松手，再按 n。

你可以把 leader 改成别的键，比如 ctrl+space 或 ctrl+a：

1
2
3
4
5

{
  "keybinds": {
    "leader": "ctrl+space"
  }
}

三、快捷键分类速查 链接到标题

3.1 会话管理（最常用） 链接到标题

3.2 模型与变体切换（高频） 链接到标题

variant_cycle（ctrl+t）是深度思考模型的开关。

Claude Sonnet 支持 extended thinking，按 ctrl+t 在「普通模式」和「深度思考模式」之间切换——不用重新选择模型，一键搞定。

DeepSeek V4 Pro 支持思考强度控制，按 ctrl+t 在以下等级间循环：low → medium → high → max。注意 DeepSeek 的 API 实现中，low 和 medium 实际都会被映射为 high（参见 DeepSeek 思考模式文档），所以表现上有差异的只有 high 和 max 两档。由于 OpenCode 属于复杂 Agent 类请求，DeepSeek API 在思考模式下会自动将 effort 设为 max（即默认使用最强推理等级），你也可以手动按 ctrl+t 降到 high 来节省 token 提升速度。

3.3 代理（Agent）切换 链接到标题

3.4 消息导航（会话内滚动） 链接到标题

OpenCode 的消息区支持 U 列（UP/DOWN）导航，键位设计灵感来自终端翻页习惯：

特别说明 ctrl+x u（undo）和 ctrl+x r（redo）：这两个操作不仅撤销/重做消息，还会还原文件更改。内部使用 Git 来管理文件变更，所以你的项目必须是 Git 仓库才能正常使用 undo/redo。

3.5 输入框编辑（Emacs/Readline 风格） 链接到标题

OpenCode 的输入框支持一整套文本编辑快捷键，熟悉终端的人会很顺手：

光标移动 链接到标题

删除操作 链接到标题

选择与粘贴 链接到标题

注意：某些终端（如 Windows Terminal）默认不发送带修饰键的 Enter。如果你发现 shift+enter 换行无效，需要配置终端发送转义序列，详见官方文档。

历史记录 链接到标题

3.6 界面控制 链接到标题

3.7 输入框选择（Shift 组合键） 链接到标题

按住 shift 配合光标移动键可以选中文本：

四、如何自定义快捷键 链接到标题

在 opencode.json 的 keybinds 字段中覆盖任意键位。以禁用某个快捷键为例，设为 "none"：

1
2
3
4
5
6
7
8

{
  "$schema": "https://opencode.ai/config.json",
  "keybinds": {
    "session_compact": "none",
    "variant_cycle": "ctrl+shift+t",
    "model_cycle_recent": "alt+right"
  }
}

多个按键可以绑定同一个功能（逗号分隔）：

1
2
3
4
5

{
  "keybinds": {
    "input_submit": "return,ctrl+enter"
  }
}

五、实用建议 链接到标题

1. 核心三键优先记熟：ctrl+t（切换变体）+ f2（切换模型）+ tab（切换代理），这三者日常最高频
2. Leader 键不要乱改：ctrl+x 和大多数终端程序不冲突，保持默认即可
3. Undo 需要 Git：ctrl+x u / ctrl+x r 依赖 Git 管理文件变更，项目中必须有 .git 目录
4. 滚动用 pageup/pagedown：比 ctrl+alt 组合键更顺手，且所有终端都支持
5. Emacs 快捷键在输入框完全可用：ctrl+a/e/w/k/u 都可以直接用，终端老手的肌肉记忆完全不用改

参考 链接到标题

• OpenCode 快捷键官方文档
• OpenCode 配置文档
• OpenCode GitHub