深入剖析 Claude Code 斜杠命令：从入门到自定义你的专属工作流

深入剖析 Claude Code 斜杠命令：从入门到自定义你的专属工作流

掌握这些“/”魔法，让你的 AI 编程助手从“新手”蜕变为“老司机”

如果你已经接触过 Claude Code，你一定对这个以 claude 命令启动的交互式终端环境不陌生。它不仅仅是一个 AI 聊天界面，更是一个能深度理解你的代码库、主动执行终端命令、修改文件的智能体（Agent）。在这个强大的交互环境中，斜杠命令（Slash Commands，即以 / 开头的指令）是我们指挥 Claude 最直接、最高效的方式。

通过深入研究和实践，我发现这些命令远不止是快捷键，它们是 Claude Code 这座冰山的水下部分，承载着项目初始化、上下文管理、深度思考、成本控制等核心功能。本文基于最新的官方文档和社区实践，为你系统梳理每一个斜杠命令的含义与使用场景，并手把手教你打造属于自己的自定义命令，让你的开发效率“起飞”。

为什么斜杠命令是 Claude Code 的“灵魂”？

在开始罗列命令之前，我们需要建立一种认知：Claude Code 是一个上下文感知的智能体。它记得你之前的对话，知道你项目里的文件，甚至可以操作终端。斜杠命令，就是直接调用 Claude 内置的“超能力”或你预设的“思维模板”的开关。

使用它们，你可以：

• 管理项目记忆：告诉 Claude 这个项目的“规矩”（代码规范、常用命令）。
• 透视 AI 大脑：查看它当前记住了什么，上下文窗口还剩多少。
• 切换工作模式：从“自由畅想”切换到“严谨规划”再到“无情审查”。
• 控制成本与效率：压缩无效历史，监控 Token 消耗。

下面，我们将这些命令按功能分类，逐一拆解。

核心命令分类解读

1. 项目管理与初始化：为 AI 设定“长期记忆”

• /init：这应该是你在一个新项目中敲下的第一个命令。运行 /init 后，Claude 会像一个细心的入职引导员，扫描你的整个代码库，自动生成一个 CLAUDE.md 文件 。这个文件包含了项目的构建命令、架构模式、代码规范等重要信息，成为 Claude 在你项目中的“长期记忆”和行动指南 。

• /memory：用于直接编辑 CLAUDE.md 这个记忆文件 。你甚至不需要手动打开文件，可以直接用自然语言告诉 Claude：“更新记忆，所有测试都用 Vitest 而不是 Jest”，它便会通过 /memory 机制帮你完成修改 。

• /add-dir：在处理像 Monorepo（单一代码库）这样的大型项目时，Claude 默认可能只关注当前目录。使用 /add-dir 可以手动将其他重要的工作目录（如 ../shared 或 ../packages）添加到它的“视野”中，确保上下文覆盖所有相关代码 。

2. 分析与洞察：成为你项目的“X 光机”

• /context：这是我最常使用的命令之一，堪称“上下文透视镜”。当你感觉 Claude 开始“胡言乱语”或忽略某些重要文件时，输入 /context，它会清晰列出当前上下文窗口的组成：系统提示词、CLAUDE.md 规则、加载的 MCP 工具、对话历史等各自占用了多少 Token 。这能帮你精准定位是谁“吃掉”了宝贵的上下文空间。

• /insights：这是一个被严重低估的命令。运行 /insights，Claude 会分析你过去 30 天的使用数据，生成一份详细的 HTML 报告 。这份报告会揭示你的“摩擦模式”（Friction Patterns）——即你在哪些类型的任务上经常卡壳、需要反复纠正 Claude，并给出优化 CLAUDE.md 和工作流程的个性化建议 。它就像是 Claude 给你的一份“团队协作复盘报告”。

• /stats：查看你的个人使用仪表盘，包括使用习惯、最爱的模型、连续使用天数等趣味数据 。

3. 代码质量与安全：你的私人“代码审查员”

• /review：启动代码审查。Claude 会读取你当前的改动，从代码质量、最佳实践等角度提出建议 。

