Claude Code 斜杠命令全解：14 条实用指南
Claude Code 上手门槛几乎为零
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 的内容规范，几条硬经验
不超过 200 行。 Claude Code 每次会话都加载 CLAUDE.md 并持续占用上下文窗口。臃肿的 CLAUDE.md 会让 Claude 忽略真正重要的规则——写得越多，有效空间越少。
不塞项目历史。 CLAUDE.md 的职责是告诉 Claude「怎么工作」，不是「发生过什么」。架构文档放 docs/ 里，CLAUDE.md 只写引用路径，需要时 Claude 自己会去读。
规则必须可执行。 「写干净的代码」Claude 听不懂。「用 named export、组件不超过 200 行、禁止 any 类型」它能直接执行。
禁止清单和允许清单同等重要。 Claude 会在不知情时引入它「知道」的最优方案，如果这个方案跟项目冲突，后续很多次会话都在修兼容性问题。明确写「不要引入 Redux」「不要用 MongoDB」。
一个健康的项目 CLAUDE.md 通常在 300–600 token。超过 2000 token 说明塞了不属于这里的内容。
第二层：日常高频命令
日常开发中最常用的四个命令，分别解决上下文压力、分心打断、切屏损耗和用量感知。
/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 消耗路径：
Claude 拉取 PR diff（可能几千行，注入对话上下文）
调用多个工具读取相关文件（每个文件全部内容注入）
输出 review 意见
你来回讨论修改——上述全部内容逐轮重发
Bug 修完，一句「谢谢」追加几千 token
想在同一个 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，每个项目至少配置以下四个：
格式化 Hook（PostToolUse → Write）—— 文件编辑后自动格式化，不依赖 Claude 记得
测试门禁 Hook（PreToolUse → Bash）—— 部署命令前强制跑测试，测试不过不绿灯
密钥扫描 Hook（PostToolUse → Read）—— 输出经过敏感数据模式过滤，拦截凭据泄漏
上下文注入 Hook（UserPromptExpansion → /review）——审查命令自动注入团队标准清单
四段 shell 脚本，零新依赖，一个 JSON 配置文件搞定。
命令速查
使用建议
新项目：先跑 /init 生成 CLAUDE.md，再用 /memory 写入全局偏好。
日常：! 替代切终端，/btw 处理临时问题，/cost 监控用量，上下文吃紧时 /compact。
代码审查：每个 PR 跑 /review，作为人工 review 的前置过滤。
复杂任务：用 /model opus 做方案推演，切 /model haiku 批量产出。
异常排查：先 /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 命令
评论
加载评论…