首页 › tutorials › 斜杠命令与快捷键速查手册

Claude Code 斜杠命令与快捷键速查手册

概述

本教程面向第一次打开 Claude Code 终端、面对一个空白输入框不知道从哪下手的零基础用户。学完之后你将能够：熟练使用键盘在对话中导航、回溯、切换模式；准确记住并调用 20+ 个高频内置斜杠命令；用三分钟把一个重复输入的提示词封装成 /自己的命令。本文不涉及插件开发，只解决"如何把界面用顺"这件最基础却最被忽略的事。适用人群：刚装好 Claude Code、能跑通但效率低下的工程师、学生、运维与脚本爱好者。

前置条件

已完成 Claude Code 安装并能进入交互式界面（输入 claude 后出现提示符）。
一个可被打开的项目目录（空目录也行）。
终端环境：macOS Terminal / iTerm2、Linux 终端、或 Windows Terminal + WSL 任一即可。
建议先执行一次 /terminal-setup，以便启用 Shift+Enter 多行输入（下文详述）。

一、先看清界面的三种输入方式

很多新手把 Claude Code 当成"只能打字聊天"的对话框，其实它的输入框同时接受三种语法，分清这三者是后续一切效率的基础。

输入方式	语法	作用	何时用
自然语言	直接打字	把请求交给模型推理	描述需求、提开放问题
文件引用	`@路径`	把文件/目录内容注入上下文	指定要读的源码或文档
斜杠命令	`/命令`	触发内置或自定义的确定动作	清空上下文、切换模型、跑脚本

预期结果：在输入框键入 / 会立即弹出一个可搜索的命令菜单；键入 @ 会弹出当前目录的文件选择器。这两个符号是 Claude Code 交互的"两个魔法字符"，记住它们就掌握了界面的一半。

常见问题：输入 / 没有弹出菜单？通常是版本过旧，用 claude update 升级后再试。

二、核心快捷键：从"只会按回车"到"双手不离键盘"

快捷键是入门用户提升最快的一环。下面按使用频率从高到低分组，第一组每天会用几十次。

2.1 输入与导航（每天用几十次）

