Claude Code 快捷指令 · 键盘快捷键 · 命令速查手册
适用对象：刚开始用 Claude Code 或已经会用但总感觉"忘了那个什么键"的人。内容综合自 Anthropic 官方速查表和交互模式参考文档，不同终端/平台可能有微小差异——在会话中按 ?可看你本机精确列表。
一、先搞懂 Claude Code 的"三套指令体系"
| 类型 | 在哪执行 | 典型例子 |
|---|
| CLI 启动命令 | 系统终端（Bash/PowerShell/终端模拟器） | claude、claude -p "…"、claude -c |
斜杠命令 / | Claude Code 交互会话内（REPL） | /clear、/compact、/plan、/cost |
| 键盘快捷键 | 会话进行中随时可用 | Esc、Ctrl+C、Shift+Tab、Ctrl+R |
记住这个分层，就不会出现"我该在哪敲？"的困惑。
二、键盘快捷键速查（Interactive 交互模式）
1）会话控制 / 中断 / 退出
| 快捷键 | 作用 | 备注 |
|---|
| Esc | 中断 Claude 当前回复/工具调用，把控制权交还给你（已完成的部分仍保留） | "啊不对停一下" |
| Esc Esc | 输入区有文字→清掉并存入历史；输入区为空→打开 rewind/checkpoint 菜单，回滚代码+对话到更早节点 | 相当于救命键 |
| Ctrl+C | 中断当前操作；若没在跑东西→第一次清输入，第二次退出 | 比你想的更常用 |
| Ctrl+D | 退出 Claude Code（EOF 信号） | 或直接输 /exit |
| Ctrl+L | 重绘屏幕（清屏但不丢历史） | 界面乱了就按它 |
| Ctrl+X Ctrl+K | 终止所有后台 subagent（3 秒内按两次确认） | 猛药 |
2）历史搜索 / 导航
| 快捷键 | 作用 |
|---|
| Ctrl+R | 反向搜索提示词历史（类似 shell 的 reverse search） |
| ↑ / ↓ | 逐条翻历史命令（在多行输入边缘时先移动光标，到顶/底才翻历史） |
3）模式切换（非常重要）
| 快捷键 | 作用 |
|---|
| Shift+Tab（某些配置也可用 Alt+M） | 循环权限/工作模式：default（每步需确认）→ acceptEdits（自动批注文件编辑）→ plan（只读规划，不写不改）→ … 如果你开了 bypassPermissions也会纳入循环 |
左下角通常会显示当前模式指示：Default / Accept Edits / Plan Mode。
补两个"模型与思考"切换（平台/配置允许时）：
- Option+P / Alt+P：切换模型（不清除当前输入）
- Option+T / Alt+T：开关 Extended Thinking
- Option+O / Alt+O：开关 Fast Mode（v2.1.132+ macOS 有时不必配 Option-as-Meta）
macOS 注意：Alt/Option组合键很多终端需要把 Option 设为 Meta：iTerm2 → Keys → Left/Right Option → Esc+；VS Code → "terminal.integrated.macOptionIsMeta": true。
4）输出/任务/后台
| 快捷键 | 作用 |
|---|
| Ctrl+O | 切换详细 transcript 视图（看工具调用/执行细节） |
| Ctrl+T | 显示/隐藏任务列表面板 |
| Ctrl+B | 把正在跑的任务（bash / agent）丢到后台（tmux 用户可能需要按两次） |
| Ctrl+G / Ctrl+X Ctrl+E | 用默认外部编辑器打开当前输入（适合写长 prompt；Ctrl+X Ctrl+E是 readline 原生绑定） |
5）粘贴图片（UI 调试神技）
| 快捷键 | 条件 |
|---|
| Ctrl+V（某些终端）/ Cmd+V（iTerm2）/ Alt+V（Windows） | 把剪贴板里的截图当 [Image #N]注入 prompt |
6）输入区内的"行编辑"快捷键（类 Bash/readline）
| 快捷键 | 作用 |
|---|
| Ctrl+A / Ctrl+E | 跳到行首 / 行尾 |
| Ctrl+K | 删到行尾（可粘贴回来） |
| Ctrl+U | 删到行首（可粘贴回来） |
| Ctrl+W | 删前一个词 |
| Ctrl+Y | 粘贴刚删的文本 |
| Alt+B / Alt+F（需 Option=Meta） | 按词后退 / 前进 |
7）多行输入怎么换行（不发送）
| 方法 | 适用 |
|---|
| ``+ Enter | 几乎所有终端通用（转义换行） |
| Option+Enter | macOS 默认 |
| Shift+Enter | iTerm2 / WezTerm / Ghostty / Kitty 直接可用；其它（VS Code / Alacritty / Zed / Warp）先跑一次 /terminal-setup启用 |
8）输入框里的"快捷前缀语法"
| 前缀 | 含义 |
|---|
/ | 斜杠命令（输 /还会触发命令菜单 + 字母过滤） |
!+ command | 直接跑 Bash 命令，输出自动注入上下文（比如 !git diff） |
@+ 路径 | 文件路径自动补全/引用（把文件拉进对话上下文） |
三、斜杠命令 /（交互会话内）— 工作流核心
技巧：在空行打 /就能看到完整列表，并支持按字母过滤；你/团队自己写的 Skills 也会以 /skill-name出现。
会话 & 上下文管理（最高频）
| 命令 | 作用 | 什么时候用 |
|---|
| /clear | 清对话历史、重新开始（项目记忆 CLAUDE.md 仍生效） | 切到完全不相关的任务 |
/compact [hint] | 把旧上下文压缩成摘要省 token；可加保留重点 | 对话很长但你还想继续同一件事 |
| /rewind | 对话+代码回滚到更早检查点 | AI 改歪了，你想"倒带" |
| /resume（别名 /continue） | 选一个历史会话继续 | 第二天回来接着搞 |
/export [file] | 导出当前对话（Markdown/剪贴板） | 想留档/发给同事 |
项目记忆 & 初始化
| 命令 | 作用 |
|---|
| /init | 扫描代码库生成/更新 CLAUDE.md（让 Claude 理解项目约定） |
| /memory | 查看/编辑当前作用域内的 CLAUDE.md |
/add-dir <dir> | 临时给 Claude 额外目录的读写权限 |
模型 / 费用 / 上下文可视化
| 命令 | 作用 |
|---|
| /model | 查看/切换模型 |
| /cost | 当前会话 token 用量与花销 |
| /usage | 套餐限额与速率限制状态 |
| /context | 可视化上下文窗口里"钱都花哪了"（哪些文件/信息占 token） |
配置 / 权限 / 集成
| 命令 | 作用 |
|---|
| /config（别名 /settings） | 打开配置（主题、默认项、编辑模式等） |
| /permissions | 查看/调整哪些工具需要你批准 |
| /mcp | 管理 MCP 服务器连接 |
| /hooks | 配置 hooks（工具事件触发自动化） |
| /vim | 输入区切 Vim 按键模式 |
| /terminal-setup | 配置终端多行输入（让 Shift+Enter 可用） |
开发流 / 质量
| 命令 | 作用 |
|---|
/plan [task] | 直接进入 Plan Mode（只读）→ 你审完计划再让它执行 |
| /diff | 交互式看未提交变更/每轮 diff |
| /copy | 把上次回复（或选中代码块）拷到剪贴板 |
| /simplify | 内置 skill：审最近改动（复用/质量/效率），并可应用修复 |
| /status | 账户、模型、目录、版本快照 |
| /doctor | 诊断安装与环境问题 |
| /bug（/feedback） | 带会话上下文给 Anthropic 提问题 |
| /exit（/quit） | 退出 |
还有一个越来越好用的： /btw——在不污染主线对话上下文的情况下，插一个"顺带问一句"。
四、CLI 启动命令 & 常用参数（终端里敲的）
最常用的启动姿势
claude
claude "分析当前项目的认证模块"
claude -p "这段函数为什么可能 NPE？"
claude -c
claude --resume
claude -r "auth-refactor"
值得记的 CLI 参数（scriptable / 高级控制）
| 参数 | 用途 |
|---|
| `--model sonnet | opus |
--add-dir dir1 dir2 | 额外工作目录授权 |
| `--output-format text | json |
--max-turns N | 限制非交互轮数 |
--max-budget-usd N | 单次运行预算上限 |
--permission-mode plan | 一启动就是只读规划（安全） |
--dangerously-skip-permissions | 跳过所有权限确认（高风险，一般只用于受控 CI） |
| `cat file | claude -p "…"` |
Auth / 更新 / 维护
claude update
claude auth login
claude auth status
claude
五、三条"肌肉记忆级"工作流组合（直接复制用）
A. 你刚改了一堆，想让它帮你总结风险
git diff | claude -p "总结这次改动，指出潜在 bug、破坏性变更和安全风险"
B. 先只读规划，再决定要不要让它动手
# 方式 1：启动时直接 plan 模式
claude --permission-mode plan
# 然后 /plan 细化，审核完切回 default / acceptEdits 再执行
# 方式 2：交互里 Shift+Tab 切到 Plan Mode → 聊完按 Shift+Tab 切回
C. 对话太长、token 吃紧但不想 /clear 丢掉一切
/compact 保留架构决策和关键约束
# 等价肌肉记忆：先用 /context 看谁最占，再 /compact 压
最后一句话
Claude Code 真正的效率来自 "快捷键救手 + 斜杠命令管上下文 + CLI 参数管边界" 的组合。先把 Esc、Esc Esc、Shift+Tab、Ctrl+R、/compact、/rewind、!git diff这几个练成反射，剩下的按需查表就行。
