Mascot Logo
ai-agents-tutorial

Part 2 · 第 7 课,共 16 课

Claude Code 斜杠命令

你的第一个 /command。动手创建一个自定义命令。

12 min

第 1 步 / 共 6 步 · 什么是斜杠命令?

在 Claude Code 会话中,你大多时候用通俗的自然语言与智能体交谈。但有些操作是关于控制会话本身的——清空上下文、切换模型、打开设置——这类操作你并不希望模型去“思考”,而是希望它立即执行。

这就是斜杠命令的用途。斜杠命令是以 / 开头、立即执行的特殊指令。它只在消息的开头才会被识别,命令名之后的文字会作为参数传给它。单独输入 / 就能看到所有可用命令。

第 2 步 / 共 6 步 · 核心内置斜杠命令

Claude Code 内置了一长串命令。作为初学者,你最常用到的是这些:

  • /help:显示帮助和可用命令列表。
  • /clear:以空白上下文开启一段全新对话。(别名:/reset/new。)
  • /compact:在同一段对话中,通过总结此前的内容来释放上下文空间。
  • /context:可视化当前上下文窗口的占用情况。
  • /config:打开设置,修改主题、模型等偏好。
  • /init:生成一个起始的 CLAUDE.md,让智能体理解你的项目。
  • /agents:管理可供 Claude 委派子任务的子智能体(subagents)。
  • /model:切换本次会话使用的 AI 模型。
  • /exit:退出 CLI。(别名:/quit。)

第 3 步 / 共 6 步 · 尝试运行 /help 命令

让我们运行第一个斜杠命令。打开终端,进入你的 playground 文件夹,然后启动 Claude Code:

claude

当提示符准备就绪后,输入:

/help

按回车。你会立即看到所有可用命令与本次会话快捷键的格式化列表——完全不需要经过 AI 的一轮往返。

第 4 步 / 共 6 步 · 重置上下文 vs 压缩上下文

随着对话变长,Claude 会带着你说过的一切。过长的聊天会吞噬上下文 tokens,使智能体变慢、变贵。针对这一点你有两个截然不同的工具,而人们经常把它们搞混:

  • /clear(别名 /reset/new)会清空一切,以空白上下文开启一段全新对话——当你切换到一个无关的新任务时最为合适。你的项目记忆(CLAUDE.md)会保留,聊天历史不会。
  • /compact 让你停留在同一段对话中,但把冗长的历史替换为关键事实的简短摘要,在保留你思路的同时腾出空间。

一个简单的法则:切换任务 → /clear;同一任务、空间不足 → /compact

/compact

第 5 步 / 共 6 步 · 动手创建你自己的命令

真正的威力在于编写你自己的命令。在 Claude Code 中,自定义命令其实就是 .claude/commands/ 目录下的一个 Markdown 文件,文件名即命令名。

在你的项目中创建文件 .claude/commands/review.md

审查已暂存(staged)的 git 改动,找出 Bug、含义
不清的命名以及缺失的测试。以简短清单列出发现的
问题——不要修改任何文件。

然后,在该项目的 Claude Code 会话中运行:

/review

Claude 会执行该文件中的指令,就像你亲手输入了一样。命令名之后的内容会作为参数传入,因此你可以编写接收输入的命令。自定义命令如今已并入更广义的**技能(skills)**体系(.claude/skills/review/SKILL.md 能实现同样的效果)——但单个 .claude/commands/*.md 文件是最快的起步方式。

第 6 步 / 共 6 步 · 检查点与本节回顾

本节回顾

  • 斜杠命令是以 / 为前缀的即时会话控制指令,只在消息开头才被识别。
  • /help 列出所有命令;/context 显示上下文窗口的占用。
  • /clear(别名 /reset)开启全新对话;/compact 总结当前对话以腾出空间。
  • 自定义命令就是 .claude/commands/ 下的一个 Markdown 文件——文件名就是那个 /command

常见问题

如何重置 Claude Code 的上下文?

运行 /clear(也可用 /reset/new)。它会以空白上下文开启一段全新对话,同时保留项目的 CLAUDE.md 记忆。如果你想停留在同一段对话中、只是腾出空间,则使用 /compact——它会总结历史而不是丢弃它。

/clear/compact 有什么区别?

/clear 丢弃当前对话、从零开始,上下文清空。/compact 让对话继续,但把此前的历史压缩成简短摘要。切换到无关任务时用 /clear;深陷某个任务、上下文不足时用 /compact

如何在 Claude Code 中创建自定义斜杠命令?

在项目的 .claude/commands/ 目录下新增一个 Markdown 文件——例如 .claude/commands/review.md。文件名即命令名(/review),文件内容就是 Claude 要执行的指令。自定义命令属于技能体系,因此 .claude/skills/<名称>/SKILL.md 也能实现同样效果,并提供更多选项。

/bug 会修复 Bug 吗?

不会。/bug/feedback 的别名——它把一份关于 Claude Code 本身的 Bug 报告(附带会话上下文)提交给 Anthropic。要修复你自己代码里的 Bug,直接用自然语言描述给智能体即可。