# Claude Code 交互模式与终端体验

> Claude Code 交互模式、键盘快捷键、Vim mode、命令历史、shell mode、后台 Bash、终端配置、tmux、fullscreen、语音输入和 5m/1h 缓存影响。

URL: https://docs.passion8.cc/docs/claude-code/interactive-terminal
Language: zh-CN
Publisher: Passion8

这页补齐官方 Interactive mode、Keybindings、Terminal config、Fullscreen rendering 和 Voice dictation 的核心内容。命令清单看 [命令大全](https://docs.passion8.cc/docs/claude-code/commands),CLI 命令、安装渠道、环境变量、PATH、deep links 和终端参考看 [CLI 与终端参考](https://docs.passion8.cc/docs/claude-code/cli-terminal-reference),这里聚焦“人在终端里怎么高效操作”。

## 快捷键速查

| 操作 | 默认快捷键 | 说明 |
| --- | --- | --- |
| 打断当前回复 | `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`、鼠标滚轮或系统快捷键。不稳定时先跑:

```text
/terminal-setup
```

## 输入模式

| 输入 | 作用 | 缓存影响 |
| --- | --- | --- |
| `/` | 打开命令菜单 | 只浏览菜单不调用模型 |
| `@` | 引用文件、目录或资源 | 读入内容后增加上下文 |
| `#` | 快速写入记忆 | 后续新会话可能改变前缀 |
| `!` | shell mode,运行命令并把输出带入上下文 | 输出越长,后续 token 越多 |
| 图片粘贴 | 把截图作为输入 | 大图会增加请求体 |
| `/btw` | 旁路问题 | 不进入主 conversation,缓存友好 |

`!` 前缀适合把一次 shell 输出交给 Claude 解释。不要用它打印大段敏感日志。需要长期监控输出时,优先看 [工具参考](https://docs.passion8.cc/docs/claude-code/tools) 里的 `Monitor` 工具和 [Routines 与 /loop 调度](https://docs.passion8.cc/docs/claude-code/routines-scheduling)。

## 多行输入

常见方式:

| 方式 | 适合 |
| --- | --- |
| `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 或卡死 | [常见问题](https://docs.passion8.cc/docs/claude-code/troubleshooting) |

## 缓存影响

| 操作 | 5m / 1h 怎么看 |
| --- | --- |
| 搜索历史、切主题、改快捷键 | 本地 UI 操作,不影响 prompt cache |
| `!` shell mode | 命令输出进入上下文后会增加后续 token |
| 写入 `CLAUDE.md` 或记忆 | 当前会话不一定立即生效,新会话可能重建前缀 |
| `/btw` | 不污染主 conversation,适合临时旁路问题 |
| Fullscreen/tmux/terminal bell | 本地体验,不改 cache key |
| 语音输入 | 转成普通文本后按普通消息处理 |

逐命令表见 [命令与缓存影响](https://docs.passion8.cc/docs/claude-code/command-cache)。

## 官方参考

- [Interactive mode](https://code.claude.com/docs/en/interactive-mode.md)
- [Customize keyboard shortcuts](https://code.claude.com/docs/en/keybindings.md)
- [Configure your terminal](https://code.claude.com/docs/en/terminal-config.md)
- [Fullscreen rendering](https://code.claude.com/docs/en/fullscreen.md)
- [Voice dictation](https://code.claude.com/docs/en/voice-dictation.md)