按键	动作
`Enter`	发送消息
`\` + `Enter`	换行但不发送（写多行提示词）
`Shift+Tab`	循环切换模式：普通 → 自动接受 → 计划模式
`Ctrl+R`	搜索历史命令
`Ctrl+G`	打开外部编辑器撰写长提示词

💡 Shift+Enter 在某些终端默认不生效。首次使用请运行 /terminal-setup，它会为 iTerm2、VS Code 集成终端等写入正确的转义序列，配置后即可用 Shift+Enter 软换行。

2.2 中断与回溯（出错时救命）

这一组是新手最容易忽略、却最能在关键时刻救场的组合。

按键	动作
`Esc`	中断当前生成（软停）
`Esc Esc`	打开回退菜单，可回到对话或代码的任意历史点
`Ctrl+C`	取消当前操作（硬停）
`Ctrl+D`	退出 Claude Code

关键概念——Esc Esc 的回退菜单：这是 Claude Code 区别于普通聊天工具的杀手锏。当模型改坏了一个文件、或你发现对话走到错误方向时，连按两次 Esc 会弹出一张"时间线"，你不仅能撤回某轮对话，还能把代码改动一并回滚到那个时点。对新手而言，这意味着你可以放心让 Claude 大胆改代码——因为随时能回退。

预期结果：让模型跑一个会改多个文件的任务，中途连按 Esc Esc，你会看到带时间戳的列表，选中某项后工作区恢复到该状态。

常见问题：Ctrl+C 和 Esc 有何区别？Esc 是"温柔打断"，告诉模型停下手并保留已完成部分；Ctrl+C 是"强制取消"，可能中断到一半的操作。日常优先用 Esc。

2.3 模式切换（`Shift+Tab` 的三态）

Shift+Tab 在三种模式间循环，理解这三种模式是"安全使用 Claude Code"的核心：

flowchart LR
    A["普通模式<br/>改动需逐个确认"] -->|Shift+Tab| B["自动接受模式<br/>自动应用编辑"]
    B -->|Shift+Tab| C["计划模式<br/>只调研不改动"]
    C -->|Shift+Tab| A
    style A fill:#e8f4ff,stroke:#2b7fff
    style B fill:#fff4e8,stroke:#ff8c2b
    style C fill:#f0e8ff,stroke:#7b2bff

普通模式：每次写文件、跑命令前都会征求你确认。新手默认用这个最安全。
自动接受模式：自动应用所有编辑，不再逐个确认。适合你信任的、范围明确的小改动。
计划模式：只读不写，模型先调研并给出方案，等你批准再动手。适合复杂任务开干前的"先想清楚"。

建议：零基础阶段请坚持留在普通模式，等你熟悉权限系统后再尝试自动接受模式。

三、内置斜杠命令：按场景分类的速查表

内置命令数量会随版本增长，下面按"会话控制—配置—开发—高级"四类列出新手最该先记住的子集。

3.1 会话控制（管上下文与成本）

命令	动作
`/clear`	清空对话历史，全新开始
`/compact [提示]`	压缩上下文以节省 token，可加提示告诉它"保留什么"
`/rewind`	回退对话和/或代码改动（等价于 `Esc Esc` 的菜单入口）
`/cost`	显示本次会话的花费与 token 用量
`/usage`	显示套餐用量与速率限制
`/context`	可视化当前 token 占用情况

💡 新手最常犯的错：一个对话开到底，几十轮后上下文爆炸、回答质量下降。养成习惯——每完成一个独立任务就 /clear 一次，或用 /compact 把历史压成摘要再继续。

3.2 配置（一次设好受益终身）

命令	动作
`/config`	打开设置面板
`/model`	在 Sonnet / Opus / Haiku 间切换
`/permissions`	查看与更新工具权限
`/keybindings`	打开快捷键配置文件，自定义所有键位
`/vim`	切换输入的 vim 模式
`/terminal-setup`	配置 `Shift+Enter` 多行输入

模型选择入门建议：日常编码用 Sonnet（快且便宜），遇到难 bug、架构设计用 Opus（最强），简单机械任务用 Haiku（最省）。用 /model 随时切，不必全局固定。

3.3 开发（和代码直接打交道）

命令	动作
`/init`	为项目生成 `CLAUDE.md` —— 新项目第一件事
`/memory`	查看与编辑项目记忆文件
`/review`	对当前改动做代码审查
`/doctor`	环境诊断与健康检查
`/agents`	管理子代理
`/mcp`	管理 MCP 服务器

💡 进入任何新仓库，第一步先 /init。它会扫描项目并生成 CLAUDE.md，让 Claude 之后每次都"读懂"你的项目约定（构建命令、代码风格、目录结构）。这是一次性投入、长期受益的动作。

3.4 高级（用到再说）

命令	动作
`/insights`	生成 HTML 使用报告
`/pr_comments`	拉取 GitHub PR 评论作为上下文
`/install-github-app`	安装自动化 PR 审查
`/tasks`	持久化任务清单管理
`/export [文件]`	把对话导出到文件或剪贴板

四、动手做：创建你的第一个自定义斜杠命令

内置命令解决通用需求，自定义命令解决"你个人反复打的提示词"。这是入门阶段性价比最高的定制动作——一个 markdown 文件就是一个命令。

步骤 1：决定放哪里

命令文件的位置决定它的作用域：

.claude/commands/        # 项目级命令——提交到 git，全团队共享
~/.claude/commands/      # 个人命令——跟随你跨项目，不进 git

步骤 2：建一个项目级命令

在项目根目录执行：

mkdir -p .claude/commands
cat > .claude/commands/review.md <<'EOF'
审查当前已暂存的改动，重点检查：bug、缺失的错误处理、安全隐患。
按严重程度（高/中/低）给发现排序，每条给出文件名与行号。
EOF

预期结果：在 Claude Code 会话里输入 /review，文件内容会作为提示词被发送，模型即按你的要求审查暂存改动。机制就这么简单——文件即提示词。

步骤 3：加参数让它变灵活

静态命令只能干一件事。用 $ARGUMENTS 占位符，命令就能接收你跟在后面输入的内容：

查看本仓库的 GitHub issue #$ARGUMENTS。
找到相关代码，解释可能的成因，并在新分支上提出修复方案。

把它存为 .claude/commands/fix-issue.md，之后输入 /fix-issue 482，482 就会被代入提示词。一个命令，任意 issue 号——这正是把"固定片段"升级成"小工具"的关键。

⚠️ $ARGUMENTS 的确切语法（包括是否支持多个位置参数）可能随版本变化，构建依赖它的命令前请用 /help 或官方文档确认当前写法。

步骤 4：用子目录分组（命令变多后）

命令超过五六个就该分组。子目录会成为命令的命名空间：

.claude/commands/
  git/
    review.md      ->  /git:review
    pr-desc.md     ->  /git:pr-desc
  docs/
    update.md      ->  /docs:update

按领域分组——git、docs、testing、deploy——让斜杠菜单在命令变多时仍可读。

五、边界判断：什么时候用命令、Skill 还是直接打字

这是入门用户最容易混淆的一点：命令、Skill、MCP 都"执行指令"，区别在于由谁决定何时执行。

flowchart TD
    Q["我有一个重复的需求"] --> Q1{"我想主动触发<br/>还是自动应用？"}
    Q1 -->|"主动触发"| C["斜杠命令<br/>/name，每次手敲"]
    Q1 -->|"自动应用"| Q2{"是行为约定<br/>还是接外部数据？"}
    Q2 -->|"行为约定"| S["Skill<br/>任务匹配时自动启用"]
    Q2 -->|"接外部数据/工具"| M["MCP<br/>模型按需调用工具"]
    style C fill:#e8f4ff,stroke:#2b7fff
    style S fill:#fff4e8,stroke:#ff8c2b
    style M fill:#f0e8ff,stroke:#7b2bff

形态	触发方	典型场景
斜杠命令	你手动输入	`/deploy-checklist` 走发布清单——你想在"某个时刻"主动跑
Skill	模型自动匹配	"提交信息永远用我们的格式"——希望 Claude 每次都遵守，不必提醒
MCP 工具	模型按需调用	查数据库、调外部 API——需要连入 Claude 没有的外部能力
直接打字	你即兴	一次性需求，不复用

一句话记忆：想要"显式控制"用命令；想要"自动行为"用 Skill；想要"接外部世界"用 MCP。

六、实战案例：给一个真实项目装上"命令工具箱"

假设你接手了一个 Node.js 后端项目，目标是十分钟内配好一套团队共享的命令。

1. 初始化项目记忆

进入项目目录，启动 claude，输入：

/init

确认生成的 CLAUDE.md 包含构建命令（如 npm test）、目录约定、代码风格。

2. 建立团队命令目录

mkdir -p .claude/commands/{git,docs,test}

3. 写四个核心命令

.claude/commands/git/commit.md：

为当前已暂存的改动写 git 提交信息。
使用 Conventional Commits：type(scope): subject。
祈使语气，subject 不超过 72 字符，结尾不加句号。
仅在改动需要背景时才加简短 body。

.claude/commands/git/pr-desc.md：

基于当前分支相对主分支的全部改动，起草一份 PR 描述。
包含：改动摘要、动机、测试方式、需要 reviewer 重点看的地方。

.claude/commands/test/for-file.md：

为文件 $ARGUMENTS 按本项目的测试约定编写单元测试。
优先复用现有测试工具与 mock 方式，不要引入新依赖。

.claude/commands/docs/explain.md：

向一位刚入职的新人解释 $ARGUMENTS 这个文件/模块。
先讲它在整体架构中的位置，再讲关键函数，最后给出三个常见修改场景。

4. 把目录提交进 git

git add .claude/commands
git commit -m "chore: add shared Claude Code slash commands"

预期结果：之后任何团队成员 clone 该仓库并启动 Claude Code，输入 / 就能看到 /git:commit、/git:pr-desc、/test:for-file、/docs:explain 这套命令。代码审查、写提交、写测试、写文档四件高频琐事，各被压缩成一次按键。

验收检查：输入 /git:commit 应直接产出符合 Conventional Commits 的信息；输入 /test:for-file src/auth.ts 应生成遵循项目约定的测试。若命令没出现在菜单里，检查文件是否真的在 .claude/commands/ 下、扩展名是否为 .md。

七、安全提醒：命令是提示词，不是沙箱

最后一个新手必须知道的真相：斜杠命令本质是一段提示词，它可以让 Claude 跑命令、改文件、甚至 push 代码（只要当前会话权限允许）。因此：

分享给团队的项目级命令，请在 PR 中像审查代码一样审查命令文件内容。
不要把会执行破坏性操作（如 rm -rf、强制推送）的指令写进共享命令而不加确认。
个人命令放 ~/.claude/commands/，不要混进会被提交的项目目录。

记住这条原则：写一条命令，等同于你以后每次亲手输入那段指令——所以请只把你会亲自敲的东西固化成命令。

工作流程总览

flowchart TD
    Start["启动 claude 进入项目"] --> Init["/init 生成 CLAUDE.md"]
    Init --> Setup["/terminal-setup 启用 Shift+Enter"]
    Setup --> Work["日常编码"]
    Work --> Daily{"高频操作？"}
    Daily -->|"是"| Custom["封装成 .claude/commands/命令"]
    Daily -->|"偶发"| Type["直接打字或 @引用"]
    Work --> Long{"上下文变长？"}
    Long -->|"是"| Compact["/compact 或 /clear"]
    Long -->|"否"| Cost["/cost 监控花费"]
    Custom --> Work
    Compact --> Work
    Cost --> Work
    Work --> Oops{"改坏了？"}
    Oops -->|"Esc Esc"| Rewind["回退到任意时点"]
    Rewind --> Work
    style Init fill:#e8f4ff,stroke:#2b7fff
    style Custom fill:#fff4e8,stroke:#ff8c2b
    style Rewind fill:#ffe8e8,stroke:#ff2b2b

训练营适用性评估

适合训练营类型：Claude Code / AI 编程工具入门营、企业研发效能提升营、终端工具链扫盲营。零基础友好，全程不需要写任何复杂代码。
预计教学时长：讲授 45 分钟 + 动手实操 30 分钟。前 30 分钟讲界面与快捷键，后 45 分钟带学员现场建一套团队命令工具箱。
考核方式：每位学员在指定仓库中提交 .claude/commands/ 下至少 3 条可运行命令，并通过 /命令 实际触发验收。
前置依赖：仅要求学员能进入 Claude Code 交互界面，无其他前置课程。

参考来源

Claude Code Cheat Sheet (GitHub Gist, mhmzdev) — 社区维护的 2026 版速查表，聚合快捷键、斜杠命令与 CLI 标志。
Interactive mode — Claude Code Docs — 官方交互模式文档，键盘快捷键与输入模式的权威定义。
Slash Commands in the SDK — Claude Code Docs — 官方斜杠命令机制说明，含 $ARGUMENTS 语法。
How to Create Custom Slash Commands in Claude Code — MCSA Guru — 自定义命令的文件位置、命名空间、命令与 Skill 边界的实操指南。
Claude Code Keyboard Shortcuts: Complete Reference — explainx.ai — 2026 年快捷键完整参考，表格优先、便于速查。

[!tip] 51学通信知识星球 星主：爱卫生（微信：gprshome201101）——公众号「51学通信」创办者，19 年通信行业运维与讲师经验，著有《GPRS网络信令实例详解》《EPC原理与实践》《5G核心网原理与实践》三本纸质书（各大电商平台有售）。 星球定位：深耕 5G 核心网、IMS、NFV/AI、云原生等 ICT 领域，主打运维岗位与信令分析。 当前规模：5200 篇主题 / 990 个回答，198 元/年。 加入福利：加入星球后请加爱卫生微信，拉您进知识星球年度陪伴与答疑群——不限量回复您的各种问题，另有群内分享。 AI 加持：51学通信知识星球已作为 skill 接入 WorkBuddy，使用 deepseek-4-flash 在海量星球帖子中精准找贴、找视频、找 FAQ 和案例，做总结、找文档和 PPT 等场景全覆盖。

51学通信知识星球海报-扫码加入