×−+
斜杠命令第 1 课 · Claude Code 教程
第 1 课 · SLASH COMMANDS

斜杠命令:
用一个 / 指挥 Claude Code

平时你用大白话跟 Claude 提需求。但清空对话、切换模型、查看花了多少钱这类"操作",不用跟它商量:在输入框开头打一个 /,直接下指令。

约 45 分钟 11 节 · 6 个动手练习 章末测验 改编自 luongnv89/claude-howto(MIT)
点一下键帽试试
入门先用起来 原理弄懂为什么 实战动手练 深入全部命令与避坑

时间紧就先看"入门"和"实战";"原理"讲的上下文管理,是用好 Claude Code 最关键的一件事。

01入门

什么是斜杠命令?

跟 Claude 说话,和按遥控器上的按钮,是两回事。

你在输入框里打的大部分内容是"说话":Claude 读懂以后,自己决定怎么做。以 / 开头的则是"按按钮":直接让 Claude Code 这个程序执行一个确定的动作(也有一部分 / 命令其实是交给 Claude 的一段提示词,第 5 节会讲怎么区分)。

帮我把对话清一下这是"说话"。Claude 会理解你的意思,但清空对话这件事它自己做不到。
说话
/clear这是"按按钮"。Claude Code 立刻开始一段全新的对话,结果确定,没有歧义。
命令

试试看:输入框会怎么理解你的话?

Claude Code 只看第一个字符来决定怎么处理:/ 是命令,! 是直接跑终端命令,其他都是说给 Claude 听的话(中间出现 @ 会引用文件)。在下面的输入框里打字,看识别结果。

>
试试:
记不住也没关系

在 Claude Code 里,输入框为空时按 ? 会弹出快捷键面板;输入 /help 能看到帮助和可用命令。

02入门

不用背:边打边找的命令菜单

打出 / 的一瞬间,菜单就弹出来了。继续打几个字母,它会帮你筛。

下面是一个模拟的命令菜单,筛选规则和真实的 Claude Code 一样。点进输入框试试:↑↓ 选择,Tab 补全,Enter 运行。

命令菜单(示意)
>
↑ ↓ 选择Tab 补全Enter 运行
试试这些:

菜单是怎么匹配的

  1. 从名字或别名的开头匹配,也能从中间某个单词开头匹配,并且忽略 - _ : 这些分隔符。所以 /adddir 能选中 /add-dir,/new 能选中 /clear(new 是它的别名)。
  2. 打错字时,菜单不会高亮任何一项。相近的命令还列着,可以用 Tab 或方向键选;但直接按回车,会报 Unknown command。(v2.1.236 之前会自动运行最接近的那个,现在不会了。)
  3. 你用不了的命令不会出现在菜单里,比如某些命令只在特定平台或套餐下可用。
  4. 少数命令故意不显示,比如排查内存问题用的 /heapdump,要把全名打完它才会出现。
03入门

按场景记:新手必会的命令

Claude Code 有一百多个命令,但日常用得上的就那十几个。按你正在做的事情来记,最快。

标着「必会」的 10 个,是建议每位学员第一周就用熟的。

04原理

管好上下文

/clear、/compact、/btw、/rewind 这四个命令最容易混。弄清它们,你就掌握了用好 Claude Code 最重要的一件事。

Claude 每次回答,都要把这次对话里的所有内容重新读一遍:系统说明、项目记忆(CLAUDE.md)、你们来回的每一条消息。这些内容装在一个容量有限的"工作台"上,叫上下文窗口。台面越满,Claude 越容易分心,也越贵。

下面每个小方块代表大约 2,000 token。点按钮,看四个命令分别对台面做了什么。

上下文用量 0 / 200k
/btw · 旁支问答刚才改的是 Login.tsx 和 auth.ts。
这段问答不会写进上下文。
系统说明与工具 CLAUDE.md 项目记忆 对话消息 压缩后的摘要

格子数量是示意,这里按 20 万 token 的窗口来画;现在默认的 Opus、Sonnet 模型窗口是 100 万 token,道理一样。真实比例取决于你的模型、项目和对话。在 Claude Code 里输入 /context,能看到你自己的真实情况,而且就是这样一张彩色格子图。

命令对话历史CLAUDE.md代码改动什么时候用
/clear清空,开始新对话(旧的还能 /resume 找回)保留不动换一个新任务
/compact压缩成一段摘要,可以告诉它重点保留什么保留不动同一个任务聊得太长了
/btw不写入—不动顺口问一句,不想打乱主线
/rewind回到之前的某一点保留可以选择一起撤回走错路了,想从某一步重来
/clear 不等于"撤销"

/clear 只是开始一段新对话,不会撤销 Claude 已经改过的代码,也不会删掉 CLAUDE.md。想连代码一起退回去,用 /rewind(第 3 课细讲)。

/btw 的两个限制

旁支问答只能根据对话里已有的内容回答,不能读文件、跑命令或搜索;弹窗里也没法接着追问,想追问就再打一次 /btw。需要 Claude 动手查,就在弹窗里按 f,把这段问答交给一个后台子代理(第 8 课)。Claude 正在回答时也能用 /btw,不会打断它。

05原理

命令从哪里来?看名字就知道

菜单里的命令有四个来源,看名字的写法和菜单里的标记就能分辨。

