Claude Code 的命令系统是其可定制化的核心。通过 15 个 Frontmatter 字段，你可以精细定义自定义斜杠命令的行为、模型、权限和生命周期。同时，Claude Code 内置了 80 个斜杠命令，按功能可分为 Auth、Config、Context、Debug、Export、Extensions、Memory、Model、Project、Remote、Session 共 11 大类，覆盖了从会话管理、模型切换到远程协作的完整工作流。掌握这些字段和命令，是从基础使用迈向高效结构化 Agentic 工程的关键一步。

Claude Code Commands 指南：15 个 Frontmatter 字段 + 80 个内置命令分类

命令是 Claude Code 交互的入口，也是构建自动化工作流的基石。本文将系统介绍命令的定制字段与内置命令分类，帮助你快速查找与应用。

1. 定制命令：15 个 Frontmatter 字段详解

自定义命令位于项目的 .claude/commands/ 目录下，以 Markdown 文件形式存在。文件头部的 YAML frontmatter 定义了命令的元数据和行为。

以下表格列出了所有 15 个可用的配置字段：

Field	Type	Required	Description
`name`	string	No	显示名称和 `/slash-command` 标识符。如果省略，则默认为目录名。
`description`	string	Recommended	命令功能描述。在自动补全中显示，并供 Claude 用于自动发现。
`when_to_use`	string	No	额外上下文，用于说明 Claude 应在何时调用此命令——触发短语或示例请求。追加到 `description` 中，并计入 1,536 字符的上限。
`argument-hint`	string	No	自动补全时显示的提示（例如 `[issue-number]`, `[filename]`）。
`arguments`	string/list	No	用于在命令内容中进行 `$name` 替换的命名位置参数。接受空格分隔的字符串或 YAML 列表——名称按顺序映射到参数位置。
`disable-model-invocation`	boolean	No	设置为 `true` 可防止 Claude 自动调用此命令。
`user-invocable`	boolean	No	设置为 `false` 可从 `/` 菜单中隐藏——命令将仅作为后台知识存在。
`paths`	string/list	No	限制此技能何时被激活的 Glob 模式。接受逗号分隔的字符串或 YAML 列表。设置后，Claude 仅在处理匹配模式的文件时才自动加载该技能。
`allowed-tools`	string	No	当此命令处于活动状态时，允许无需权限提示即可使用的工具。
`model`	string	No	运行此命令时使用的模型（例如 `haiku`, `sonnet`, `opus`）。
`effort`	string	No	调用时覆盖模型的努力级别（`low`, `medium`, `high`, `xhigh`, `max`）。
`context`	string	No	设置为 `fork` 可在隔离的子代理上下文中运行命令。
`agent`	string	No	当设置 `context: fork` 时，指定子代理类型（默认：`general-purpose`）。
`shell`	string	No	用于 !`command` 块的 shell——接受 `bash`（默认）或 `powershell`。需要设置 `CLAUDE_CODE_USE_POWERSHELL_TOOL=1`。
`hooks`	object	No	限定于此命令的生命周期钩子。

关键字段说明：

name 和 description：是命令被用户和 Claude 识别的基础。良好的描述能提升命令的可发现性。
when_to_use：为 Claude 提供何时应自动建议或调用该命令的明确指引，是实现智能触发的重要字段。
model 与 effort：允许你为特定命令强制指定使用更强大或更轻量的模型，并控制其“思考深度”，从而平衡效果与成本。
allowed-tools：与全局权限设置配合，实现命令级别的精细工具权限控制。
context: fork：这是实现复杂编排工作流的核心字段，它能让命令在一个独立的子代理会话中运行，避免污染主对话上下文。想深入了解如何用此字段构建工作流，可以参考这篇编排工作流实战指南。

2. 内置命令：80 个斜杠命令分类速查

Claude Code 内置了 80 个功能丰富的斜杠命令，按功能可分为以下 11 大类。掌握这些命令能极大提升你的日常使用效率。

认证与账户 (Auth)

管理登录状态与第三方云服务集成。

/login：登录 Anthropic 账户。
/logout：登出。
/setup-bedrock：配置 Amazon Bedrock 认证与模型。
/setup-vertex：配置 Google Vertex AI 认证与项目。
/upgrade：打开升级页面。

配置与界面 (Config)

调整 Claude Code 的外观、行为与交互模式。

/config：打开设置界面。
/permissions：管理工具权限规则。
/theme：切换颜色主题。
/focus：切换聚焦视图，减少视觉干扰。
/sandbox：切换沙盒模式。
/tui [default|fullscreen]：设置终端 UI 渲染器。

上下文与用量 (Context)

查看当前会话的状态、上下文使用情况与成本。

/context：以彩色网格可视化当前上下文使用情况。
/usage：显示会话成本、计划用量限制和活动统计（/cost 和 /stats 是其别名）。
/status：打开设置界面的状态标签页，显示版本、模型、账户和连接性。

调试与帮助 (Debug)

用于诊断问题、获取帮助和探索功能。

/doctor：诊断并验证 Claude Code 安装和设置。
/help：显示帮助和可用命令。
/powerup：通过快速交互式课程发现 Claude Code 功能。
/tasks：列出和管理后台任务。

导出与分享 (Export)

将会话内容导出或复制。

/copy [N]：复制最后一个助手回复到剪贴板（可指定第 N 个）。
/export [filename]：将当前对话导出为纯文本。

扩展与集成 (Extensions)

管理子代理、技能、钩子、MCP 服务器等扩展系统。

