文档索引

在此处获取完整文档索引：https://code.claude.com/docs/llms.txt 使用此文件发现所有可用页面，然后再进一步探索。

交互模式

Claude Code 会话中键盘快捷键、输入模式和交互功能的完整参考。

键盘快捷键

常规控制

文本编辑

主题和显示

多行输入

快捷命令

转录查看器

当转录查看器打开时（通过 Ctrl+O 切换），以下快捷键可用。在全屏渲染模式下，按 ? 可在查看器内显示完整的快捷键参考面板。Ctrl+E 可以通过 transcript:toggleShowAll 重新绑定。

语音输入

命令

在 Claude Code 中输入 / 可查看所有可用命令，或输入 / 后跟任何字母进行过滤。/ 菜单显示你可以调用的所有内容：内置命令、捆绑和用户编写的技能，以及由插件和 MCP 服务器提供的命令。并非所有内置命令对每个用户都可见，因为某些命令取决于你的平台或计划。

参见命令参考获取 Claude Code 中包含的完整命令列表。

Vim 编辑器模式

通过 /config → 编辑器模式启用 vim 风格编辑。

模式切换

导航（NORMAL 模式）

编辑（NORMAL 模式）

文本对象（NORMAL 模式）

文本对象与 d、c 和 y 等操作符配合使用：

可视模式

按 v 进行字符级选择或按 V 进行行级选择。移动命令扩展选择，操作符直接对其执行操作。

不支持 Ctrl+V 块级可视模式。

命令历史

Claude Code 为当前会话维护命令历史：

• 输入历史按工作目录存储
• 运行 /clear 开始新会话时输入历史会重置。之前会话的对话被保留并可恢复
• 连续两次提交相同的提示只记录一个历史条目，因此按 Up 会跳转到上一个不同的提示
• 使用上/下方向键导航（参见上面的键盘快捷键）
• 注意：历史扩展（!）默认禁用

使用 Ctrl+R 反向搜索

按 Ctrl+R 交互式搜索命令历史：

1. 开始搜索：按 Ctrl+R 激活反向历史搜索
2. 输入查询：输入要在之前命令中搜索的文本。搜索词在匹配结果中高亮显示
3. 导航匹配：再次按 Ctrl+R 循环浏览更早的匹配
4. 更改范围：搜索默认为所有项目的提示。按 Ctrl+S 在此会话、此项目和所有项目之间循环切换范围
5. 接受匹配：
   • 按 Tab 或 Esc 接受当前匹配并继续编辑
   • 按 Enter 接受并立即执行命令
6. 取消搜索：
   • 按 Ctrl+C 取消并恢复原始输入
   • 在空搜索时按 Backspace 取消

搜索显示匹配的命令，搜索词高亮显示，以便你可以找到并重用之前的输入。

后台 bash 命令

Claude Code 支持在后台运行 bash 命令，允许你在长时间运行的进程执行时继续工作。

后台工作原理

当 Claude Code 在后台运行命令时，它会异步运行命令并立即返回后台任务 ID。Claude Code 可以在命令在后台继续执行的同时响应新的提示。

要在后台运行命令，你可以：

• 提示 Claude Code 在后台运行命令
• 按 Ctrl+B 将常规 Bash 工具调用移至后台。（Tmux 用户必须按两次 Ctrl+B，因为 tmux 的前缀键。）

主要功能：

• 输出写入文件，Claude 可以使用 Read 工具检索
• 后台任务具有唯一 ID 用于跟踪和输出检索
• Claude Code 退出时自动清理后台任务
• 如果输出超过 5GB，后台任务会自动终止，并在 stderr 中说明原因

要禁用所有后台任务功能，将环境变量 CLAUDE_CODE_DISABLE_BACKGROUND_TASKS 设置为 1。详见环境变量。

常见的后台命令：

• 构建工具（webpack、vite、make）
• 包管理器（npm、yarn、pnpm）
• 测试运行器（jest、pytest）
• 开发服务器
• 长时间运行的进程（docker、terraform）

使用 ! 前缀的 Shell 模式

通过在输入前加上 ! 直接运行 shell 命令，无需通过 Claude：

! npm test
! git status
! ls -la

Shell 模式：

