CodeBuddy Code 交互式会话中的完整键盘快捷键、输入模式和交互功能参考。
键盘快捷键可能因平台和终端而异。在交互式会话中输入问号 ?可查看您环境中可用的快捷键。
快捷键 | 描述 | 上下文 | CodeBuddy 支持 |
| 取消当前输入或生成 | 标准中断 | 支持 |
| 退出 CodeBuddy Code 会话（输入框为空且无进行中对话时） | EOF 信号，连按两次退出 | 支持 |
| 清除终端屏幕 | 保留对话历史 | 支持 |
| 切换详细输出 | 显示详细的工具使用和执行信息 | 支持 |
| 反向搜索命令历史 | 交互式搜索之前的命令 | 支持 |
| 从剪贴板粘贴文本或图片；Windows 上推荐用 | 粘贴文本、图片或图片文件路径 | 支持 |
| 导航命令历史 | 调用之前的输入；队列中存在排队消息时， | 支持 |
| 回退代码/对话 | 将代码和/或对话恢复到之前的状态 (需在输入框为空时连续按两次) | 支持 |
| 切换思考模式 | 在思考开启和思考关闭之间切换 | 支持 |
| 切换权限模式 | 在 | 支持 |
| 切换模型 | 快速打开模型选择面板 | 支持 |
说明：
Esc + Esc 回退功能已支持：当输入框内容为空时，连续按两次 ESC 键可激活 /rewind 功能，快速回退代码或对话到之前的状态
Tab 键在 CodeBuddy Code 中主要用于自动补全，扩展思考模式的切换功能部分支持
Shift+Tab 用于切换权限模式（所有平台通用，Windows 同时支持 Alt+M 作为别名）。当前循环顺序为：default → bypassPermissions → acceptEdits → auto（可用时）→ plan → delegate。dontAsk 不在键盘循环中，需要通过 --permission-mode dontAsk 或 settings 进入。可通过 ~/.codebuddy/keybindings.json 自定义
方法 | 快捷键 | 上下文 | CodeBuddy 支持 |
快速转义 |
| 在所有终端中工作 | 支持 |
macOS 默认 |
| macOS 上的默认设置 | 支持 |
终端设置 |
| 执行 | 支持 |
控制序列 |
| 多行的换行字符 | 支持 |
粘贴模式 | 直接粘贴 | 用于代码块、日志 | 支持 |
说明：
在终端设置中配置您首选的换行行为。运行 `/terminal-setup` 为 iTerm2 和 VS Code 终端安装 Shift + Enter 绑定。
快捷键 | 描述 | 注释 | CodeBuddy 支持 |
| 记忆快捷方式 - 添加到 CODEBUDDY.md | 提示选择文件 | 支持 |
| 斜杠命令 | 参见 斜杠命令 | 支持 |
| Bash 模式 | 直接运行命令并将执行输出添加到会话 | 支持 |
| 文件路径提及 | 触发文件路径自动补全 | 支持 |
快捷键 | 描述 | CodeBuddy 支持 |
| 移动到行首 | 支持 |
| 移动到行尾 | 支持 |
| 删除从光标到行尾 | 支持 |
| 删除从行首到光标 | 支持 |
| 删除前一个单词 | 支持 |
| 复制最后一条 AI 回复到剪贴板 | 支持 |
| 删除前一个单词 | 支持 |
| 删除下一个单词 | 支持 |
| 移动到上一个单词 | 支持 |
| 移动到下一个单词 | 支持 |
| 移动到行首 | 支持 |
| 移动到行尾 | 支持 |
| 打开外部编辑器编辑提示词 | 支持 |
使用 /vim 命令启用 vim 风格编辑,或通过 /config 永久配置。
命令 | 操作 | 从模式 | CodeBuddy 支持 |
| 进入 NORMAL 模式 | INSERT | 支持 |
| 在光标前插入 | NORMAL | 支持 |
| 在行首插入 | NORMAL | 支持 |
| 在光标后插入 | NORMAL | 支持 |
| 在行尾插入 | NORMAL | 支持 |
| 在下方打开新行 | NORMAL | 支持 |
| 在上方打开新行 | NORMAL | 支持 |
命令 | 操作 | CodeBuddy 支持 |
| 向左/下/上/右移动 | 支持 |
| 下一个单词 | 支持 |
| 单词末尾 | 支持 |
| 上一个单词 | 支持 |
| 行首 | 支持 |
| 行尾 | 支持 |
| 第一个非空白字符 | 支持 |
| 输入开始 | 支持 |
| 输入结束 | 支持 |
命令 | 操作 | CodeBuddy 支持 |
| 删除字符 | 支持 |
| 删除行 | 支持 |
| 删除到行尾 | 支持 |
| 删除单词/到末尾/到开头 | 支持 |
| 修改行 | 支持 |
| 修改到行尾 | 支持 |
| 修改单词/到末尾/到开头 | 支持 |
| 重复上次修改 | 支持 |
CodeBuddy Code 为当前会话维护命令历史：
历史记录按工作目录存储
使用 /clear 开启全新对话（旧对话可通过 /resume 恢复）
使用 Up/Down 方向键导航 （参见上面的键盘快捷键）
注意：历史扩展 （!) 默认禁用
当 Agent 正在响应时，您输入并回车的消息会进入排队，显示在输入框上方。此时输入框为空，按 Up 方向键即可把排队中的消息拉回输入框继续编辑（多条排队消息会按发送顺序合并，以换行拼接）：
输入框为空且有可编辑排队消息时，会显示「Press ↑ to edit queued messages」提示
系统注入的排队项（异步任务通知、频道消息、队友消息等）不会被拉回输入框，会保留在队列中继续自动处理
已经在用 Up/Down 回溯历史时，方向键仍按历史导航处理，不会打断
按 Ctrl+R 交互式搜索您的命令历史：
开始搜索：按 Ctrl+R 激活反向历史搜索
输入查询：输入文本以在之前的命令中搜索 - 搜索词将在匹配结果中高亮显示
导航匹配：再次按 Ctrl+R 循环浏览更早的匹配项
接受匹配:
按 Tab 或 Esc 接受当前匹配并继续编辑
按 Enter 接受并立即执行命令
取消搜索:
按 Ctrl+C 取消并恢复原始输入
在空搜索时按 Backspace 取消
搜索显示匹配的命令并高亮搜索词，方便查找和重用之前的输入。
CodeBuddy Code 支持在后台运行 bash 命令，允许您在长时间运行的进程执行时继续工作。
当 CodeBuddy Code 在后台运行命令时，它会异步运行命令并立即返回后台任务 ID。CodeBuddy Code 可以在命令继续在后台执行时响应新的提示。要在后台运行命令，您可以：
提示 CodeBuddy Code 在后台运行命令
按 Ctrl+B 将常规 Bash 工具调用移至后台。(Tmux 用户必须按两次 Ctrl+B,因为 tmux 的前缀键。)
主要功能：
输出被缓冲，CodeBuddy 可以使用 TaskOutput 工具检索它
后台任务具有唯一 ID,用于跟踪和输出检索
CodeBuddy Code 退出时，后台任务会自动清理
常见的后台命令：
构建工具 （webpack, vite, make)
包管理器 （npm, yarn, pnpm)
测试运行器 （jest, pytest)
开发服务器
长时间运行的进程 （docker, terraform)
! 前缀的 Bash 模式通过在输入前加上 ! 前缀直接运行 bash 命令，无需通过 CodeBuddy:
! npm test! git status! ls -la
Bash 模式：
将命令及其输出添加到对话上下文中
显示实时进度和输出
支持相同的 Ctrl+B 后台运行长时间运行的命令
不需要 CodeBuddy 解释或批准命令
这对于快速 shell 操作同时保持对话上下文非常有用。
CodeBuddy Code 支持多种权限模式来控制工具使用的授权方式：
模式 | 描述 | 快捷键切换 |
普通模式 （默认） | 根据权限规则询问工具使用确认 |
|
自动接受编辑模式 | 自动批准文件编辑操作 （Edit/Write),其他工具仍需确认 |
|
跳过权限模式 | 绕过所有权限检查。建议仅在无互联网访问的沙箱中使用 |
|
计划模式 | AI 将制定计划并等待批准后再执行 |
|
使用 Shift+Tab 在模式之间切换（所有平台通用，Windows 同时支持 Alt+M 别名）。可通过 ~/.codebuddy/keybindings.json 自定义快捷键
使用 --permission-mode 命令行参数指定启动模式：
codebuddy --permission-mode acceptEditscodebuddy --permission-mode bypassPermissionscodebuddy --permission-mode plan
在 settings.json 中设置默认模式：
{ "permissions": { "defaultMode": "acceptEdits" }}
权限模式与权限规则结合使用，以提供细粒度控制。参见 IAM 文档 了解配置权限规则的详细信息。
说明：
在交互式会话中随时输入 ? 可查看可用的快捷键和命令。使用 /help 命令获取更多帮助信息。
