首页 / Claude Code 入门教程 / 斜杠命令

← 上一篇 下一篇 →
Claude Code 入门教程

斜杠命令

本教程共 34 篇 · 第 8 篇 · 更新于 2026-07-26 · 约 9 分钟阅读

Claude CodeClaude Code 入门教程斜杠命令Slash CommandsSkills命令行

8. 斜杠命令

本节目标：掌握 Claude Code 斜杠命令（Slash Command）的完整体系，知道有哪些命令可用、怎么分类、怎么自定义，以及三种前缀（/ ! @）的区别。

什么是斜杠命令

斜杠命令（Slash Command）是 Claude Code 交互式会话里的快捷控制入口。在输入框里打一个 / 开头的指令，就能快速切换模型、清空上下文、运行代码审查、管理会话，不用打一长串自然语言。

你可以把它想象成浏览器里的快捷键：按 Ctrl+T 新建标签页，比点菜单快得多。斜杠命令就是 Claude Code 的「快捷键」。

怎么查看所有命令

最简单的方式：在输入框里直接打一个 /，会弹出命令列表。输入更多字母可以筛选，按 Tab 补全。

如果想看完整说明，用这个：

/help

/help 会列出所有内置命令、当前项目的自定义命令（Skills / Commands），以及已连接 MCP 服务器暴露的命令。

Tip

命令只在你的消息开头被识别。命令名后面的文本会作为参数传给它。比如 /compact 保留数据库设计部分，「保留数据库设计部分」就是参数。

命令的三种前缀

除了 /，Claude Code 还有 ! 和 @ 两个前缀，功能完全不同。

前缀语法作用示例
//command触发内置命令或自定义 Skill / Command/review
!!shell命令直接执行 Shell 命令，绕过 AI 处理!git status
@@文件路径将文件内容注入当前上下文@src/api/users.ts

! 前缀特别实用。比如你想看 git 状态，直接在输入框打：

!git status

这比跟 Claude 说「帮我看看 git 状态」快得多，而且不消耗 token，因为绕过了 AI 处理，直接在终端执行。

@ 前缀用于精准引用文件：

对比 @src/auth/v1.ts 和 @src/auth/v2.ts 的实现差异

Claude 会自动读取这两个文件的内容，比手动粘贴代码更准确，还支持多文件。

Note

! 前缀执行的结果不会进入对话历史。如果你需要让 Claude 看到命令输出，应该直接用自然语言让它执行，或者把输出粘贴进去。

内置命令分类速查

Claude Code 自带了大量内置命令。我把它们按用途分成几类，你不用全记，知道哪类命令在哪找就行。

基础操作

命令用途
/help查看所有可用命令
/exit退出当前会话（别名 /quit）
/clear清除对话历史，开始全新会话（别名 /reset、/new）

/clear 和 /compact 是新手最容易搞混的两个命令，后面会详细说区别。

会话管理

命令语法用途
/compact/compact [侧重点]智能压缩对话，保留语义摘要
/resume/resume [id或名称]恢复历史会话（别名 /continue）
/rewind/rewind回滚到上一检查点（别名 /checkpoint、/undo）
/rename/rename [名称]为当前会话命名
/export/export [文件名]导出对话为文件
/copy/copy [N]复制最近一次回复到剪贴板
/btw/btw 问题插问一个临时问题，不污染主对话
/branch/branch [名称]在当前点创建对话分支

/btw 是个很贴心的命令。比如你在让 Claude 重构一个模块，突然想问一句「Redis 默认端口是多少」，用 /btw Redis 默认端口是多少？，Claude 会回答你，但这个问答不会加到主任务上下文里，不会干扰当前工作。

上下文与记忆

命令用途
/context可视化上下文窗口使用量
/memory编辑 CLAUDE.md 记忆文件
/add-dir <路径>添加额外工作目录
/diff查看本次会话的文件变更
/todos列出当前会话的 TODO

/context 是管理上下文的利器，它会用彩色网格显示当前上下文窗口里都装了什么：对话历史、文件内容、系统提示、Skills 各占多少。接近上限时就该 /compact 了。