• 将命令及其输出添加到对话上下文
• 显示实时进度和输出
• 支持相同的 Ctrl+B 后台运行长时间命令
• 不需要 Claude 解释或批准命令
• 支持基于历史的自动补全：输入部分命令并按 Tab 从当前项目中之前的 ! 命令补全
• 在空提示时使用 Escape、Backspace 或 Ctrl+U 退出
• 将以 ! 开头的文本粘贴到空提示中会自动进入 shell 模式，与输入 ! 的行为一致

这对于在保持对话上下文的同时进行快速 shell 操作非常有用。

提示建议

首次打开会话时，提示输入中会出现一个灰色的示例命令，帮助你入门。Claude Code 从项目的 git 历史中选择此命令，因此它反映你最近一直在处理的文件。

Claude 响应后，建议会根据你的对话历史继续出现，例如多部分请求的后续步骤或工作流的自然延续。

• 按 Tab 或 右方向键 将建议放入提示输入，然后按 Enter 提交
• 开始输入以关闭建议

建议作为后台请求运行，复用父对话的提示缓存，因此额外成本很小。当缓存未命中时，Claude Code 会跳过建议生成以避免不必要的成本。

建议在对话的第一回合之后、非交互模式和计划模式下会自动跳过。

要完全禁用提示建议，设置环境变量或在 /config 中切换设置：

export CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION=false

使用 /btw 进行旁问

使用 /btw 快速询问关于当前工作的问题，而不添加到对话历史中。当你想要快速回答但不想弄乱主要上下文或使 Claude 偏离长时间运行的任务时，这很有用。

/btw what was the name of that config file again?

旁问对当前对话有完整的可见性，因此你可以询问 Claude 已经读取的代码、它之前做出的决定或会话中的任何其他内容。问题是临时的：它们出现在可关闭的覆盖层中，永远不会进入对话历史。

• Claude 工作时可用：即使 Claude 正在处理响应时，你也可以运行 /btw。旁问独立运行，不会中断主回合。
• 无工具访问：旁问仅从上下文中已有的内容回答。Claude 在回答旁问时无法读取文件、运行命令或搜索。
• 单次响应：没有后续回合。如果你需要来回交流，请改用正常提示。
• 低成本：旁问复用父对话的提示缓存，因此额外成本很小。

按 Space、Enter 或 Escape 关闭答案并返回提示。

/btw 与子代理相反：它看到你的完整对话但没有工具，而子代理拥有完整工具但从空上下文开始。使用 /btw 询问 Claude 从本次会话中已知的内容；使用子代理去发现新内容。

任务列表

在处理复杂的多步骤工作时，Claude 会创建任务列表来跟踪进度。任务显示在终端的状态区域中，带有指示器显示待处理、进行中或已完成的状态。

• 按 Ctrl+T 切换任务列表视图。显示一次最多 5 个任务
• 要查看所有任务或清除它们，直接询问 Claude："show me all tasks" 或 "clear all tasks"
• 任务在上下文压缩后持续存在，帮助 Claude 在大型项目中保持有序
• 要在会话之间共享任务列表，设置 CLAUDE_CODE_TASK_LIST_ID 以使用 ~/.claude/tasks/ 中的命名目录：CLAUDE_CODE_TASK_LIST_ID=my-project claude

会话回顾

当你离开后返回终端时，Claude Code 会显示会话中发生内容的单行回顾。回顾在后台生成，在至少三分钟过去且终端失去焦点后生成一次，因此当你切换回来时已准备好。回顾仅在会话至少有三个回合后出现，且不会连续出现两次。

运行 /recap 按需生成摘要。要关闭自动回顾，打开 /config 并禁用会话回顾。

会话回顾默认对每个计划和提供商开启。在非交互模式下始终跳过回顾。

PR 审查状态

在处理有打开的拉取请求的分支时，Claude Code 在页脚显示可点击的 PR 链接（例如"PR #446"）。链接带有彩色下划线指示审查状态：

• 绿色：已批准
• 黄色：待审查
• 红色：已请求更改
• 灰色：草稿

拉取请求合并或关闭后，徽章消失。Cmd+click（Mac）或 Ctrl+click（Windows/Linux）链接可在浏览器中打开拉取请求。状态每 60 秒刷新一次，以及在会话中运行 gh pr 或 git push 命令后立即刷新。

另请参阅

• 技能 - 自定义提示和工作流
• 检查点 - 回退 Claude 的编辑并恢复之前的状态
• CLI 参考 - 命令行标志和选项
• 设置 - 配置选项
• 内存管理 - 管理 CLAUDE.md 文件