Skip to content

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. 进阶学习与最佳实践


结语
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 高级功能全解