2.3 斜杠命令指南
预计耗时：12 分钟
本关任务简报
进入 Claude Code 之后，你会发现它不只是一个聊天框。输入 / 会弹出一个命令列表，这些命令控制着会话、配置、工具连接等各种行为。问题是：命令有几十个，第一次看完全不知道该记哪些。
这一关的任务是：按优先级认识斜杠命令，搞清楚每天真正用得上的是哪几个，以及如何把高频工作流打包成你自己的专属命令。
通关奖励：解锁以下技能
- 🗂️ 知道哪些斜杠命令是日常必用的
- 🔍 能用
/弹出命令列表快速发现和筛选命令 - 🛠️ 能创建属于自己的自定义斜杠命令
- 💡 理解自定义命令的触发方式和参数传入方式
开始前先检查装备
| 前置知识 | 说明 |
|---|---|
| 2.1 界面概览 → | 了解输入框位置——/ 是在 Claude Code 输入框里触发的，不是终端命令 |
| 2.2 快捷键详解 → | 换行（Alt+Enter）与发送（Enter）的区别，避免输入命令时误按发送 |
机制解析
命令发现：输入 / 就够了
你不需要背下所有命令。在输入框输入 /，Claude Code 会弹出完整的命令列表并支持实时筛选——继续输入关键字，列表会缩小到匹配项。例如输入 /mo 会直接过滤到 /model。
第一梯队：每天都会用到的命令
| 命令 | 做什么 | 用的时机 |
|---|---|---|
/clear | 清除当前对话历史，释放上下文空间 | 对话太长、Claude 开始"忘事"时 |
/compact | 把对话压缩成摘要，继续工作 | 不想断开会话但上下文快满时 |
/cost | 查看当前会话的 token 用量和估算费用 | 想知道"这次对话花了多少"时 |
/model | 切换或查看当前使用的模型 | 要切换到更强/更快的模型时 |
/exit | 退出 Claude Code | 不想用 Ctrl+D 的时候 |
第二梯队：配置和调试时用
| 命令 | 做什么 |
|---|---|
/init | 在当前项目生成 CLAUDE.md 初始模板 |
/memory | 查看和编辑当前生效的记忆文件 |
/permissions | 查看当前会话的权限配置 |
/config | 打开配置编辑界面 |
/doctor | 检查 API Key、网络连接和版本配置是否正常 |
/status | 显示当前会话状态摘要 |
第三梯队：特定场景才用
| 命令 | 做什么 | 适用场景 |
|---|---|---|
/login | 通过浏览器登录 Anthropic 账户 | 换账号或首次登录时 |
/logout | 退出当前账户 | 切换账号时 |
/ide | 连接到 VS Code 扩展 | 使用 IDE 集成时 |
/terminal-setup | 配置 Shift+Enter（macOS 含 Option+Enter）换行 | 换行不生效时运行一次 |
/vim | 切换 Vim 键位模式 | Vim 用户 |
/keybindings | 编辑键位配置文件 | 自定义快捷键时 |
/hooks | 通过交互菜单配置 Hooks | 设置自动化触发动作时 |
/mcp | 查看已连接的 MCP 服务器列表 | 排查 MCP 是否生效时 |
/review | 对当前分支变更进行代码审查 | 提交前 PR 检查 |
自定义斜杠命令：把你的工作流变成一个命令
这是斜杠命令里最值得深入的能力。你可以把自己的高频工作流——比如"审查当前改动的安全性"、"生成提交信息"、"跑完整的部署检查"——打包成一个命令，以后直接 /命令名 触发。
创建方式：在项目根目录的 .claude/commands/ 文件夹下创建 Markdown 文件，文件名就是命令名。
项目根目录/
└── .claude/
└── commands/
├── review-security.md → 触发：/review-security
├── commit-msg.md → 触发：/commit-msg
└── deploy-check.md → 触发：/deploy-check文件内容就是提示词模板。用 $ARGUMENTS 接收命令后面跟的参数：
<!-- .claude/commands/review-security.md -->
请对以下变更进行安全审查，重点检查：
1. 有没有把密钥或敏感信息写进代码
2. 有没有 SQL 注入或 XSS 风险
3. 权限校验逻辑是否完整
变更内容：$ARGUMENTS使用时直接输入：
/review-security 请检查 src/api/user.ts 这个文件$ARGUMENTS 会被替换成 请检查 src/api/user.ts 这个文件。
如果不传参数，$ARGUMENTS 为空，Claude 会根据当前上下文判断要处理什么。
全局命令：想让某个命令在所有项目里都可用，把文件放到
~/.claude/commands/下。项目级命令在.claude/commands/，只对当前项目生效。
💡 命令 vs Skill：自定义命令是轻量的个人快捷方式（一个
.md就是一条命令）；如果你想要更完整、能跨项目甚至打包分发给别人的能力（带说明文档、可被 Claude 按需自动调用），那是 Skill。两者的关系和 Skill 的完整玩法见 进阶 3.9 Skills 专题 →。
/compact 和 /clear 的区别
这两个都是对付"上下文快满"的手段，但机制不同：
/clear | /compact | |
|---|---|---|
| 效果 | 完全清空对话历史 | 把历史压缩成一段摘要 |
| 之后还能继续吗 | 需要重新解释背景 | 可以，Claude 保留了摘要 |
| 适合场景 | 一个任务结束，开始新的 | 当前任务没完成但上下文快满 |
/compact 可以带指令：
/compact 保留所有已确认的接口定义和数据库表结构开始闯关
目标：完成一个自定义命令的创建和使用。
第 1 步：创建命令文件
在当前项目的根目录下，创建 .claude/commands/ 文件夹（如果没有的话），然后新建一个文件，比如 hello.md：
.claude/commands/hello.md文件内容写：
请用一句话介绍一下当前目录是什么项目，并列出根目录下有哪些文件。第 2 步：在 Claude Code 里触发这个命令
在输入框输入 /hello，看命令列表是否出现了你刚创建的命令，按 Enter 执行。
你应该看到 Claude 开始分析当前项目目录并给出介绍。
第 3 步：试一下 /cost
输入 /cost，查看当前会话消耗了多少 token。
通关检定
- [ ] 在输入框输入
/后，能看到命令列表弹出 - [ ] 能输入关键字筛选命令（比如
/mo过滤到/model） - [ ] 成功创建了一个自定义命令文件并触发
- [ ] 知道
/clear和/compact的区别，并且知道什么时候用哪个 - [ ] 知道
/cost能查什么信息
全部点亮就算通关 ✓
卡关了？翻车指南在这
输入 / 后没有弹出任何列表
踩坑原因：你的终端可能没有正确渲染 Claude Code 的 TUI 界面。确认终端支持真彩色（True Color）和 Unicode 字符。Windows 用户建议用 Windows Terminal，不要用旧版的 cmd。
创建了自定义命令，但 / 里找不到它
踩坑清单：① 文件扩展名必须是 .md；② 文件路径必须是 .claude/commands/（注意是项目根目录下，不是其他位置）；③ 文件名不能包含空格，用 - 连接多个词；④ 需要重新启动 Claude Code 让它重新扫描命令目录。
/compact 压缩后 Claude "忘掉"了重要内容
/compact 不传参时，Claude 会自主判断什么值得保留。如果有关键信息不能丢，用 /compact 保留[具体内容] 明确告诉它。
下一关
Claude 能读你的文件、执行命令，甚至删东西——这一关告诉你这套权限机制是怎么运转的，以及如何配置让它少打扰你又不失去控制。