Skip to content

交互模式参考

Claude Code CLI 的使用核心在于其强大的交互模式,它通过丰富的键盘快捷键和功能设计极大提升了开发效率。本文是完整的 Claude Code CLI 使用指南,详细介绍了如何通过快捷键进行快速编辑、使用 Vim 模式、进行多行输入、管理命令历史、在后台运行 Bash 命令以及利用侧边问题(/btw)进行临时查询。无论是 claude code cli 使用的新手还是希望深入掌握高级功能的用户,这份 claude code cli使用教程都能帮助你更高效地与 Claude Code 进行交互,充分利用其作为智能编程助手的全部潜力。

Claude Code CLI 交互界面的完整参考,包括键盘快捷键、输入模式和各种交互功能。

macOS 用户注意:Option/Alt 快捷键(Alt+BAlt+FAlt+YAlt+MAlt+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+GCtrl+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+TabAlt+M(部分配置)切换权限模式循环切换 defaultacceptEditsplan 及已启用的模式。详见权限模式
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+YCtrl+Y 后)循环粘贴历史
Alt+B光标向后移一个单词
Alt+F光标向前移一个单词

多行输入

方式快捷键适用终端
快速换行\ + Enter所有终端
macOS 默认Option+EntermacOS 终端
Shift+EnterShift+EnteriTerm2、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)

  1. Ctrl+R 激活反向历史搜索
  2. 输入查询文字,匹配结果高亮显示
  3. 再次按 Ctrl+R 循环查看更早的匹配
  4. 接受匹配:
    • TabEsc:接受并继续编辑
    • Enter:接受并立即执行
  5. 取消搜索: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合并行
.重复上次修改

文本对象(与 dcy 配合使用)

命令动作
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 键)
  • EscapeBackspace 或空提示时的 Ctrl+U 退出 Bash 模式

提示词建议

首次打开会话时,提示输入框中会出现灰色的示例命令(来自项目 git 历史,反映近期工作的文件)。

Claude 响应后,建议会根据对话历史继续出现。

  • Tab 接受建议,或按 Enter 接受并提交
  • 开始输入可以忽略建议

禁用提示词建议:

bash
export CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION=false

侧边问题(/btw)

/btw 让你快速提问,不加入对话历史,不干扰 Claude 正在进行的任务:

/btw 那个配置文件叫什么名字来着?

特性:

  • 完整可见当前对话上下文,可以问关于 Claude 已读取的代码、之前做的决定等
  • 问答是临时的:出现在可以关闭的浮层中,不进入对话历史
  • Claude 工作时也可以使用:侧边问题独立运行,不中断主任务
  • 无工具访问:只能基于已在上下文中的内容回答
  • 单次响应:不支持多轮跟进

SpaceEnterEscape 关闭答案,返回提示框。

/btw 是子代理的逆操作:它能看到完整对话但没有工具;子代理有完整工具但从空白上下文开始。用 /btw 问 Claude 已知的内容,用子代理去查找新信息。

任务列表

处理复杂多步骤工作时,Claude 会创建任务列表跟踪进度,显示在终端状态区域。

  • Ctrl+T 切换任务列表视图(最多显示 10 个任务)
  • 直接告诉 Claude:"显示所有任务" 或 "清除所有任务"
  • 任务在上下文压缩后仍然保留,帮助 Claude 在大型项目上保持组织

跨会话共享任务列表:

bash
CLAUDE_CODE_TASK_LIST_ID=my-project claude

PR 审查状态

在有开放 PR 的分支上工作时,Claude Code 会在底部显示可点击的 PR 链接(如 "PR #446"),颜色表示审查状态:

颜色状态
绿色已批准
黄色待审查
红色需要修改
灰色草稿
紫色已合并

Cmd+click(Mac)或 Ctrl+click(Windows/Linux)在浏览器中打开 PR。状态每 60 秒自动更新。

PR 状态需要安装并认证 gh CLI(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 可以随时检索。