# Claude Code 斜杠命令全解:14 条实用指南
**作者**: Vince 聊开发
**日期**: 2026-05-07T12:41:53.000Z
**来源**: [https://x.com/vincemask/status/2056222383116259437](https://x.com/vincemask/status/2056222383116259437)
---
Claude Code 上手门槛几乎为零。打开终端,打字,回车。大部分人也就停在这一层了。
但如果你只把 Claude Code 当聊天框用,你用的只是它 20% 的能力。剩下 80% 藏在斜杠后面:/compact 能在 10 秒内救回一个快撑爆的 session,/init 能省掉每个项目 45 分钟的重复文档劳动,/review 能在 bug 上线前抓到它。这些命令不增加复杂度,但它们把 Claude Code 从一个好用的补全工具变成了一个真正的提效神器。
以下按四层——一次性设置、日常高频、进阶优化、故障恢复——逐个说明每个命令的功能、用法和适用场景。
# 第一层:一次性设置
这三个命令只跑一次,后续所有会话自动继承。
## /init — 自动生成 CLAUDE.md
扫描当前项目目录结构,分析代码库,自动生成一份 CLAUDE.md,包含:
- 项目概要
- 架构决策记录
- 编码规范
- 关键依赖列表
- 环境搭建说明
```
/init
```
生成后可按需手动编辑。在已有 CLAUDE.md 的项目中重新执行会覆盖。
## /memory — 全局偏好配置
打开一份跨项目、跨会话的全局配置文件。写入的偏好、代码标准、风格约束会在所有会话中生效。
```
/memory
```
典型配置内容:
```
- 总是先建议写测试
- 组合优于继承
- 复杂逻辑需要注释
- 未经明确授权不使用 any
```
与 CLAUDE.md 的区别:/memory 作用于所有项目,CLAUDE.md 作用于当前项目。
## /pr_comments — 加载 GitHub PR 评论
将指定 PR 的所有评审意见拉到当前 Claude 会话中,作为上下文注入。避免在 GitHub 和 Claude 之间反复切屏查评论。
```
/pr_comments <PR_URL>
```
要求:已配置 GitHub 集成,且对目标仓库有读权限。
## CLAUDE.md 与 /init、/memory 的关系
/init 和 /memory 本质上都在维护 CLAUDE.md,但作用范围不同:
- /init 生成项目级 CLAUDE.md(项目根目录),只在当前项目生效。
- /memory 写入全局 CLAUDE.md(~/.claude/CLAUDE.md),所有项目的所有会话都会加载。
加载顺序:全局先加载,项目级后加载,项目级可覆盖全局配置。
关于 CLAUDE.md 的内容规范,几条硬经验
1. 不超过 200 行。 Claude Code 每次会话都加载 CLAUDE.md 并持续占用上下文窗口。臃肿的 CLAUDE.md 会让 Claude 忽略真正重要的规则——写得越多,有效空间越少。
2. 不塞项目历史。 CLAUDE.md 的职责是告诉 Claude「怎么工作」,不是「发生过什么」。架构文档放 docs/ 里,CLAUDE.md 只写引用路径,需要时 Claude 自己会去读。
3. 规则必须可执行。 「写干净的代码」Claude 听不懂。「用 named export、组件不超过 200 行、禁止 any 类型」它能直接执行。
4. 禁止清单和允许清单同等重要。 Claude 会在不知情时引入它「知道」的最优方案,如果这个方案跟项目冲突,后续很多次会话都在修兼容性问题。明确写「不要引入 Redux」「不要用 MongoDB」。
一个健康的项目 CLAUDE.md 通常在 300–600 token。超过 2000 token 说明塞了不属于这里的内容。
> **Vince 聊开发@vincemask**: [原文链接](https://x.com/vincemask/status/2052368318825402507)
>
# 第二层:日常高频命令
日常开发中最常用的四个命令,分别解决上下文压力、分心打断、切屏损耗和用量感知。
## /btw — 旁路提问
在不中断主线任务的前提下,插入一个独立问题。Claude 会回答这个问题,同时保留当前任务的上下文进度。
```
/btw refresh token 的最佳处理方式是什么?
```
适用场景:开发过程中突然需要查一个概念、对比两个方案、回忆某个 API 用法,但又不想丢掉当前对话状态。
## /compact — 压缩对话上下文
对当前会话做摘要压缩,丢弃冗余消息,保留关键决策、代码片段和上下文要点,释放 token 窗口。
```
/compact
```
触发时机:会话超过 100-200 条消息、响应明显变慢、出现上下文超限警告。压缩后会话继续,不需要重开。
## ! — 内联 Shell 执行
在 Claude Code 聊天窗口中直接执行 shell 命令,输出出现在对话里,不需要切到终端。
```
! git status
! npm run test
! git add .
```
多个命令可以串成连续工作流,一次运行整套操作。
要求:终端集成已启用(参见 /terminal-setup)。
## /cost — Token 用量查询
显示当前会话的 token 消耗和费用。
```
/cost
```
输出示例:
```
总花费:$0.08
Token 用量:42k
剩余上下文:60%
```
用途:在上下文占用过高前主动 /compact,而不是等到超限。
## /compact 与 Token 管理的底层逻辑
每轮对话重发全部历史。 Transformer 架构不存在「回看聊天记录」——你每发一条消息,整个对话历史都被重新发送:你的 prompt、Claude 的回复、每次工具调用的结果。全部,每次。你的消息 token 数是 session 开始以来所有内容的累计量。
以一次 PR review 为例看 token 消耗路径:
1. Claude 拉取 PR diff(可能几千行,注入对话上下文)
2. 调用多个工具读取相关文件(每个文件全部内容注入)
3. 输出 review 意见
4. 你来回讨论修改——上述全部内容逐轮重发
5. Bug 修完,一句「谢谢」追加几千 token
6. 想在同一个 session 做别的事 → 额度耗尽
> /compact 的正确用法:不是在额度耗尽后补救,而是在每个明确阶段完成后主动执行。 一个健康的 session 产出的压缩内容质量,远好于退化后的 session。/compact 保留架构决策、文件修改记录、任务状态、错误和解决方案;丢弃中间推理链、被推翻的方案、原始工具输出。
建议:100 条消息时主动 /compact,不等超限警告。与 /cost 配合——/cost 看油量,/compact 加油。
概念区别:/compact 压缩后继续当前任务;/clear 清空所有对话从头开始。任务还在做、上下文吃紧 → /compact。任务完成、要切不相关的事 → /clear。
# 第三层:进阶命令
这三个命令面向有经验的用户,在模型选择、响应速度、代码质量三个维度做精细控制。
## /model — 会话内切换模型
在同一个会话中动态切换 Claude 模型,不需要重开对话,上下文不丢失。
```
/model opus # 深度推理
/model sonnet # 速度与质量平衡
/model haiku # 快速响应
```
典型用法:用 Opus 做架构设计和方案推演,方案确定后切 Haiku 批量生成代码,最后切回 Sonnet 做审查。
## /fast — 快速模式开关
切换同一模型的响应策略:开启后优先速度,关闭后恢复默认的深度推理。
```
/fast
```
适用场景:
- 头脑风暴和原型探索
- 批量重构
- 迭代 debug
- 对响应质量要求不高的快速试探
## /review — 系统化代码审查
对当前代码做结构化审查,输出逐行标注的问题清单。覆盖五个维度:
- Bug 和边界情况
- 逻辑错误
- 代码可读性
- 性能问题
- 安全隐患
```
/review
```
典型输出格式:
```
第 42 行:潜在空引用——处理缺失的 key
第 87 行:低效循环——考虑用 map 替代
第 103 行:安全风险——对用户输入做清理
```
# 第四层:故障恢复命令
这四个命令用于会话异常、环境故障和配置问题。
## /clear — 软重置会话
清空当前对话历史,但保留工具权限、项目上下文和所有设置。
```
/clear
```
与重开会话的/new区别:重开需要重新加载 CLAUDE.md、重新授权工具、重新注入上下文。/clear 跳过这些步骤,几秒内恢复可用状态。
## /doctor — 环境健康检查
检查 Claude Code 运行环境的各项依赖状态:
```
/doctor
```
检查项:
- API key 有效性
- Node.js 版本 (≥18)
- 权限配置
- 配置文件完整性
- 终端集成状态
输出通过/失败清单。在遇到异常行为时优先运行此命令,而非直接重装。
## /terminal-setup — 终端集成配置
配置 shell 集成,使 Claude Code 能够读取终端输出。这是 ! 命令和终端交互功能的前提。
```
/terminal-setup
```
配置完成后,Claude 可以直接看到命令执行结果,不再需要手动复制粘贴。
## /help — 命令列表
列出所有可用 slash 命令及简短说明。
```
/help
```
新用户建议先执行此命令了解全貌,再深入具体命令。
# Hook 与 Slash 命令的协同
Slash 命令是交互式的——你输入,Claude 执行。但有些事不应该依赖 Claude「记得做」,这些事应该交给 Hook。
Hook 是在 Claude Code 生命周期固定节点自动执行的 shell 命令。CLAUDE.md 是礼貌建议,Hook 是物理定律——不消耗上下文,只在预设时机强制执行。
## /review + UserPromptExpansion Hook
每次输入 /review 时,UserPromptExpansion Hook 可以在 prompt 到达 Claude 之前,自动注入团队的审查清单。Claude 拿到的不再是空泛的「帮我 review」,而是预装了实际标准的 prompt。清单不需要跟任务上下文抢注意力——它跟任务一起到达。
## /compact + SessionStart Hook
/compact 压缩对话后,SessionStart Hook 自动触发,在压缩恢复后重新注入项目上下文、环境变量提醒或 Claude 需要重新感知的信息。
## /doctor vs PreToolUse Hook
/doctor 是被动检查——发现问题后排查。PreToolUse Hook 是主动拦截——在 Claude 执行 Bash 命令之前匹配危险模式(deploy、push、rm -rf),匹配到直接拦截或要求用户确认。不需要等你察觉到异常。
## ! + PostToolUse Hook
你用 ! 跑完 git commit,但忘了先格式化。PostToolUse Hook 在每次文件编辑后自动跑 Prettier,不管 Claude 想不想跑。不需要在 CLAUDE.md 里写「每次写完都要格式化」——Hook 直接执行,零上下文消耗。
## 四个必要 Hook
参考 claude-code-4-hooks,每个项目至少配置以下四个:
1. 格式化 Hook(PostToolUse → Write)—— 文件编辑后自动格式化,不依赖 Claude 记得
2. 测试门禁 Hook(PreToolUse → Bash)—— 部署命令前强制跑测试,测试不过不绿灯
3. 密钥扫描 Hook(PostToolUse → Read)—— 输出经过敏感数据模式过滤,拦截凭据泄漏
4. 上下文注入 Hook(UserPromptExpansion → /review)——审查命令自动注入团队标准清单
四段 shell 脚本,零新依赖,一个 JSON 配置文件搞定。
> **Vince 聊开发@vincemask**: [原文链接](https://x.com/vincemask/status/2054457804057100405)
>
# 命令速查

# 使用建议
1. 新项目:先跑 /init 生成 CLAUDE.md,再用 /memory 写入全局偏好。
2. 日常:! 替代切终端,/btw 处理临时问题,/cost 监控用量,上下文吃紧时 /compact。
3. 代码审查:每个 PR 跑 /review,作为人工 review 的前置过滤。
4. 复杂任务:用 /model opus 做方案推演,切 /model haiku 批量产出。
5. 异常排查:先 /doctor 定位问题,再 /clear 重置会话,不要直接重开或重装。
# 参考资料
- I Wasted 6 Months Using Claude Code Wrong. Here Are the 14 Commands That Changed Everything.
- Claude Code custom slash commands 官方文档
- awesome-claude-code — 精选 skills、hooks 和命令集
- wshobson/commands — 57 个生产级命令
- claude-code-tresor — 开源命令库
- Builder.io: 我是怎么用 Claude Code 的(深度体验)
- batsov.com: Claude Code 必备 skills 和命令
- Daily Dose of DS: 10 个必用的 slash 命令

## 相关链接
- [Vince 聊开发](https://x.com/vincemask)
- [@vincemask](https://x.com/vincemask)
- [3.1K](https://x.com/vincemask/status/2056222383116259437/analytics)
- [May 7](https://x.com/vincemask/status/2052368318825402507)
- [166K](https://x.com/vincemask/status/2052368318825402507/analytics)
- [May 13](https://x.com/vincemask/status/2054457804057100405)
- [51K](https://x.com/vincemask/status/2054457804057100405/analytics)
- [I Wasted 6 Months Using Claude Code Wrong. Here Are the 14 Commands That Changed Everything.](https://pub.towardsai.net/i-wasted-6-months-using-claude-code-wrong-here-are-the-14-commands-that-changed-everything-b892b8f07915)
- [Claude Code custom slash commands 官方文档](https://platform.claude.com/docs/en/agent-sdk/slash-commands)
- [awesome-claude-code — 精选 skills、hooks 和命令集](https://github.com/hesreallyhim/awesome-claude-code)
- [wshobson/commands — 57 个生产级命令](https://github.com/wshobson/commands)
- [claude-code-tresor — 开源命令库](https://github.com/alirezarezvani/claude-code-tresor/tree/main/commands)
- [Builder.io: 我是怎么用 Claude Code 的(深度体验)](https://www.builder.io/blog/claude-code)
- [batsov.com: Claude Code 必备 skills 和命令](https://batsov.com/articles/2026/03/11/essential-claude-code-skills-and-commands/)
- [Daily Dose of DS: 10 个必用的 slash 命令](https://blog.dailydoseofds.com/p/10-must-use-slash-commands-in-claude)
- [Upgrade to Premium](https://x.com/i/premium_sign_up)
- [11:56 AM · May 18, 2026](https://x.com/vincemask/status/2056222383116259437)
- [3,131 Views](https://x.com/vincemask/status/2056222383116259437/analytics)
- [View quotes](https://x.com/vincemask/status/2056222383116259437/quotes)
---
*导出时间: 2026/5/18 14:21:24*