Appearance
Claude Code 的 Slash Commands(斜杠命令)是开发者与 AI 高效互动的核心入口,涵盖 55+ 内置命令和可扩展的自定义技能(Skills)。本文系统梳理常用 Slash Commands 的分类和用法,提供可复制的自定义 Skill 模板,并详解 $ARGUMENTS、! 动态上下文、@ 文件引用等强大特性。无论你是新手还是进阶用户,都能通过本指南快速上手、灵活扩展 Claude Code 的能力。
Claude Code Slash Commands 完整参考:55+ 内置命令 + 自定义技能
Claude Code 的 Slash Commands(斜杠命令)为开发者提供了高效控制 AI 助手的“快捷键”。你可以通过输入 /命令名 快速切换模式、管理会话、调用工具,或执行自定义的自动化任务。Slash Commands 包含三大类:内置命令、自定义技能(Skills) 和 插件/扩展命令。本文将带你系统掌握高频命令、场景化用法及自定义扩展方法。
如果你首次接触 Claude Code,建议先阅读 Claude Code 完全入门:从安装到掌握核心功能,了解基础概念和环境配置。
1. Slash Commands 是什么?能解决哪些问题?
Slash Commands 是 Claude Code 会话中的“斜杠快捷指令”,用于:
- 快速切换模型、清理上下文、查看 token 消耗等常规操作
- 一键执行代码优化、PR 检查、API 文档生成等自动化任务
- 通过自定义 Skill,扩展 AI 助手的能力,实现团队知识库、专属工作流等高级用法
Slash Commands 统一入口、语法简单,极大提升了 AI 协作的效率和可扩展性。
2. 高频内置命令速查表(按场景分类)
Claude Code 内置了 55+ 常用 Slash Commands,以下按典型开发场景分类,便于查找与记忆:
会话管理与上下文
| 命令 | 作用说明 |
|---|---|
/help | 查看所有命令及帮助文档 |
/clear | 清空当前会话(别名:/reset, /new) |
/branch [name] | 会话分支,开启新分支(v2.1.77 起替代 /fork) |
/context | 可视化上下文窗口使用情况 |
/compact [说明] | 精简会话内容,聚焦指定主题 |
/memory | 编辑/切换持久上下文(见 CLAUDE.md 深度指南) |
模型与执行环境
| 命令 | 作用说明 |
|---|---|
/model [模型名] | 切换 Claude 模型,支持快捷选择 |
/effort [等级] | 设置推理深度(low/medium/high/max/auto) |
/sandbox | 切换沙盒模式,隔离危险操作 |
/desktop | 切换到桌面端应用(别名:/app) |
代码与项目操作
| 命令 | 作用说明 |
|---|---|
/diff | 交互式查看未提交代码变更 |
/commit | 基于当前变更生成 Git commit(可自定义 Skill) |
/pr-comments [PR] | 获取指定 PR 的评论信息 |
/review | 已废弃,推荐使用 code-review Skill |
/generate-api-docs | 自动生成 API 文档(可自定义 Skill) |
/unit-test-expand | 覆盖未测试分支,提升测试覆盖率 |
工具与集成
| 命令 | 作用说明 |
|---|---|
/plugin | 管理插件扩展(详见 Claude Code Plugins) |
/mcp | 管理 MCP 服务器和 OAuth,访问外部服务 |
/hooks | 查看/配置自动化钩子(详见 Hooks 完全指南) |
/skills | 列出所有可用自定义技能 |
提示:在 Claude Code 输入
/,可自动补全和筛选全部命令。
3. 自定义 Slash Command(Skill)创建方法
自定义技能(Skills)是 Slash Commands 的推荐扩展方式。相比旧版 .claude/commands/,Skills 支持更丰富的目录结构、自动触发、权限控制等高级特性。详细原理可参考 Claude Code Skills 体系详解。
步骤一:新建 Skill 目录与文件
bash
mkdir -p .claude/skills/my-command
touch .claude/skills/my-command/SKILL.md步骤二:编写 SKILL.md(含前置元数据)
yaml
---
name: my-command
description: 用于快速生成团队规范化的 Git commit
argument-hint: [message]
allowed-tools: Bash(git *), Read
disable-model-invocation: true # 仅允许用户手动调用
---
# Git Commit 生成器
## 动态上下文
- 当前分支: !`git branch --show-current`
- 变更内容: !`git diff HEAD`
- 最近提交: !`git log --oneline -5`
## 操作说明
如果用户输入了 commit 信息,则直接使用:$ARGUMENTS
否则,请根据变更内容自动生成符合 Conventional Commits 规范的 commit message。说明:
name字段决定 Slash Command 的名称(如/my-command)。argument-hint可提示命令行参数。allowed-tools控制可用外部工具,保障安全。disable-model-invocation设为true时,Claude 不会自动触发,仅用户可用。
4. 进阶特性与代码示例
4.1 动态参数:$ARGUMENTS / $0 / $1
场景:命令支持参数输入,便于复用。
yaml
---
name: fix-issue
description: 修复指定编号的 GitHub issue
---
修复 issue #$ARGUMENTS,需严格遵循团队代码规范。用法:/fix-issue 123 → $ARGUMENTS = "123"
多参数示例:
yaml
---
name: review-pr
description: 审查指定 PR,带优先级
---
请以 $1 优先级审查 PR #$0。用法:/review-pr 456 high → $0="456", $1="high"
4.2 动态上下文采集:!shell 命令
场景:Skill 执行前自动获取最新项目状态,提高指令智能性。
yaml
---
name: commit
description: 基于当前变更生成 Git commit
allowed-tools: Bash(git *)
---
- 当前状态: !`git status`
- 变更详情: !`git diff HEAD`
- 当前分支: !`git branch --show-current`
请基于以上信息生成 commit message。
!语法会在 Skill 执行前运行 shell 命令,将输出结果嵌入上下文。
4.3 文件内容引用:@文件路径
场景:让 Claude 直接读取并分析项目文件,无需手动粘贴。
markdown
请审查 @src/utils/helpers.js 的实现,并对比 @src/old-version.js 和 @src/new-version.js 的差异。
@语法会自动插入指定文件内容,适合代码审查、文档生成等场景。
5. 插件命令与 MCP 扩展
- 插件命令:安装插件后,可用
/插件名:命令名或/命令名(无重名时)调用扩展功能。例如/frontend-design:frontend-design。 - MCP 命令:通过
/mcp__github__list_prs、/mcp__jira__create_issue等方式,直接访问外部系统(详见 MCP 实战指南)。
6. 常见问题与注意事项
Q: Skill 和旧版 command 有冲突时,哪个生效?
A: 同名时,Skill 优先生效。建议迁移到 .claude/skills/,避免混用。
Q: 为什么自定义命令无法被 Claude 自动触发?
A: 检查 disable-model-invocation 是否为 true,如需 AI 自动调用请设为 false 并完善 description 字段。
Q: 动态上下文/文件引用失败?
A: 确认 allowed-tools 配置正确,且文件路径无误。部分命令需本地环境支持。
7. 进阶学习与最佳实践
- Skill 设计建议:保持单一职责、描述清晰,避免硬编码敏感信息。可参考 blog-draft skill 实战 和 code-review skill。
- 自动化工作流:结合 Subagents、Hooks、Plugins 进一步扩展团队协作能力。
- 会话与上下文管理:善用
/memory和 CLAUDE.md,实现多层持久记忆(详见 CLAUDE.md 深度指南)。
结语:
Slash Commands 是 Claude Code 高效开发的“万能入口”。通过灵活调用内置命令和自定义 Skill,你可以极大提升 AI 协作效率,实现专属的智能开发环境。建议将常用命令整理为团队技能库,持续优化工作流。
FAQ
Q: Claude Code 支持多少种内置 Slash Commands? A: 官方文档列出 55+ 内置命令,涵盖会话、模型、代码、集成等全场景。
Q: 自定义 Skill 和插件命令可以共存吗? A: 可以。Skill 优先级高于旧版 command,插件命令无重名时可直接用 /命令名 调用。
Q: 如何让 Claude 自动识别并调用我的自定义命令? A: 在 Skill 的 description 字段中明确触发条件,并保持 disable-model-invocation: false(默认值)。
如需进一步探索,建议查阅 Claude Code Skills 体系详解 及 Claude Code 高级功能全解。