/agents：管理代理配置。
/skills：列出可用技能。
/hooks：查看工具事件的钩子配置。
/mcp：管理 MCP 服务器连接和 OAuth 认证。
/plugin：管理 Claude Code 插件。

记忆 (Memory)

管理 CLAUDE.md 记忆文件。

/memory：编辑 CLAUDE.md 记忆文件，启用或禁用自动记忆。

模型与规划 (Model)

切换模型、调整努力级别或进入规划模式。

/model [model]：选择或更改 AI 模型。
/effort [level]：设置模型努力级别。
/plan [description]：直接从提示符进入计划模式。
/fast [on|off]：切换快速模式。

项目管理 (Project)

与项目仓库交互，初始化项目或进行代码审查。

/init：使用 CLAUDE.md 指南初始化项目。
/diff：打开交互式差异查看器，显示未提交的更改。
/review：在当前会话中本地审查拉取请求。
/security-review：分析当前分支上待处理的更改，查找安全漏洞。
/ultrareview [PR]：在云沙盒中对给定 PR 进行深度、多代理代码审查。

远程与协作 (Remote)

连接云端会话、设置定时任务或集成外部服务。

/schedule [description]：创建、更新、列出或运行例程。
/teleport：将一个 Claude Code on the web 会话拉到此终端。
/autofix-pr [prompt]：生成一个在 web 上监控当前分支 PR 的 Claude Code，并在 CI 失败或审阅者留下评论时推送修复。
/remote-control：使此会话可从 claude.ai 进行远程控制。

会话管理 (Session)

管理当前对话的生命周期。

/clear：开始新的对话（空上下文），之前的对话可在 /resume 中找到。
/compact [instructions]：压缩对话，并可添加焦点指令。
/goal [condition|clear]：设置一个目标——Claude 会持续工作直到条件满足。
/resume [session]：按 ID 或名称恢复对话，或打开会话选择器。
/rewind：将对话和/或代码倒回到之前的某个时间点。
/background [prompt]：将当前会话分离为后台代理并释放此终端。

3. 高级应用：`weather-orchestrator` 命令示例

理解字段的最佳方式是查看实际应用。以下是一个名为 weather-orchestrator 的自定义命令示例，展示了如何通过 frontmatter 配置实现一个复杂的编排工作流。

---
name: weather-orchestrator
description: 编排天气查询工作流，协调多个专用代理获取并整合天气信息。
when_to_use: 当用户需要详细的、多来源的天气分析或预报时。
context: fork
agent: general-purpose
model: opus
effort: high
allowed-tools: bash, web-search
hooks:
  pre-run: echo "Starting weather orchestration..."
  post-run: echo "Weather analysis complete."
---
用户需要天气信息：$ARGUMENTS

请按照以下步骤操作：
1.  使用 `web-search` 工具查询主要天气服务（如 OpenWeatherMap）的预报数据。
2.  启动一个子代理，使用 `bash` 工具运行本地天气数据收集脚本（如果存在）。
3.  综合所有数据，生成一份包含温度、湿度、风速、降水概率和未来24小时趋势的简明报告。

此示例的关键配置解读：

context: fork 与 agent：命令将在一个独立的子代理上下文中运行，防止主对话被繁杂的天气数据查询过程干扰。
model: opus 与 effort: high：强制使用最强大的模型和最高努力级别，确保复杂的编排逻辑和数据分析质量。
allowed-tools：明确授权 bash 和 web-search 工具，避免执行时出现权限提示。
hooks：定义了命令执行前后的生命周期钩子，用于日志或通知。
$ARGUMENTS：通过 arguments 字段（此处隐式定义）或用户输入，将查询内容（如“北京明天天气”）动态注入命令正文。

这个例子展示了命令如何将多个模型能力（工具调用）、代理系统（子代理）和生命周期管理（Hooks）编排在一起，形成一个端到端的自动化工作流。这种模式是构建复杂 Agentic 工程的核心，更多关于命令、代理和技能之间的架构模式，可以查阅Command → Agent → Skill 架构详解。

FAQ

Q: 15 个 Frontmatter 字段中，哪些是必须设置的？ A: 没有字段是严格必需的。但 description 被强烈推荐设置，因为它影响命令的可发现性和 Claude 的理解。name 如果省略则会使用文件目录名。

Q: 内置的 80 个命令中，哪些对日常开发最常用？ A: 这取决于工作流。通常 /model、/diff、/compact、/clear、/help 和 /usage 是高频使用命令。对于代码审查，/review 和 /ultrareview 非常关键。

Q: 如何为我的自定义命令选择合适的 model 和 effort？ A: 简单的文本格式化或查询命令可用 haiku 或 sonnet 配 low 功夫。复杂的分析、规划或代码生成任务，建议使用 sonnet 或 opus 配 medium 或 high 功夫。对于关键编排任务（如示例），可考虑 opus 配 high 以确保可靠性。

Claude Code Commands 指南：15 个 Frontmatter 字段 + 80 个内置命令分类 #

1. 定制命令：15 个 Frontmatter 字段详解 #

2. 内置命令：80 个斜杠命令分类速查 #

认证与账户 (Auth) #

配置与界面 (Config) #

上下文与用量 (Context) #

调试与帮助 (Debug) #

导出与分享 (Export) #

扩展与集成 (Extensions) #

记忆 (Memory) #

模型与规划 (Model) #

项目管理 (Project) #

远程与协作 (Remote) #

会话管理 (Session) #

3. 高级应用：weather-orchestrator 命令示例 #

FAQ #