OpenCode 键盘快捷键速查手册：新手入门到高效操作
📚 分类: 工具使用 ⏱️ 预计耗时: 15 分钟 🎯 难度: 入门 🔧 环境要求: 已安装并启动 OpenCode
你将学到什么
完成本教程后，你将能够：
- [ ] 快速上手 OpenCode 最常用的核心快捷键
- [ ] 像操作 Vim 编辑器一样，在对话界面中流畅导航
- [ ] 高效管理会话、选择模型和处理 AI 权限请求
- [ ] 将这份速查表作为日常使用的“小抄”
最终效果
你将不再需要频繁地使用鼠标点击，而是通过键盘组合键，实现以下操作：
- 一键开始新对话 (
Ctrl+N) - 快速切换 AI 模型 (
Ctrl+O) - 优雅地处理 AI 的“请求许可”对话框
前置准备
在开始前，请确认你已经成功启动 OpenCode 并进入其终端界面。
💡 提示: 如果你还没有安装 OpenCode，请先参考 安装指南 完成安装。
第 1 步：掌握全局与核心操作
🎯 目标：学会打开/关闭对话框、创建新会话等最常用的快捷键。
📝 操作：请在 OpenCode 界面中，尝试以下快捷键组合。
| 快捷键 | 操作 | 说明 |
|---|---|---|
Ctrl + N | 创建新会话 | 清空当前聊天记录，开始一个全新的对话。 |
Ctrl + X | 取消操作 | 当 AI 正在生成回复或执行命令时，立即中止它。 |
Ctrl + F | 打开文件选择器 | 用于快速选择项目中的文件。 |
Ctrl + L | 查看日志 | 切换到日志页面，查看运行记录。 |
Ctrl + T | 打开主题选择器 | 切换终端界面的颜色主题。 |
Ctrl + O | 打开模型选择器 | 切换当前使用的 AI 模型（如 GPT-4, Claude 等）。 |
Esc | 关闭对话框 | 在任何打开的对话框中按下，即可关闭它。 |
✅ 验证：按下 Ctrl+N，你应该会看到一个空白的对话界面，之前的聊天记录消失了。按下 Ctrl+L，你会切换到日志页面。
第 2 步：熟悉 Vim 风格的导航
🎯 目标：学会像使用 Vim 编辑器一样，在消息历史和对话框中高效上下移动。
📝 操作：OpenCode 大量采用了 Vim 风格的导航键。请尝试在对话主界面（消息区域）使用以下快捷键。
| 快捷键 | 动作 | 说明 |
|---|---|---|
j 或 ↓ | 向下移动 | 移动到下一条消息或下一个选项。 |
k 或 ↑ | 向上移动 | 移动到上一条消息或上一个选项。 |
h 或 ← | 向左/上一个（特定对话框） | 在模型选择器中切换到上一个提供商。 |
l 或 → | 向右/下一个（特定对话框） | 在模型选择器中切换到下一个提供商。 |
PgDn 或 f | 向下翻页 | 在消息历史中向下滚动一整页。 |
PgUp 或 b | 向上翻页 | 在消息历史中向上滚动一整页。 |
Ctrl + U | 向上滚动半页 | 更精细地向上滚动。 |
Ctrl + D | 向下滚动半页 | 更精细地向下滚动。 |
🤔 为什么要这样做？ Vim 是一种非常高效的文本编辑器，其核心设计理念是“手不离键盘”。OpenCode 借鉴了这一设计，让你无需将手从键盘主键区移开去够鼠标，从而大幅提升操作效率。
✅ 验证：在对话界面用 j 和 k 键上下移动，你会看到消息列表中的高亮条随之移动。
第 3 步：编辑消息与对话
🎯 目标：掌握在消息输入框中高效编辑和发送消息的技巧。
📝 操作：在输入框中尝试以下操作。
| 快捷键 | 动作 | 说明 |
|---|---|---|
i | 聚焦输入框 | 当你的焦点在消息列表时，按 i 键可以快速将光标定位到输入框。 |
Esc | 退出输入模式 | 当你在输入框时，按 Esc 键可以退出，将焦点移回消息列表。 |
Enter | 发送消息 | 当输入框未聚焦时，按 Enter 可直接发送。 |
Ctrl + S | 发送消息 | 当输入框聚焦时，按 Ctrl+S 来发送消息。 |
\ + Enter | 插入换行 | 在输入框中，先按 \，再按 Enter，可以输入一个换行符，而不是发送消息。 |
Ctrl + E | 打开外部编辑器 | 系统会调用你设置的 $EDITOR 环境变量指定的编辑器（如 Vim, Nano）来编辑消息。 |
Ctrl + R | 管理附件 | 快速删除已添加的文件附件。 |
💡 提示：i 和 Esc 的组合模仿了 Vim 的“插入模式”和“普通模式”切换，非常符合 Vim 用户的习惯。
✅ 验证：在消息列表中按 i，光标应跳转到输入框。在输入框中按 Esc，光标应消失，焦点回到消息列表。
第 4 步：处理 AI 权限请求
🎯 目标：当 AI 需要执行命令或操作文件时，快速做出“允许”或“拒绝”的决定。
📝 操作：当 AI 向你请求权限时，会弹出一个对话框。请使用以下快捷键。
| 快捷键 | 动作 | 说明 |
|---|---|---|
← / → 或 Tab | 切换选项 | 在“允许一次”、“允许本次会话”、“拒绝”等选项间切换。 |
Enter 或 Space | 确认选择 | 执行当前高亮的选项。 |
a | 允许一次 | 快捷操作，直接允许本次请求。 |
s | 允许本次会话 | 快捷操作，在此次会话中不再询问类似操作。 |
d | 拒绝 | 快捷操作，直接拒绝本次请求。 |
⚠️ 常见错误：不要混淆 a（允许一次）和 s（允许本次会话）。s 的权限更大，请谨慎使用。
✅ 验证：尝试让 AI 执行一个需要权限的命令（如 ls），当对话框出现时，按 d 拒绝，命令将不会执行。
进阶技巧（可选）
掌握基础后，你可以尝试：
- 自定义
$EDITOR：如果你习惯使用 Vim 或 VS Code，可以设置环境变量EDITOR=vim或EDITOR=code，然后使用Ctrl+E来调用它们编辑长消息。 - 使用
@补全：在输入框中输入@会触发文件/文件夹的自动补全，按j/k选择，Enter确认，可以快速引用项目中的文件。
常见问题 (FAQ)
Q1: 我按了 i 键，但无法输入文字？A: 请确保你的焦点不在输入框中。如果已经在输入框中，i 键是无效的。你可以先按 Esc 退出输入模式，然后再按 i 重新进入。
Q2: 如何查看所有快捷键的完整列表？A: 在 OpenCode 界面中，按 ? 键即可调出帮助面板，其中包含了所有快捷键的完整列表。
总结
恭喜你完成了本教程！🎉
回顾一下我们今天学到的核心内容：
- 核心操作：使用
Ctrl+N/X/F/L/T/O等快捷键可以快速触发各种功能。 - Vim 导航：使用
j/k/h/l和PgUp/PgDn等键可以像操作 Vim 一样在界面中高效移动。 - 消息编辑：掌握
i、Esc、\ + Enter和Ctrl+E可以让消息输入更加灵活。 - 权限管理：使用
a/s/d快捷键可以快速处理 AI 的请求，无需鼠标点击。