交互模式

​

快捷键

​

常规控制

​

文本编辑

​

编辑快捷键中的单词边界

​

主题和显示

​

多行输入

​

快速命令

​

记录查看器

​

语音输入

​

命令

​

在提示中途完成命令

• 在 fullscreen rendering 中：匹配项在您输入时以列表形式打开，没有突出显示的行，因此 Enter 仍会按输入的方式发送您的提示。按 Tab 插入顶部匹配项，或使用箭头键和 Enter 选择一行。
• 在 fullscreen 之外：顶部匹配项的其余部分在您的光标处显示为幽灵文本，当有更多命令匹配时显示 +2 之类的计数。按 Tab 插入唯一的匹配项，或在有多个匹配项时打开列表，然后使用箭头键和 Enter 选择一行。

​

Vim 编辑器模式

​

模式切换

​

重新映射 INSERT 模式快捷键序列

{
  "editorMode": "vim",
  "vimInsertModeRemaps": { "jj": "<Esc>" }
}

​

导航（NORMAL 模式）

​

编辑（NORMAL 模式）

​

文本对象（NORMAL 模式）

​

可视模式

​

命令历史

• 输入历史按工作目录存储
• 运行 /clear 开始新会话：回调时会首先列出新会话的提示词，然后是较早会话的提示词。前一个会话的对话被保留，可以恢复。
• 连续两次提交相同的提示词只记录一个历史条目，因此按上箭头会跳到前一个不同的提示词
• 当你回调包含粘贴文本的提示词时，Claude Code 在你重新提交时会再次发送完整的粘贴内容。如果内容已被自动清理，Claude Code 不会发送字面上的 [Pasted text #N] 字符串；有关提示词发生的情况，请参阅粘贴大型内容
• 使用 ! 的历史扩展默认被禁用

​

使用 Ctrl+R 进行反向搜索

1. 开始搜索：按 Ctrl+R 激活反向历史搜索
2. 输入查询：输入要在以前的命令中搜索的文本。搜索词在匹配结果中突出显示
3. 导航匹配项：再次按 Ctrl+R 循环浏览较早的匹配项
4. 搜索范围：内联搜索始终搜索来自所有项目的提示词
5. 接受匹配项：
   • 按 Tab 或 Esc 接受当前匹配项并继续编辑
   • 按 Enter 接受并立即执行命令
6. 取消搜索：
   • 按 Ctrl+C 取消并恢复你的原始输入
   • 在空搜索上按 Backspace 取消

​

后台 Bash 命令

​

后台运行的工作原理

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

• 输出被写入文件，Claude 可以使用 Read 工具检索它
• 后台任务有唯一的 ID 用于跟踪和输出检索
• 当 Claude Code 退出时，后台任务会自动清理。在 macOS 和 Linux 上，当你从 /tasks 停止后台任务或 Claude Code 在退出时停止它时，从任务的 shell 分离的进程（例如在 setsid 或 timeout 下启动的进程）也会停止
• 如果你将会话放在后台而不是退出，你的后台任务将继续在后台会话中运行。请参阅将运行中的会话放在后台
• 如果输出超过 5GB，后台任务会自动终止，stderr 中会有说明原因的注释
• 在 macOS 和 Linux 上，当操作系统报告严重内存压力时，Claude Code 会停止运行中的后台任务，前提是会话已空闲至少 30 分钟且没有轮次或子代理正在运行
  • 调试日志说明了为什么任务被停止，或为什么压力事件让它们继续运行
  • 将 CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP 设置为 1 可关闭内存压力停止
• 在您通过终端、桌面应用或 VS Code 扩展进行工作的本地会话中，后台命令没有时间限制。在无人值守运行的会话中（例如 -p 运行或云端会话），Claude Code 会在后台命令达到其时间限制时停止它
• 由前台子代理启动的后台命令在该子代理的运行结束时结束，无论是完成、失败还是被中断；请参阅工具参考中的后台命令何时停止

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

​

使用 ! 前缀的 Shell 模式

! npm test
! git status
! ls -la

• 将命令及其输出添加到对话上下文
• 显示实时进度和输出
• 支持相同的 Ctrl+B 后台运行，用于长时间运行的命令
• 不需要 Claude 解释或批准命令
• 支持基于历史的自动完成：输入部分命令并按 Tab 从当前项目中的前面 ! 命令完成
• 支持实时文件路径自动完成：输入包含正斜杠的 token，例如 ./src/ 或 ~/，查看匹配文件和目录的下拉列表，然后按 Tab 接受。在 Windows 上也使用正斜杠；下拉列表由 / 触发，而不是 \
• 在空提示上按 Escape、Backspace 或 Ctrl+U 退出
• 将以 ! 开头的文本粘贴到空提示中会自动进入 shell 模式，与输入的 ! 行为匹配

​

在 Claude 工作时排队消息

​

Claude Code 何时发送您排队的内容

• 消息：如果您在 Claude 运行工具调用时排队消息，Claude Code 会在这些工具调用完成后立即将其传递给 Claude，在同一轮次内。当轮次以仍有排队消息结束时，它们会在没有另一次按键的情况下按您输入的顺序发出
• 命令和 shell 命令：Claude Code 将其保留到轮次结束，然后逐个运行它们，保持您排队的顺序

• 运行 shell 命令、子代理或其他可以移到后台的工作：该工作移到后台并继续运行，Claude 在同一轮次中读取您的消息
• 仅撰写回复，或运行无法移到后台的内容：Claude Code 中断轮次并接下来发送您的消息。在 v2.1.281 之前，该快捷键在两种情况下都中断轮次

• /model：一旦您确认缓存警告（如果 Claude Code 显示），Claude Code 会将您的更改应用于该轮次中它发出的下一个请求
• /effort：一旦您确认缓存警告（如果 Claude Code 显示），Claude Code 会将您的更改应用于该轮次中它发出的下一个请求
• /fast：Claude Code 保持轮次开始时活跃的快速模式设置，因此您的速度更改从您的下一轮次应用。如果您当前的模型不支持快速模式，打开它也会切换您的模型，Claude Code 会在该轮次中从其下一个请求使用新模型

​

取回您排队的内容

​

提示建议

• 按 Tab 或 Right arrow 将建议放入提示输入框，然后按 Enter 提交
• 开始输入以关闭它

​

当 Claude Code 跳过建议时

• 提示缓存为冷状态，以避免不必要的成本
• 在对话的第一轮之后，在某些会话中
• 前一个响应以错误结束
• 当你处于 Plan Mode 时
• 你的账户接近或已达到使用限制。要在达到限制之前保持建议开启，请将 CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION 设置为 true。在 v2.1.238 之前，Claude Code 即使将变量设置为 true 也会在接近限制时跳过建议
• 在代理团队中，默认情况下在队友的会话中。主导的会话显示建议

​

关闭提示建议

• 在 /config 中关闭 Prompt suggestions
• 在你的设置文件中将 promptSuggestionEnabled 设置为 false
• 将 CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION 环境变量设置为 false，它优先于设置：
  export CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION=false
  

​

You should know 建议

✦ Heads up · There was a change to how folder sharing starts in June, which may have bumped usage metrics artificially.
  1: Learn more   2: Knew this already   0: Dismiss

• 不获取该 mod 所依赖的功能标志的会话，例如设置了 DISABLE_TELEMETRY 的会话
• 功能标志尚未送达的安装或升级后的首个会话

/plugin enable cc-plugin-you-should-know@builtin

​

检查的成本

​

响应提示

• Learn more：在提示下方打开一段简短说明，该说明有自己的选项：
  • Understood：关闭说明并将该主题标记为已知
  • Chat in main session：将提示引用到您的提示词输入框中，以便您添加问题并发送给 Claude
  • Dismiss：关闭说明，但不将该主题标记为已知
• Knew this already：关闭提示并将该主题标记为已知。
• Dismiss：关闭提示。

​

关闭 You should know

• 在 Claude Code 提示符处运行 /plugin disable cc-plugin-you-should-know@builtin，或在 /plugin 的 Installed 标签页中将其关闭
• 在未先打开 Learn more 的情况下对提示选择 Dismiss 后，在 Dismissed. 行上选择 Turn off suggestions，该行会在 20 秒后消失

​

表情符号速记代码

• 输入完整的速记代码，例如 :heart:，Claude Code 会在您输入结束的 : 时立即将其替换为 ❤️
• 输入 : 加上名称的至少两个字符，例如 :hea，打开建议弹出窗口，然后按 Tab 或 Enter 插入突出显示的表情符号

​

在输入时检查拼写

​

前置条件

• 安装 aspell、hunspell 或 ispell，并确保它在您的 PATH 中。Claude Code 在每个平台上运行它找到的前三个中的第一个，包括包管理器在 Windows 上安装的 .cmd shim。
• 要检查程序是否在您的 PATH 中，请在您的终端中运行 aspell --version、hunspell --version 或 ispell -v。“command not found” 错误意味着它还不在您的 PATH 中。

​

打开或关闭拼写检查

{
  "spellcheck": { "enabled": true }
}

{
  "spellcheck": { "enabled": true }
}

claude --settings spellcheck.json

{
  "spellcheck": { "enabled": true }
}

• checker：aspell、hunspell 或 ispell。Claude Code 不会从您命名的检查器回退，并将任何其他值视为 auto。
• language：您的检查器形式中的字典名称，例如 en_GB。Claude Code 忽略任何不是纯字典名称的值，例如路径或包含空格的名称，检查器使用其默认字典。
• color：颜色名称，例如 yellow，或 #rrggbb、#rgb、rgb(r,g,b)、ansi256(n) 或 ansi:<name> 值。Claude Code 默认使用您的主题的错误颜色，对于任何它不识别的值也是如此。

{
  "spellcheck": {
    "enabled": true,
    "checker": "hunspell",
    "language": "en_GB",
    "color": "yellow"
  }
}

​

Claude Code 加下划线的内容

• 命令，例如 /help、@ 提及、URL、文件路径和标志，例如 --verbose
• 包含数字、下划线或第一个字母后的大写字母的单词，以及反引号中的文本

​

当 Claude Code 不加下划线时

• 未安装检查器，或您在 checker 中命名的检查器丢失
• 检查器连续失败两次，在启动时或会话中稍后。Claude Code 在第一次失败后重新启动它，在第二次失败后停止检查，直到您重新启动 Claude Code
• 检查器需要超过 15 秒来回答，三次。每次，Claude Code 都会将它等待的单词保持未标记；在第三次之后，它停止检查，直到您重新启动 Claude Code

​

提示词中的隐形字符

​

使用 /diff 查看更改

• 全屏渲染：diff 面板会在对话旁边打开。该面板保持打开状态，并在您继续工作时更新。
• 经典渲染器：diff 对话框会在输入框上方打开，您阅读完后可以关闭它。

​

Diff panel

• 全屏渲染
• 一个 git 仓库
• 至少 110 列宽的终端
• Claude Code v2.1.287 或更高版本

• 跳转到文件：单击列表中的其行。使用鼠标滚轮滚动面板。当文件列表本身太长无法容纳时，使用 Alt+Up 和 Alt+Down 或 Ctrl+Up 和 Ctrl+Down 滚动它。
• 询问 Claude 关于某个文件的更改：单击文件 diff 上方文件名右侧的 ask。Claude Code 会将该文件的 diff 附加到您的下一个提示词，在您发送该提示词之前，按钮会显示为 asked ✓。对第二个文件进行询问会替换第一个。
• 显示某个轮次的编辑：单击面板标题中的 source 选择器，然后使用 Up 和 Down 选择一个轮次并按 Enter。轮次标记为 T1、T2 等。该选择器在 Claude 编辑文件后出现，选择 Current 可返回工作树。
• 显示面板遗漏的文件：列表跳过测试文件和生成的文件，并将此会话之前的更改折叠为底部的一行。单击任一计数行以展开它。
• 更改面板比较的内容：按 Ctrl+X B 在此会话的更改、您的未提交更改作为一个列表，以及自您的分支从默认分支分离以来的所有内容之间循环。Claude Code 为每个仓库记住该选择。

​

Diff dialog

• 上和下：选择一个文件。
• Enter：打开所选文件的 diff。使用上和下或 PageUp 和 PageDown 滚动它。
• Esc：从文件的 diff 返回到列表，或从列表关闭对话框。
• Tab：移动到 source 选择器，然后使用上和下选择 Current 或某个轮次视图并按 Enter。在文件的 diff 中，Tab 会移动到 ask 按钮。按 Enter 可将该文件的 diff 附加到您的下一个提示词。

​

使用 /btw 提出附加问题

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

• Claude 工作时可用：即使 Claude 正在处理响应，你也可以运行 /btw。附加问题独立运行，不会中断主要回合。它可以看到到目前为止对话中的所有内容，除了 Claude 仍在编写的回复。
• 无工具访问：附加问题仅从上下文中已有的内容回答。Claude 在回答附加问题时无法读取文件、运行命令或搜索。如果 Claude 无论如何都将工具调用写成文本，答案会以一条注释结尾，说明没有执行任何操作。
• 单一响应：覆盖层中没有后续回合。要继续线程，请提出另一个 /btw 问题。要在本地会话中继续使用完整的工具访问，按 f 将此问题和答案分叉到 后台子代理。
• 低成本：当对话的 prompt cache 预热时，附加问题的成本仅略高于答案本身。

​

任务列表

• 按 Ctrl+T 切换任务列表视图。显示一次最多显示五个任务。当 Claude 尚未创建任何清单项目时，切换没有可见效果，因为没有要显示的内容
• 如果您保持列表展开，Claude Code 会在下次启动仍有任务的会话时恢复展开视图，例如使用 --resume 或 --continue。当任务列表为空时，Claude Code 会将其启动为折叠状态
• 要查看所有任务或清除它们，直接询问 Claude：“show me all tasks”（显示所有任务）或 “clear all tasks”（清除所有任务）
• 任务在上下文压缩中保持，帮助 Claude 在较大的项目中保持组织
• 要在会话间共享任务列表，设置 CLAUDE_CODE_TASK_LIST_ID 以使用 ~/.claude/tasks/ 中的命名目录：CLAUDE_CODE_TASK_LIST_ID=my-project claude

​

会话回顾

​

等待使用限制重置

Usage limit reached · limit resets 3:45pm
Continuing automatically at 3:45pm · esc to cancel

• 在重置时：第二行变为 Continuing shortly · esc to cancel。然后对话中出现 Usage limit reset · continuing automatically，Claude Code 提示 Claude 从停止的地方继续任务。它不会重新发送您的最后一条消息。
• 计算机睡眠后：如果睡眠超过约 30 分钟，并且限制在睡眠期间重置，第一行显示 Your usage limit has reset，第二行显示 Press enter to continue。按 Enter 继续。如果睡眠时间较短，或睡眠在重置之前结束，Claude Code 会自动继续。
• 提前：当您使用 /usage-credits 完成添加 使用额度、在 /upgrade 后重新登录或在等待期间使用 /model 切换模型时，Claude Code 会检查使用情况是否再次可用，如果可用则立即继续。它不会在您在浏览器中自行进行的升级或购买后进行检查。在 opusplan 和其他在不同模型上运行计划模式的模型设置下，Claude Code 会等待重置。

​

取消等待

• 您发送提示词：Claude Code 发送您的提示词而不是等待。如果您的提示词也达到了限制，它会保留在对话中，并且 Claude Code 会重新开始等待。
• 您退出 Claude Code：当您恢复会话时，等待不会重新启动。
• 对话转手：您使用 /login 切换账户、清除或倒带对话、/resume 另一个会话、使用 /teleport 拉取一个会话、使用 /tui 重新启动，或将会话交给 Claude Desktop、后台会话或云端。
• 设置关闭，或重置超过 24 小时：这仅结束 Claude Code 自动启动的等待。您从 /rate-limit-options 中选择的等待会继续倒计时。
• 继续被阻止：一个阻止继续提示的 UserPromptSubmit hook，或在到达模型之前的失败，会结束等待。Claude Code 会告诉您继续没有运行。发送提示以继续。

​

自己启动等待

• Remote Control 和 agent team 队友会话：该终端的人员仍然可以启动一个。
• 重置超过 24 小时：每周限制可能在几天后重置。
• 您运行该系列之外的模型时的 Opus 或 Sonnet 限制：您的下一轮可能不会达到该限制。opusplan 和其他在受限系列上运行计划模式的模型设置不会获得此例外。

• 后台会话和 -p 运行：菜单行不可用。
• API 密钥、云提供商和基于使用情况的计费：那里的使用情况按请求计量，因此没有重置可等待。
• 没有保存的 claude.ai 登录的 LLM gateway：Claude Code 仅在保存的 claude.ai 登录是活跃凭证时才提供等待。

​

关闭自动继续

​

PR 审查状态

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

​

GitLab 合并请求

• 绿色：GitLab 报告合并请求可合并
• 黄色：任何其他开放状态
• 灰色：草稿

• Claude Code v2.1.234 或更高版本
• 指向您的 GitLab 主机的仓库远程，可以是 gitlab.com 或自管理实例
• 您的 PATH 中的 glab CLI，使用 glab auth login 进行身份验证

​

问题参考链接

• 单独的 #123
• 嵌套的 GitLab 路径，例如 group/subgroup/project#123
• 代码跨度或代码块内的任何参考
• 长度超过约 1,000 行或 100,000 个字符的回复中的任何参考

​

另请参阅

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