交互模式与终端体验
Claude Code 交互模式、键盘快捷键、Vim mode、命令历史、shell mode、后台 Bash、终端配置、tmux、fullscreen、语音输入和 5m/1h 缓存影响。
这页补齐官方 Interactive mode、Keybindings、Terminal config、Fullscreen rendering 和 Voice dictation 的核心内容。命令清单看 命令大全,CLI 命令、安装渠道、环境变量、PATH、deep links 和终端参考看 CLI 与终端参考,这里聚焦“人在终端里怎么高效操作”。
#快捷键速查
| 操作 | 默认快捷键 | 说明 |
|---|---|---|
| 打断当前回复 | Esc 或 Ctrl+C | 不中止整个 session |
| 退出 | Ctrl+D | 当前输入为空时退出 |
| 清屏 | Ctrl+L | 不清上下文 |
| 搜索历史 | Ctrl+R | 跨项目命令历史搜索视版本而定 |
| 展开/收起 transcript | Ctrl+O | 查看更完整上下文 |
| 切换 TODO 视图 | Ctrl+T | 看任务列表 |
| 切换权限模式 | Shift+Tab | 在 default、plan、auto 等模式间切换 |
| 计划相关入口 | Option+P | macOS 终端要启用 Option as Meta |
| 任务/后台入口 | Option+T | 用于 background 和 task 视图 |
| 输出/transcript 入口 | Option+O | 终端支持决定稳定性 |
不同终端会拦截 Option、Shift+Enter、鼠标滚轮或系统快捷键。不稳定时先跑:
/terminal-setup#输入模式
| 输入 | 作用 | 缓存影响 |
|---|---|---|
/ | 打开命令菜单 | 只浏览菜单不调用模型 |
@ | 引用文件、目录或资源 | 读入内容后增加上下文 |
# | 快速写入记忆 | 后续新会话可能改变前缀 |
! | shell mode,运行命令并把输出带入上下文 | 输出越长,后续 token 越多 |
| 图片粘贴 | 把截图作为输入 | 大图会增加请求体 |
/btw | 旁路问题 | 不进入主 conversation,缓存友好 |
! 前缀适合把一次 shell 输出交给 Claude 解释。不要用它打印大段敏感日志。需要长期监控输出时,优先看 工具参考 里的 Monitor 工具和 Routines 与 /loop 调度。
#多行输入
常见方式:
| 方式 | 适合 |
|---|---|
Shift+Enter | 支持该组合的终端 |
| 粘贴多行文本 | 大多数终端可用 |
| 反斜杠续行 | shell 风格短输入 |
| 外部编辑器 | 长 prompt 或复杂计划 |
终端不支持 Shift+Enter 时,根据官方终端配置页调整 iTerm2、Terminal.app、VS Code terminal、Warp 或 tmux 设置。配置后用一条短多行 prompt 测试,不要直接在生产任务里试。
#Vim mode
现在切换 Vim/normal 输入模式使用 /config 里的 Editor mode,不是旧 /vim 命令。
| 模式 | 说明 |
|---|---|
| Insert | 正常输入 |
| Normal | 使用 h/j/k/l、w/b/e、0/$ 等移动 |
| Visual | 选择文本后删除、复制或替换 |
| Command | 通过配置动作执行历史、提交、取消等 |
Vim mode 只影响输入编辑,不改变模型 prompt,也不会让 5m/1h 缓存失效。它和自定义 keybindings 可能有冲突,冲突时以当前 keybindings 配置和终端拦截为准。
#自定义 keybindings
官方支持通过 keybindings 配置重绑定动作。适合:
- 终端拦截了默认快捷键。
- 团队想统一常用操作。
- 你长期使用 Vim/tmux,想避开冲突。
- 语音输入、diff、model picker 或 task 视图需要更顺手的键。
配置时先改少量高频键,不要一次性重写整套默认键位。常见风险:
| 风险 | 处理 |
|---|---|
| 系统或终端先拦截 | 换组合或改终端设置 |
| 与 Vim mode 冲突 | 按上下文区分 normal/insert |
| 与 tmux prefix 冲突 | 避开 Ctrl+B 或改 tmux prefix |
| 配置无效 | 用 /doctor 或 safe mode 排查 |
#后台 Bash 和任务
Claude Code 可以把长命令放到后台,例如 dev server、watch test、日志 tail。
| 操作 | 命令或入口 |
|---|---|
| 查看后台任务 | /tasks 或 /bashes |
| 停止任务 | /stop 或任务视图 |
| 让 Claude 继续观察输出 | 使用 Monitor 或让它读取保存的日志 |
| Headless 下等待后台任务 | CLAUDE_CODE_PRINT_BG_WAIT_CEILING_MS |
后台 Bash 输出进入上下文后会增加 token。长时间 watch 命令要过滤输出,例如只保留 error、fail、warning 或最后 N 行。
#Fullscreen rendering 和鼠标
Fullscreen rendering 是官方的终端渲染模式,目标是减少闪烁、改善长对话滚动和鼠标体验。
| 能力 | 说明 |
|---|---|
| 鼠标选择 | 可在支持的终端里更稳定选择文本 |
| 滚轮 | 支持滚动 conversation |
| 搜索/回看 | 长 transcript 更容易查 |
| tmux | 需要确认 mouse 和 alternate screen 配置 |
| 原生文本选择 | 某些终端需按住修饰键 |
这只是本地 UI renderer,不改变模型请求,也不影响 prompt cache。遇到渲染异常时,先切回默认 TUI 或 classic renderer 确认是否是终端兼容问题。
#tmux、主题和通知
| 需求 | 建议 |
|---|---|
| tmux 内快捷键冲突 | 调整 prefix、mouse、escape-time |
| Claude 完成时提醒 | 终端 bell 或 Notification hook |
| 主题不一致 | 用 /theme 或自定义 theme |
| Option 键无效 | macOS 终端打开 Option as Meta |
| 大文本粘贴慢 | 写入临时文件,让 Claude 读取路径 |
主题、fullscreen、keybindings、terminal bell 都是本地体验配置。它们不改变 system prompt,通常不影响 5m/1h 缓存。
#语音输入
Voice dictation 是官方账号能力,可通过 hold-to-record 或 tap-to-record 输入 prompt。
| 项 | 注意 |
|---|---|
| 账号 | 通常需要 claude.ai 登录 |
| 权限 | macOS 要给终端麦克风权限 |
| 语言 | 可配置 dictation language |
| 键位 | 可重新绑定 |
| Passion8 | 自定义 API key 或 Base URL 可能让语音能力不可用 |
语音最终会变成文本 prompt。文本进入会话后,缓存规则和普通输入一样。
#排错路径
| 现象 | 先看 |
|---|---|
| 快捷键无效 | 终端是否拦截、keybindings、tmux |
Shift+Enter 不能换行 | /terminal-setup 和终端配置 |
| Vim mode 行为不对 | /config 的 Editor mode |
| Fullscreen 闪烁或鼠标异常 | 切默认 renderer,检查 tmux/终端 |
| 语音没有录音权限 | 系统麦克风权限和官方登录 |
| Claude 高 CPU 或卡死 | 常见问题 |
#缓存影响
| 操作 | 5m / 1h 怎么看 |
|---|---|
| 搜索历史、切主题、改快捷键 | 本地 UI 操作,不影响 prompt cache |
! shell mode | 命令输出进入上下文后会增加后续 token |
写入 CLAUDE.md 或记忆 | 当前会话不一定立即生效,新会话可能重建前缀 |
/btw | 不污染主 conversation,适合临时旁路问题 |
| Fullscreen/tmux/terminal bell | 本地体验,不改 cache key |
| 语音输入 | 转成普通文本后按普通消息处理 |
逐命令表见 命令与缓存影响。
#官方参考
Support / 支持
Need help? / 需要帮助?
接入、计费与模型异常可邮件联系;服务可用性以状态页为准。
For setup, billing, or model issues, email us. Check the status page for uptime.
也可使用右下角微信 / QQ 客服 · WeChat / QQ support is available at the bottom right