• /pr-comments：当你在一个关联了 GitHub PR（拉取请求）的会话中工作时，这个命令能快速拉取 PR 上的评论上下文，帮助 Claude 理解代码审查者的反馈，并据此进行修改 。

• /security-review：这是一个内置的安全扫描器。它会检查你的代码中是否存在 SQL 注入、跨站脚本（XSS）、认证缺陷等常见漏洞 。你可以在提交代码前运行它，也可以将其集成到 GitHub Actions 中，实现对每个 PR 的自动化安全审查 。这相当于为你的代码库配备了一个 7x24 小时工作的安全专家。

• /debug：顾名思义，启动调试模式。当遇到棘手的 Bug 时，Claude 会调用相关工具，更有条理地分析问题。

4. 会话与效率管理：让你与 AI 的协作更丝滑

• /compact：随着对话变长，上下文窗口会越来越满，不仅消耗 Token，还可能让 Claude “忘记”开头的重要信息。/compact 命令会智能地压缩对话历史，只保留核心摘要 。你还可以给它指令，例如 /compact 关注最近的认证错误信息，让它更有针对性地压缩 。

• /clear：简单粗暴地清空当前会话的所有历史记录，让你和 Claude 的对话从一个干净的状态重新开始 。

• /rename & /resume：给当前会话起一个有意义的名字（如 /rename fix-auth-bug），之后即使退出终端，也可以通过 claude --resume fix-auth-bug 或 /resume fix-auth-bug 精准地恢复到该会话 。

• /export：将整个对话，包括你的 Prompt、Claude 的回复以及所有工具调用记录，导出为一个 Markdown 文件。这对于撰写技术文档、与同事分享问题排查过程、或者自己复盘都非常有用 。

• /vim：Vim 用户的福音！在 Claude Code 中开启 Vim 键位绑定，用 hjkl 导航，用 dd 删除行，手不离键盘，效率倍增 。

• /statusline：自定义底部的状态栏，可以显示 Git 分支、当前模型、Token 使用量、上下文占比等信息，让你对当前状态一目了然 。

• /agents：创建子 Agent 。主 Agent 可以生成拥有独立上下文的子 Agent，并行处理特定任务（如“分析这个日志文件”或“去查阅那份外部文档”），然后将结果汇总。这是处理复杂、多步骤任务的高级模式。

5. 成本与性能：做一名精打细算的“架构师”

• /cost：对于 API 按量付费的用户，这是你的“钱包守护神”。它会显示当前会话预估消耗的 Token 数量和费用 。通过它，你可以了解不同任务的成本，并优化自己的提问方式 。

• /usage：查看当前 API 使用额度和剩余量，避免因额度用尽导致服务中断的尴尬 。

• /model：动态切换底层模型。你可以在处理简单任务时切换到更经济的模型，而在进行复杂架构设计时换回能力最强的模型，灵活平衡性能与成本 。

为了让你对这些内置命令有一个更直观的概览，我整理了下表：

类别	命令	核心功能
项目管理	/init， /memory， /add-dir	初始化项目记忆、编辑规则文件、添加额外目录
分析洞察	/context， /insights， /stats	透视上下文组成、分析历史摩擦点、查看使用统计
代码质量	/review， /pr-comments， /security-review， /debug	代码审查、关联 PR 评论、安全漏洞扫描、启动调试
会话效率	/compact， /clear， /rename， /resume， /export	压缩历史、清空对话、重命名/恢复会话、导出记录
高级控制	/agents， /model， /cost， /usage， /vim， /statusline	创建子 Agent、切换模型、查看成本、开启 Vim 模式

进阶玩法：打造你的专属“瑞士军刀”（自定义命令）

Claude Code 的真正威力在于其可扩展性。你可以将自己常用的 Prompt、复杂的指令链、甚至特定的工具权限打包成一个自定义的斜杠命令，实现“一键式”复杂操作 。

自定义命令的创建与存放

创建自定义命令非常简单，你只需要编写 Markdown 文件，并将其放入两个指定位置之一 ：

• 项目级别：在你的项目根目录下创建 .claude/commands/ 文件夹。
• 用户级别：在你的用户主目录下创建 ~/.claude/commands/ 文件夹。

