Appearance
交互模式参考
Claude Code CLI 的使用核心在于其强大的交互模式,它通过丰富的键盘快捷键和功能设计极大提升了开发效率。本文是完整的 Claude Code CLI 使用指南,详细介绍了如何通过快捷键进行快速编辑、使用 Vim 模式、进行多行输入、管理命令历史、在后台运行 Bash 命令以及利用侧边问题(/btw)进行临时查询。无论是 claude code cli 使用的新手还是希望深入掌握高级功能的用户,这份 claude code cli使用教程都能帮助你更高效地与 Claude Code 进行交互,充分利用其作为智能编程助手的全部潜力。
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+X Ctrl+K | 终止所有后台代理 | 3 秒内按两次确认 |
Ctrl+D | 退出 Claude Code 会话 | EOF 信号 |
Ctrl+G 或 Ctrl+X Ctrl+E | 在默认文本编辑器中打开 | 编辑提示词或自定义响应,Ctrl+X Ctrl+E 是 readline 原生绑定 |
Ctrl+L | 清空提示输入 | 清除已输入的文字,保留对话历史 |
Ctrl+O | 切换详细转录 | 显示工具使用详情,展开 MCP 调用(默认折叠为"Called slack 3 times"形式)。全屏模式下循环三种状态:普通提示 → 转录模式 → 焦点视图 |
Ctrl+R | 反向搜索命令历史 | 交互式搜索之前的命令 |
Ctrl+V / Cmd+V(iTerm2)/ Alt+V(Windows) | 从剪贴板粘贴图片 | 在光标处插入 [Image #N] 标签,可在提示词中按位置引用 |
Ctrl+B | 后台运行任务 | 将 Bash 命令和代理移到后台(tmux 用户需按两次) |
Ctrl+T | 切换任务列表 | 显示或隐藏终端状态区域中的任务列表 |
Left/Right 方向键 | 在对话框标签页间循环 | 在权限对话框和菜单中的标签页间导航 |
Up/Down 方向键 | 浏览命令历史 | 回调之前的输入 |
Esc + Esc | 回退或摘要 | 恢复代码和/或对话到之前的状态,或从选定消息开始摘要 |
Shift+Tab 或 Alt+M(部分配置) | 切换权限模式 | 循环切换 default、acceptEdits、plan 及已启用的模式。详见权限模式 |
Option+P(macOS)/ Alt+P(Windows/Linux) | 切换模型 | 不清空提示词直接切换模型 |
Option+T(macOS)/ Alt+T(Windows/Linux) | 切换扩展思考 | 开/关扩展思考模式(macOS 需配置 Option 为 Meta) |
Option+O(macOS)/ Alt+O(Windows/Linux) | 切换快速模式 | 开/关快速模式 |
文字编辑快捷键
| 快捷键 | 说明 |
|---|---|
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} | 跳到上一个字符出现处 |
t{char} | 跳到下一个字符出现处的前一位 |
T{char} | 跳到上一个字符出现处的后一位 |
; | 重复上次 f/F/t/T 移动 |
, | 反向重复上次 f/F/t/T 移动 |
NORMAL 模式编辑
| 命令 | 动作 |
|---|---|
x | 删除字符 |
dd | 删除行 |
D | 删除到行尾 |
dw/de/db | 删除单词/到词尾/向后 |
cc | 修改行 |
C | 修改到行尾 |
cw/ce/cb | 修改单词/到词尾/向后 |
yy/Y | 复制行 |
yw/ye/yb | 复制单词/到词尾/向后 |
p | 光标后粘贴 |
P | 光标前粘贴 |
>> | 缩进行 |
<< | 反缩进行 |
J | 合并行 |
. | 重复上次修改 |
文本对象(与 d、c、y 配合使用)
| 命令 | 动作 |
|---|---|
iw/aw | 内部/周围单词 |
iW/aW | 内部/周围 WORD(空白分隔) |
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)。
相关资源
常见问题
Q: claude code cli 使用有哪些核心快捷键?
核心快捷键包括 Ctrl+C 取消当前操作、Ctrl+D 退出会话、Ctrl+R 反向搜索历史、Ctrl+B 将命令移至后台运行、Ctrl+T 切换任务列表,以及 Esc+Esc 进行状态回退或摘要。
Q: claude code cli使用教程中如何输入多行命令?
有多种方式:在所有终端中可使用 \ + Enter;在 macOS 终端中可使用 Option+Enter;在 iTerm2、WezTerm 等终端中可使用 Shift+Enter;也可直接粘贴多行代码块。
Q: 如何在 Claude Code CLI 中高效管理命令历史?
使用上下方向键浏览历史,或按 Ctrl+R 进行交互式反向搜索。历史按工作目录存储,输入 /clear 开始新会话时会重置当前目录的历史记录。
Q: Claude Code CLI 的侧边问题(/btw)功能有什么用?
/btw 允许你提出临时性问题,这些问题不会加入主对话历史,也不会中断 Claude 正在进行的任务。它基于已有上下文回答,适合快速查询已讨论过的内容。
Q: 如何让 Bash 命令在 Claude Code CLI 后台运行?
有两种方式:一是让 Claude 建议的命令在后台运行;二是在任何 Bash 命令执行时按 Ctrl+B 将其移至后台。后台任务的输出会被缓冲,Claude 可以随时检索。