内置命令 /clear /modelClaude Code 自带,由程序直接执行。
Skill /code-review /你起的名字包括 Claude Code 自带的"内置 skill",和你自己写的 skill(第 5 课)。本质是一段交给 Claude 去执行的提示词。
插件命令 /插件名:命令名例如 /commit-commands:commit。名字带冒号,不会和别人的冲突(第 10 课)。
MCP 提示词 /mcp__服务器__提示词例如 /mcp__github__list_prs,菜单里显示为 /github:list_prs (MCP)。由连接的 MCP 服务器提供(第 7 课)。
最关键的区别:谁在干活

内置命令由 Claude Code 程序直接执行,结果确定,大多不消耗对话额度。Skill 类命令(包括 /code-review、/loop 这些内置 skill)是把一段写好的提示词交给 Claude,由 Claude 去完成,所以会消耗 token,结果也取决于 Claude 的判断。

练一练:这是哪种命令?

06原理

命令的几条规则

什么时候算命令、后面的字算什么、Claude 正在回答时会怎样。先猜,再看解析。

规则小结

  • 只有消息开头的 / 才是命令。命令名后面的文字,就是交给这个命令的参数。
  • 句子中间也能补全命令名:在空格后打 / 加几个字母,按 Tab 插入。但它只是文字,不会被执行。
  • Claude 正在回答时发命令,大多会排队,等这一轮说完再执行;/status、/tasks、/usage 这类只查看的命令会立刻执行,不打断回答。
  • Skill 可以串联:/skill-a /skill-b 要求 会同时加载开头的几个 skill(最多 6 个),后面的文字传给每一个。这条只对 skill 有效。
07实战

终端演练:一次完整的工作流程

从启动到交付,把这节课的命令串起来用一遍。点"下一步"回放,放完可以自己输入。

my-app — claude — 90×28
>

终端画面为教学示意,与真实 Claude Code 的界面细节可能略有不同,但命令的作用一致。

08实战

做你自己的命令

每次都要打一大段相同的要求?把它存成一个命令,以后打 /名字 就行。

自定义命令现在就是 Skill。最简单的形式只需要一个文件:

.claude/skills/optimize/SKILL.md
---
description: 分析代码的性能问题并给出优化建议
---

# 代码优化

按优先级检查以下问题:
1. 性能瓶颈:O(n²) 操作、低效循环
2. 内存泄漏:没释放的资源、循环引用
3. 可以缓存的重复计算

每个问题给出:位置、原因、改进后的代码。

保存后,在 Claude Code 里输入 /optimize 就能用(如果 .claude/skills 这个文件夹是这次会话开始后才新建的,先运行 /reload-skills 或重启 Claude Code)。文件夹名就是命令名;description 写清楚做什么、什么时候用。参数、动态内容、权限这些进阶写法,第 5 课 Skills 会完整讲。

以前的写法还能用

老教程里常见的 .claude/commands/optimize.md(单个文件)现在依然有效。但它不支持附属文件等新能力,新写的建议用 skill。两者同名时,skill 优先。

命令模板库:8 个拿来就能用

下面是原教程仓库提供的 8 个命令,保留英文原文。选一个看内容,拷贝后按底部路径保存即可。

命令模板库
保存为
09深入

命令地图:全部命令一览

按官方命令参考整理(2026 年 9 月,Claude Code v2.1.278)。不用背,需要时来查。

命令作用类别

为什么我的菜单里少了几个?

有些命令只在特定平台、套餐或登录方式下出现(比如 /desktop 需要 macOS 或 x64 Windows 加 Claude 订阅),组织策略也可能关闭某些命令。以你自己的 / 菜单为准。

10深入

避坑:新手常问的问题

Claude Code 更新很快,老教程里的有些说法已经不对了。

输入命令后提示 Unknown command
  1. 先检查拼写,提示末尾常会带一句 Did you mean /xxx?,照着改就行。v2.1.236 起,打错字不会再自动执行最接近的命令,菜单里会列出相近的,用 Tab 或方向键选。
  2. 这个命令可能在你的平台、套餐或登录方式下不可用。
  3. 如果是你自己写的 skill,检查路径是不是 .claude/skills/名字/SKILL.md,再用 /skills 看它有没有被加载。
命令发出去了,好像没反应
Claude 正在回答时,大多数命令会排队,等这一轮结束才执行。/status、/tasks、/usage 这类只查看的命令会立刻执行。
/clear 之后,Claude 怎么还记得项目规则?
因为项目规则写在 CLAUDE.md 里,而 CLAUDE.md 在每段新对话开始时都会重新加载。/clear 清的是对话,不是记忆。第 2 课会细讲。
老教程里的 /agents 界面不见了
v2.1.198 起,/agents 只会提示你:直接让 Claude 帮你创建、管理子代理,或者自己编辑 .claude/agents/ 目录。子代理在第 8 课讲。
/review 和以前不一样了
v2.1.223 起,/review 成了 /code-review 的别名:审查当前改动,也可以传 PR 编号、分支或路径,比如 /review 1234。
老教程里的某个命令找不到了
这几个已经移除:/pr-comments(v2.1.91 起,直接让 Claude 看 PR 评论)、/vim(v2.1.92 起,改到 /config → Editor mode)、/ultraplan(改用 plan 模式,即 /plan)。另外,/extra-usage 改名成了 /usage-credits。
我的命令和插件里的命令重名了
插件命令永远可以用带前缀的全名调用,比如 /my-plugin:deploy,不会冲突。你自己的 skill 和旧式 .claude/commands/ 文件重名时,skill 优先。
11检验

小测验

8 道题,每题选完会立刻看到解析。