项目与配置

命令用途
/init分析项目结构，自动生成 CLAUDE.md
/config交互式管理配置（别名 /settings）
/status查看版本、模型、账户状态
/permissions管理工具权限（别名 /allowed-tools）
/hooks配置生命周期钩子
/sandbox切换沙箱模式
/doctor诊断安装和配置问题

/init 是新项目第一步。它会扫描你的项目结构，自动生成一份 CLAUDE.md，写入技术栈、构建命令、代码规范等信息。

/doctor 遇到问题时特别有用。它会检查安装健康度、查找重复或遗留安装、检查 PATH 问题、标记缓慢的 hooks，还能帮你精简 CLAUDE.md 里多余的内容。

模型与输出

命令语法用途
/model/model [模型名]切换 AI 模型
/effort/effort [级别]调整推理工作量级别
/plan/plan [描述]进入计划模式
/config/config key=value直接设置配置项

/model 不带参数会弹出选择器，带参数直接切换。/effort 是控制 Claude 「想多久」的开关，可选 low、medium、high、xhigh、max，简单任务调低能省时间。

Tip

从 v2.1.181 开始，/config 支持直接传 key=value，比如 /config theme=dark 或 /config model=sonnet，不用再打开界面一步步点。

代码与工具

命令用途
/code-review审查当前差异，查找正确性错误
/simplify审查代码清理机会并应用修复
/security-review安全漏洞专项审查
/review对 GitHub PR 运行快速审查
/skills列出所有可用 Skills
/tasks查看后台任务（别名 /bashes）

/code-review 和 /security-review 是上线前必用的两个命令。/code-review 查逻辑错误和清理机会，/security-review 专门查 SQL 注入、XSS、敏感信息泄露等安全问题。

集成与扩展

命令用途
/mcp管理 MCP 服务器连接
/ide配置 IDE 集成
/plugin管理插件
/teleport将 Web 端会话拉到本地终端（别名 /tp）
/install-github-app安装 GitHub App 集成

统计与账户

命令用途
/usage查看用量和费用（别名 /cost、/stats）
/login登录账户
/logout注销账户
/release-notes查看版本更新日志
/feedback提交反馈或报告 Bug（别名 /bug、/share）

内置 Skills

除了内置命令，Claude Code 还附带了一批内置 Skills（技能）。两者都用 / 触发，但机制不同。

Note

内置命令 vs 内置 Skills

  • 内置命令（如 /clear、/compact）执行固定逻辑，不涉及 AI 推理，速度极快。
  • 内置 Skills（如 /debug、/batch）加载提示词后由 Claude 推理执行，结果更丰富，适合复杂分析任务。

常见的内置 Skills：

命令功能适用场景
/batch <指令>并行编排大规模更改跨代码库的大批量改动
/debug [描述]系统化根因分析定位难以复现的 bug
/loop [间隔] [提示]循环执行操作直到满足条件自动化 CI 修复循环
/run启动并驱动项目应用在运行的应用中验证改动
/verify构建应用并观察结果确认改动是否真正生效
/claude-api加载 Claude API 参考资料搭建 API 集成原型

/batch 是个很强大的 Skill。比如你说 /batch migrate src/ from Solid to React，它会研究代码库，把工作拆成 5-30 个独立单元，每个单元在独立的 git worktree 里由后台子代理执行，最后各自开一个 PR。

自定义命令

如果有重复使用的提示词，可以做成自定义命令，一键调用。

两种格式

Claude Code 支持两种自定义命令格式：

特性Skills（推荐）Commands（旧格式）
存储路径.claude/skills/<名称>/SKILL.md.claude/commands/<名称>.md
触发方式/名称 手动触发，或 Claude 自动触发/名称 仅手动触发
多文件支持支持，可附带模板、脚本单文件
自动触发支持，Claude 根据 description 判断不支持

新项目推荐直接用 Skills 格式，Commands 旧格式仍完全兼容。

创建一个自定义 Skill

