Kimi Code CLI 快速入门
Kimi Code CLI 快速入门
键盘快捷键
1 分钟阅读
键盘快捷键
Kimi Code CLI 的核心交互入口为终端 TUI(文本用户界面),全套键盘快捷键设计贴合终端开发者的操作习惯,无需鼠标即可完成所有交互操作,尤其适用于远程服务器、无图形界面环境下的高效编码协作。掌握本页的键位规则后,可实现全流程键盘操作,效率远超普通GUI AI助手。本文档覆盖所有场景下的快捷键定义,TUI 内随时输入 /help 可唤起内置快捷键清单,无需离开会话即可查阅。
键位按使用场景分为六组:通用输入、模式切换、输入与编辑、流式输出期间、工具输出控制、审批面板,以及弹窗浏览,各组快捷键互不冲突,可配合使用。
通用快捷键
通用快捷键是所有场景下均生效的基础操作,为最高频使用的键位,建议优先熟练掌握。以下键位在输入框中始终可用:
| 快捷键 | 功能 | 补充说明 |
|---|---|---|
Enter | 提交当前输入 | 适用于单轮prompt提交,输入完成后按Enter即可发送给AI处理,多行输入时需配合换行快捷键使用 |
Shift-Enter / Ctrl-J | 在输入中插入换行 | 输入复杂需求、大段代码等多行内容时使用,避免误触发提交,换行后内容仍属于同一条输入 |
↑ / ↓ | 浏览输入历史 | 可快速调取之前发送过的prompt,无需重复输入,最多保留最近100条历史记录 |
Esc | 关闭弹窗 / 取消补全 / 中断流式输出或上下文压缩 | 多功能取消键,适用场景包括:关闭帮助/审批弹窗、取消当前命令补全、中断AI正在生成的内容,无需等待输出完成 |
Ctrl-C | 中断当前流式输出,或清空输入框 | 流式输出期间按Ctrl-C会立即终止生成,无需二次确认;输入框有内容时按Ctrl-C会清空当前输入,方便重新编辑 |
Ctrl-D | 在输入框为空时退出 Kimi Code CLI | 符合终端工具通用退出习惯,仅输入框为空时生效,避免误触 |
特殊机制说明
- 流式输出终止:流式输出期间按
Ctrl-C会立即取消,无需二次确认,节省等待时间。 - 退出双击确认:退出程序(输入框为空时按
Ctrl-C,或按Ctrl-D)使用「双击确认」机制:第一次按下后状态栏会出现黄色提示,再按一次相同的键才真正退出。中途按其他键会清除确认状态,有效避免误触退出。
模式切换
模式切换快捷键用于快速切换会话的工作模式,无需输入斜杠命令即可完成状态切换,操作成本极低。
| 快捷键 | 功能 | 补充说明 |
|---|---|---|
Shift-Tab | 切换 Plan 模式 | 按 Shift-Tab 可开启或关闭 Plan 模式,状态栏会实时显示当前模式状态 |
按 Shift-Tab 开启 Plan 模式后,Agent 会优先使用只读工具进行代码调研和方案规划,仅可写入当前计划文件,不会修改其他业务文件;Bash 命令按当前权限模式和普通规则处理,不会因 Plan 模式额外发起独立审批。单纯切换模式不会创建空计划文件,仅当Agent生成规划内容时才会自动创建计划文件。再次按 Shift-Tab 即可退出 Plan 模式。
最佳实践:首次接触陌生项目、需求不明确或需要严格控制修改范围时,建议先开启Plan模式,待规划方案确认后再退出模式执行,可有效避免AI误改文件。
输入与编辑
输入与编辑快捷键用于优化复杂内容的输入体验,解决终端输入框编辑能力有限的问题,支持调用外部编辑器、粘贴多媒体内容等高级操作。
| 快捷键 | 功能 | 补充说明 |
|---|---|---|
Ctrl-G | 在外部编辑器中编辑当前输入 | 适用于输入超长prompt、大段代码、复杂格式内容的场景,调用外部编辑器(如VS Code、Vim)编辑,体验远优于终端输入框 |
Ctrl-V | 粘贴剪贴板中的图片或视频(Unix / macOS) | 无需保存截图到本地,直接将系统剪贴板中的图片/视频粘贴到输入框,提交时自动发送给多模态模型,大幅提升问题反馈效率 |
Alt-V | 粘贴剪贴板中的图片或视频(Windows) | Windows平台下的多媒体粘贴快捷键,适配Windows系统剪贴板机制 |
Ctrl-- | 撤销(Undo) | 撤销输入框的上一步编辑操作,最多支持撤销最近20步操作 |
外部编辑器优先级规则
按 Ctrl-G 会打开外部编辑器,编辑器按以下优先级选择:
/editor命令配置的编辑器(TUI内设置优先级最高,适合临时切换编辑器)$VISUAL环境变量(系统级编辑器配置,适用于所有终端工具)$EDITOR环境变量(传统终端编辑器配置,作为兜底选项)
保存并退出编辑器后,编辑内容会自动替换输入框内容;不保存退出则保持输入框原有内容不变。
配置示例:若要使用VS Code作为外部编辑器,可在
~/.zshrc或~/.bashrc中添加export VISUAL="code --wait",重启终端后即可生效。
多媒体粘贴说明
粘贴图片或视频时,输入框中显示占位符,实际媒体数据在提交时一并发送给模型。优先从系统剪贴板读取;Linux 上会自动尝试 Wayland 与 X11 剪贴板,WSL 下还会通过 PowerShell 兜底读取 Windows 剪贴板,无需额外配置即可跨系统使用。
注意:多媒体粘贴功能仅支持多模态模型,普通文本模型会忽略媒体内容,使用前请确认当前会话使用的模型支持视觉能力。
流式输出期间
流式输出(AI正在生成回复)期间,输入框依然可以接收输入,并支持以下额外操作,无需中断生成即可执行:
| 快捷键 | 功能 | 补充说明 |
|---|---|---|
Ctrl-S | Steer:将当前输入立即注入正在运行的轮次 | 当AI输出到一半出现理解偏差、遗漏需求时,无需等待输出完成,直接输入修正内容按Ctrl-S,AI会在下一个可中断的时机立刻收到你的消息,调整输出方向,大幅节省沟通成本 |
Esc | 中断当前流式输出 | 与Ctrl-C效果一致,适合习惯用Esc取消操作的用户 |
Ctrl-C | 中断当前流式输出 | 立即终止当前生成,释放token配额,避免无效内容消耗配额 |
工具输出
工具输出快捷键用于控制工具调用结果的展示状态,优化界面信息密度。
| 快捷键 | 功能 | 补充说明 |
|---|---|---|
Ctrl-O | 展开或折叠工具输出 | 当历史中存在折叠的工具调用结果时,按 Ctrl-O 可在折叠和展开之间切换。工具输出较长时折叠可保持界面整洁,需要排查问题时展开查看细节 |
审批面板
当 Agent 发起需要确认的工具调用(如文件写入、Shell命令执行)时,TUI 会弹出审批面板,所有操作均可通过键盘完成,无需鼠标点击。详细审批流程见交互与输入,面板内可用键位如下:
| 快捷键 | 功能 | 补充说明 |
|---|---|---|
↑ / ↓ | 在候选选项之间移动光标 | 上下切换审批选项(如Approve、Reject、Revise等) |
Enter | 确认当前选中的选项 | 提交选中的审批结果 |
1 ~ 9 | 直接选择对应序号的选项 | 无需按上下键切换,直接按选项前的数字即可快速选择,大幅提升审批效率 |
Esc / Ctrl-C / Ctrl-D | 拒绝当前请求 | 快速拒绝工具调用,无需切换到Reject选项 |
Ctrl-E | 面板包含 diff 或文件内容预览时,展开或折叠完整内容 | 当AI提交文件修改时,可按Ctrl-E查看完整diff内容,确认修改范围和正确性后再审批,避免误改 |
Ctrl-O | 切换其他工具输出的折叠状态 | 审批时可快速查看历史工具输出内容,辅助决策 |
需要附带反馈的选项(如「Reject」「Revise」)会在确认后切换到反馈输入态:直接输入反馈文本,按 Enter 提交;按 Esc 退出反馈输入并回到候选列表。
弹窗模式
输入 /help 打开帮助面板、查看长文本内容时,可使用以下键位浏览和关闭面板,符合终端文件浏览的操作习惯:
| 快捷键 | 功能 | 补充说明 |
|---|---|---|
↑ / ↓ | 单行滚动 | 逐行浏览内容,适合查看细节 |
PageUp / PageDown | 每次滚动 10 行 | 快速翻页,适合浏览长文档 |
Esc / Enter / q / Q | 关闭面板 | 支持多种关闭快捷键,适配不同用户的操作习惯(q键符合Vim用户操作习惯) |