放入这两个文件夹中的 .md 文件，会立即被 Claude Code 识别为新的斜杠命令。例如，创建一个 .claude/commands/commit.md 文件，你就可以在会话中使用 /commit 命令。

揭秘命令文件的“灵魂”：Frontmatter

一个基本的命令文件可以只是一段 Prompt 文本。但如果想要更强大的功能，就需要用到 YAML 格式的 Frontmatter（文件头）。它位于文件最开头，用 --- 包裹，用于配置命令的元数据。

---
description: 生成符合团队规范的 commit message
allowed-tools: Bash
---

分析当前的 git diff，根据 Angular 团队的提交规范（type(scope): subject）生成 3-5 条 commit message 建议。
请确保 type 可选 feat, fix, docs, style, refactor, test, chore。

• description （必填） ：简短的描述。当 Claude 需要自动调用命令（通过 SlashCommand 工具）时，就是通过这个描述来判断何时使用你的命令 。
• allowed-tools （可选） ：限制执行此命令时，Claude 可以调用哪些工具。这有助于提高安全性和专注度。例如 /commit 只需要 Bash 来执行 git diff。

通过这种机制，你可以构建各种强大的命令：

• /refactor：内置“先理解再重构”的思维流程，防止 Claude 盲目修改 。
• /test-generator：分析当前文件，为其生成单元测试。
• /daily-standup：查看过去一天的 git 提交，生成一份简洁的站会报告。

实战案例：构建一个“安全重构”命令

假设你发现 Claude 在重构代码时，经常因为没有充分理解现有逻辑而引入 Bug。我们可以创建一个 /safe-refactor 命令来强制它遵循一个更安全的流程 。

创建文件 .claude/commands/safe-refactor.md：

---
description: 在确保完全理解代码的前提下，安全地进行重构。适用于有复杂逻辑或共享模块的代码。
allowed-tools: Read, Grep, Glob, Edit
---

# 安全重构协议

在执行重构任务时，请严格遵守以下步骤：

1.  **诊断与理解**：首先，使用 `Read` 工具阅读我将要重构的整个文件和相关依赖文件（如工具函数、父类）。使用 `Grep` 或 `Glob` 查找该模块在其他地方的引用，评估影响范围。**在理解现有模式和边界之前，不要提出任何修改方案。**

2.  **识别约束与规划**：基于你的诊断，列出本次重构必须遵守的约束条件（例如：对外接口不能变、某段核心逻辑不能动）。然后，向我描述你的重构计划，并**等待我确认**。

3.  **最小化实施**：一旦计划获得批准，以最窄的范围、最小化的改动实施重构。

4.  **验证与收尾**：修改完成后，请帮我检查是否引入了新的语法错误，并提醒我运行相关的测试套件进行验证。

## 失败案例警示
回顾以下因未遵守此流程而导致的失败案例：
- 在重构 `utils/date-helper.js` 时，直接修改了一个被多个模块使用的内部函数名，导致下游模块报错。
- 为 `UserController` 添加新功能时，复用了另一个 Controller 的模式，但没有注意到本 Controller 使用了不同的认证中间件。

现在，当你下次需要重构一个关键模块时，只需输入 /safe-refactor 并附上你的需求，Claude 就会加载这个“思维模板”，像一个经验丰富的老手一样，谋定而后动。这极大地提升了 AI 执行复杂任务的可靠性。

总结

Claude Code 的斜杠命令体系，构成了一个从项目初始化（/init）到日常协作（/review, /context），再到复盘优化（/insights）的完整闭环。它不仅仅是一个编码工具，更是一个懂业务、守规矩、可塑性强的高级开发伙伴。

而自定义命令的能力，则将这个伙伴的潜力完全交还给你。你可以将团队的编码规范、个人的最佳实践、甚至是对抗 AI 常见“幻觉”的“咒语”，都固化成一个简单的 / 命令。这不仅是效率的提升，更是知识和流程的资产化。

希望这篇文章能帮你理清这些命令的脉络，并激发你构建自己专属命令库的灵感。毕竟，在这个 AI 时代，最强大的工具，永远是那些为你量身定制的工具。