以「代码性能优化」为例。

第一步，创建目录：

# 项目级 Skill（团队共享，纳入 git）
mkdir -p .claude/skills/optimize

# 个人级 Skill（跨项目通用，本地私有）
mkdir -p ~/.claude/skills/optimize

第二步，在目录里创建 SKILL.md：

---
name: optimize
description: 分析代码性能瓶颈，给出优化建议。当用户提到性能问题时自动触发。
allowed-tools: Read, Grep, Glob
argument-hint: [目标文件或目录]
model: claude-sonnet-4-6
---

分析以下代码的性能瓶颈，给出具体的优化建议，优先考虑时间复杂度和内存占用：
$ARGUMENTS

使用时输入：

/optimize src/utils/data-processor.ts

$ARGUMENTS 会被替换成你输入的参数。

Frontmatter 字段

自定义命令和 Skills 的顶部都可以加 YAML frontmatter 做精细配置：

字段说明
name触发命令名，Skills 必填
description功能描述，Skills 中用于自动触发判断
allowed-tools命令可使用的工具，匹配的无需人工确认
argument-hint参数格式提示，显示在 /help 列表
model强制指定模型，简单任务用 Haiku 降成本
contextfork 独立子代理运行，inline 当前会话内运行
disable-model-invocation为 true 时禁止编程调用
user-invocable为 false 时只允许 Claude 自动触发

allowed-tools 的写法很灵活：

allowed-tools: Read, Grep, Glob              # 组合多个工具
allowed-tools: Read(src/*)                   # 只允许读 src/ 目录
allowed-tools: Bash(git *:*), Bash(npm test:*)  # 限定 bash 子命令

MCP 命令

通过 MCP（Model Context Protocol）服务器连接的外部工具，也会变成斜杠命令。格式是：

/mcp__<服务器>__<命令> [参数]

比如连接了 GitHub MCP 服务器后：

/mcp__github__list_prs                          # 列出仓库 PR
/mcp__github__create_issue "Bug标题" high       # 创建 Issue

连接了 PostgreSQL：

/mcp__postgres__query "SELECT * FROM users LIMIT 10"

所有可用的 MCP 命令都在 /help 列表底部单独分组展示。

Tip

安装插件后，插件自带的命令格式通常是 /插件名:命令名，用冒号避免命名冲突。比如 Git 插件可能有 /git:commit 命令。

命令优先级

当同名命令出现时，按以下优先级决定哪个生效：

企业级 > 个人级 > 项目级 > 内置

也就是说，公司统一下发的命令优先级最高，其次是你个人的，然后是项目级的，最后才是内置的。这个设计保证了企业管控优先，同时个人和项目可以灵活定制。

典型工作流中的命令

官方文档把命令按工作流阶段做了梳理，这里分享给你：

首次在新项目中的会话。 先 /init 生成 CLAUDE.md，再 /memory 完善，用 /mcp 设置需要的 MCP 服务器，/permissions 配置权限规则。

任务执行期间。 大改动前用 /plan 进入计划模式。对话变长时 /context 看上下文占用，/compact 压缩释放空间。临时插问用 /btw。

并行工作。 /tasks 查看后台任务，/background 把整个会话转后台运行，/batch 拆分大规模改动。

发布前。 /diff 看改了什么，/code-review 查错误，/security-review 查安全漏洞。

出问题时。 /rewind 回滚到检查点，/doctor 诊断配置问题，/debug 排查运行时问题。

新手必记的 10 个命令

命令很多，但日常最常用的就这几个：

  1. /init - 新项目初始化
  2. /clear - 清空对话重来
  3. /compact - 压缩上下文省空间
  4. /model - 切换模型
  5. /context - 看上下文占了多少
  6. /review - 代码审查
  7. /rewind - 后悔了，回滚
  8. /help - 忘了命令查一下
  9. /diff - 看本次改了什么
  10. /usage - 看花了多少钱

记住这 10 个，日常开发基本够用了。其他的用到再查 /help。

上一篇
常见工作流
下一篇
CLI 命令行参考