# 深入剖析 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**（文件头）。它位于文件最开头，用 `---` 包裹，用于配置命令的元数据。

```markdown
---
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`：

```markdown
---
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 时代，**最强大的工具，永远是那些为你量身定制的工具**。

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

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

本文系统梳理了 Claude Code 中的斜杠命令（Slash Commands），将其划分为项目管理（如 /init、/memory）、分析洞察（/context、/insights）、代码质量（/review、/security-review）、会话效率（/compact、/export）及高级控制（/agents、/cost）五大类，逐一解读其核心功能与适用场景。

人工智能

编程语言

开发工具

掌握ClaudeCode斜杠命令，解锁AI编程新高度。从/init初始化到/cost成本控制，详解项目管理、代码审查、安全扫描等核心功能。学习自定义命令创建，打造专属开发工具链，提升编程效率。

漏洞扫描

日志文件

单元测试

中间件

智能体

Agent

2026采购季 | AI焕新·智启新局

message-queue-catalog

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

深入剖析 Claude Code 斜杠命令：从入门到自定义你的专属工作流-腾讯云开发者社区-腾讯云

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

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

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