Claude Code

交互模式与终端体验

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 与终端参考,这里聚焦“人在终端里怎么高效操作”。

#快捷键速查

操作默认快捷键说明
打断当前回复EscCtrl+C不中止整个 session
退出Ctrl+D当前输入为空时退出
清屏Ctrl+L不清上下文
搜索历史Ctrl+R跨项目命令历史搜索视版本而定
展开/收起 transcriptCtrl+O查看更完整上下文
切换 TODO 视图Ctrl+T看任务列表
切换权限模式Shift+Tab在 default、plan、auto 等模式间切换
计划相关入口Option+PmacOS 终端要启用 Option as Meta
任务/后台入口Option+T用于 background 和 task 视图
输出/transcript 入口Option+O终端支持决定稳定性

不同终端会拦截 OptionShift+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/lw/b/e0/$ 等移动
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