Appearance
交互模式参考
Claude Code CLI 交互界面的完整参考,包括键盘快捷键、输入模式和各种交互功能。
macOS 用户注意:Option/Alt 快捷键(
Alt+B、Alt+F、Alt+Y、Alt+M、Alt+P)需要在终端中将 Option 配置为 Meta 键:
- iTerm2:设置 → Profiles → Keys → 将左/右 Option 键设为 "Esc+"
- Terminal.app:设置 → Profiles → Keyboard → 勾选 "Use Option as Meta Key"
通用快捷键
| 快捷键 | 说明 | 上下文 |
|---|---|---|
Ctrl+C | 取消当前输入或生成 | 标准中断 |
Ctrl+D | 退出 Claude Code 会话 | EOF 信号 |
Ctrl+G | 在默认文本编辑器中打开 | 在编辑器中编辑提示词 |
Ctrl+L | 清屏 | 保留对话历史 |
Ctrl+O | 切换详细输出 | 显示工具使用详情,展开 MCP 读取和搜索调用 |
Ctrl+R | 反向搜索命令历史 | 交互式搜索之前的命令 |
Ctrl+V / Cmd+V(iTerm2)/ Alt+V(Windows) | 从剪贴板粘贴图片 | 粘贴图片或图片文件路径 |
Ctrl+B | 后台运行任务 | 将 Bash 命令和代理移到后台(tmux 用户需按两次) |
Ctrl+T | 切换任务列表 | 显示或隐藏终端状态区域中的任务列表 |
Ctrl+F | 终止所有后台代理 | 3 秒内按两次确认 |
Left/Right 方向键 | 在对话框标签页间循环 | 在权限对话框和菜单中的标签页间导航 |
Up/Down 方向键 | 浏览命令历史 | 回调之前的输入 |
Esc + Esc | 回退或摘要 | 恢复代码和/或对话到之前的状态,或从选定消息开始摘要 |
Shift+Tab 或 Alt+M | 切换权限模式 | 在自动接受、计划模式和正常模式之间切换 |
Option+P(macOS)/ Alt+P(Windows/Linux) | 切换模型 | 不清空提示词直接切换模型 |
Option+T(macOS)/ Alt+T(Windows/Linux) | 切换扩展思考 | 开/关扩展思考模式(先运行 /terminal-setup) |
文字编辑快捷键
| 快捷键 | 说明 |
|---|---|
Ctrl+K | 删除到行尾(删除内容存入粘贴缓冲区) |
Ctrl+U | 删除整行(删除内容存入粘贴缓冲区) |
Ctrl+Y | 粘贴删除的文字 |
Alt+Y(Ctrl+Y 后) | 循环粘贴历史 |
Alt+B | 光标向后移一个单词 |
Alt+F | 光标向前移一个单词 |
多行输入
| 方式 | 快捷键 | 适用终端 |
|---|---|---|
| 快速换行 | \ + Enter | 所有终端 |
| macOS 默认 | Option+Enter | macOS 终端 |
| Shift+Enter | Shift+Enter | iTerm2、WezTerm、Ghostty、Kitty |
| 控制序列 | Ctrl+J | 换行字符 |
| 粘贴模式 | 直接粘贴 | 代码块、日志等 |
Shift+Enter在 iTerm2、WezTerm、Ghostty 和 Kitty 中无需配置即可使用。其他终端(VS Code、Alacritty、Zed、Warp)运行/terminal-setup安装绑定。
快速命令
| 快捷键 | 说明 |
|---|---|
/ 开头 | 命令或 Skill |
! 开头 | Bash 模式,直接执行命令并将输出加入上下文 |
@ | 触发文件路径自动补全 |
语音输入
| 快捷键 | 说明 |
|---|---|
按住 Space | 推按录音(需启用语音听写功能) |
命令历史
Claude Code 为当前会话维护命令历史:
- 历史按工作目录存储
- 运行
/clear开始新会话时历史重置(之前的对话保留,可以恢复) - 使用 Up/Down 方向键导航
- 历史展开(
!)默认禁用
反向搜索(Ctrl+R)
- 按
Ctrl+R激活反向历史搜索 - 输入查询文字,匹配结果高亮显示
- 再次按
Ctrl+R循环查看更早的匹配 - 接受匹配:
Tab或Esc:接受并继续编辑Enter:接受并立即执行
- 取消搜索:
Ctrl+C(恢复原始输入)
Vim 编辑模式
用 /vim 命令启用,或在 /config 中永久配置。
模式切换
| 命令 | 动作 | 来源模式 |
|---|---|---|
Esc | 进入 NORMAL 模式 | INSERT |
i | 在光标前插入 | NORMAL |
I | 在行首插入 | NORMAL |
a | 在光标后插入 | NORMAL |
A | 在行尾插入 | NORMAL |
o | 在下方新建行 | NORMAL |
O | 在上方新建行 | NORMAL |
NORMAL 模式导航
| 命令 | 动作 |
|---|---|
h/j/k/l | 左/下/上/右移动 |
w | 下一个单词 |
e | 单词末尾 |
b | 上一个单词 |
0 | 行首 |
$ | 行尾 |
gg | 输入开头 |
G | 输入结尾 |
f{char} | 跳到下一个字符出现处 |
F{char} | 跳到上一个字符出现处 |
NORMAL 模式编辑
| 命令 | 动作 |
|---|---|
x | 删除字符 |
dd | 删除行 |
D | 删除到行尾 |
cc | 修改行 |
C | 修改到行尾 |
yy/Y | 复制行 |
p | 光标后粘贴 |
P | 光标前粘贴 |
. | 重复上次修改 |
文本对象(与 d、c、y 配合使用)
| 命令 | 动作 |
|---|---|
iw/aw | 内部/周围单词 |
i"/a" | 内部/周围双引号 |
i'/a' | 内部/周围单引号 |
i(/a( | 内部/周围括号 |
i[/a[ | 内部/周围方括号 |
i{/a{ | 内部/周围花括号 |
后台 Bash 命令
Claude Code 支持在后台运行 Bash 命令,继续处理其他提示词:
触发后台运行:
- 让 Claude Code 在后台运行某个命令
- 按
Ctrl+B将正在运行的 Bash 工具调用移到后台(tmux 用户需按两次)
特性:
- 输出被缓冲,Claude 可以通过 TaskOutput 工具检索
- 后台任务有唯一 ID 用于追踪
- Claude Code 退出时自动清理后台任务
- 输出超过 5GB 时自动终止
常见的后台任务:
- 构建工具(webpack、vite、make)
- 包管理器(npm、yarn、pnpm)
- 测试运行器(jest、pytest)
- 开发服务器
- 长时间运行的进程(docker、terraform)
禁用后台任务:
bash
export CLAUDE_CODE_DISABLE_BACKGROUND_TASKS=1! 前缀直接执行 Bash
在输入前加 ! 直接执行 Bash 命令,不经过 Claude:
bash
! npm test
! git status
! ls -la特性:
- 命令和输出会加入对话上下文
- 显示实时进度和输出
- 支持
Ctrl+B后台运行长时间命令 - 支持历史自动补全(Tab 键)
- 用
Escape、Backspace或空提示时的Ctrl+U退出 Bash 模式
提示词建议
首次打开会话时,提示输入框中会出现灰色的示例命令(来自项目 git 历史,反映近期工作的文件)。
Claude 响应后,建议会根据对话历史继续出现。
- 按
Tab接受建议,或按Enter接受并提交 - 开始输入可以忽略建议
禁用提示词建议:
bash
export CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION=false侧边问题(/btw)
/btw 让你快速提问,不加入对话历史,不干扰 Claude 正在进行的任务:
/btw 那个配置文件叫什么名字来着?特性:
- 完整可见当前对话上下文,可以问关于 Claude 已读取的代码、之前做的决定等
- 问答是临时的:出现在可以关闭的浮层中,不进入对话历史
- Claude 工作时也可以使用:侧边问题独立运行,不中断主任务
- 无工具访问:只能基于已在上下文中的内容回答
- 单次响应:不支持多轮跟进
按 Space、Enter 或 Escape 关闭答案,返回提示框。
/btw是子代理的逆操作:它能看到完整对话但没有工具;子代理有完整工具但从空白上下文开始。用/btw问 Claude 已知的内容,用子代理去查找新信息。
任务列表
处理复杂多步骤工作时,Claude 会创建任务列表跟踪进度,显示在终端状态区域。
- 按
Ctrl+T切换任务列表视图(最多显示 10 个任务) - 直接告诉 Claude:"显示所有任务" 或 "清除所有任务"
- 任务在上下文压缩后仍然保留,帮助 Claude 在大型项目上保持组织
跨会话共享任务列表:
bash
CLAUDE_CODE_TASK_LIST_ID=my-project claudePR 审查状态
在有开放 PR 的分支上工作时,Claude Code 会在底部显示可点击的 PR 链接(如 "PR #446"),颜色表示审查状态:
| 颜色 | 状态 |
|---|---|
| 绿色 | 已批准 |
| 黄色 | 待审查 |
| 红色 | 需要修改 |
| 灰色 | 草稿 |
| 紫色 | 已合并 |
Cmd+click(Mac)或 Ctrl+click(Windows/Linux)在浏览器中打开 PR。状态每 60 秒自动更新。
PR 状态需要安装并认证
ghCLI(gh auth login)。