Skip to content

交互模式参考

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+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+TabAlt+M切换权限模式在自动接受、计划模式和正常模式之间切换
Option+P(macOS)/ Alt+P(Windows/Linux)切换模型不清空提示词直接切换模型
Option+T(macOS)/ Alt+T(Windows/Linux)切换扩展思考开/关扩展思考模式(先运行 /terminal-setup

文字编辑快捷键

快捷键说明
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}跳到上一个字符出现处

NORMAL 模式编辑

命令动作
x删除字符
dd删除行
D删除到行尾
cc修改行
C修改到行尾
yy/Y复制行
p光标后粘贴
P光标前粘贴
.重复上次修改

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

命令动作
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 键)
  • 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)。

相关资源