Claude Code How-To Guide

Claude How To

Slash Commands 指南

slash commands 是你在 Claude Code 里最容易立即上手的能力。它们本质上是“用 /command 快速触发某个操作或工作流”。

对新手来说，先学会 slash commands，通常比先碰 hooks、MCP 或 plugins 更有回报，因为：

  • 安装简单
  • 反馈快
  • 更容易理解 Claude Code 的工作方式
  • 很多常用工作流都能先用它起步

什么是 slash commands

Claude Code 里的 slash commands 大致分四类：

  • Built-in commands：Claude Code 自带的命令，如 /help、/clear、/model
  • Skills 形式的命令：通过 SKILL.md 定义，仍然可以用 /name 调用
  • Plugin commands：安装 plugin 后带来的命令
  • MCP prompts：由 MCP server 暴露出来的命令

现在更推荐用 skills 来承载自定义命令。.claude/commands/ 依然能用，但新项目更建议看 03-skills。

先知道这几个高频命令

命令 用途
/help 查看帮助和命令列表
/clear 清空当前会话
/compact [instructions] 按可选指令压缩对话；v2.1.216+ 起压缩失败会在界面明确报错，不再静默无反应
/config 查看或编辑设置
/statusline 配置终端底部的自定义状态栏
/context 看上下文使用情况；v2.1.216+ 起超过 context window 上限时会显示明确警告
/doctor 诊断安装、配置和 plugin 健康状态；v2.1.178+ 起界面改成 flat tree，状态图标更清楚
/feedback / /bug 提交反馈；v2.1.178+ 起 /bug 必须填写描述后才能提交
/model 切换模型；v2.1.153+ 起默认保存为后续 session 默认值，选择后按 s 才只作用于当前 session
/effort [low|medium|high|xhigh|max|auto] 用交互滑杆调整思考强度；Opus 5 默认是 high，支持 low 到 max
/fast 切换 Fast Mode；v2.1.219+ 只适用于 Opus 5 和 Opus 4.8
/agents 查看可用 agents
/skills 查看可用 skills
/hooks 查看 hooks
/mcp 管理 MCP
/plugin 管理 plugins
/plan 进入 planning mode
/cd <path> 切换当前 session 的工作目录，并尽量保留 prompt cache
/focus 切换 focus view，减少长任务时的视觉干扰
/goal <目标> 给当前 session 注册一个持续追踪的完成目标
/fewer-permission-prompts 分析常见 Bash / MCP 调用，帮你生成更合理的 allowlist
/deep-research <topic> 深入研究指定主题；v2.1.218+ 起只会在用户显式调用时运行
/code-review [effort] 审查当前 diff 的正确性缺陷；可传入 /code-review high 这类 effort 参数；v2.1.215+ 起仅显式调用，v2.1.218+ 起在后台 subagent 中运行
/dataviz 图表和 dashboard 设计指导，并附带可运行的调色板校验器（v2.1.198+）
/review <pr> 审查 GitHub PR；v2.1.186+ 起使用和 /code-review medium 相同的 review engine，本地 diff 仍优先用 /code-review
/proactive /loop 的别名
/recap 回来继续 session 时，快速看一眼刚刚做了什么
/sandbox 切换 sandbox 模式
/powerup 用交互式 lesson 了解内建能力
/rewind 回退到 checkpoint
/undo /rewind 的别名
/resume 恢复以前的 session；无参数时会打开历史 session picker，并把选中的 session 作为后台 session 恢复（v2.1.212+）
/fork [prompt] 把当前对话复制成一个独立后台 session；两边从此各自推进，结果不会回传当前对话（v2.1.212+）
/subtask <task> 启动继承完整对话的 forked subagent；完成后把结果回传当前对话（v2.1.212+）
/branch [name] 切换到当前对话的副本并保留原对话，之后可用 /resume 返回
/reload-skills 重新扫描 skill 目录，不需要重启当前 session
/workflows 查看正在运行和已完成的 dynamic workflows
/scroll-speed <+N|-N> 调整 TUI live preview 的鼠标滚轮滚动速度
/team-onboarding 生成一份适合新同事的 Claude Code 上手说明
/tui 切换全屏 TUI（Text User Interface）模式
/ultraplan 先产出详细计划，再在浏览器中审阅
/ultrareview 用云端多代理做一轮更重的综合代码审查
/usage 查看 plan 用量、限流状态和成本；v2.1.149+ 起成本视图会按类别拆分
/usage-credits 配置额外用量额度；/extra-usage 仍可作为 alias（别名）使用

这些命令不用安装，开箱即用。

/cd <path> 是 v2.1.169+ 新增的实用入口。以前中途换目录往往会让 prompt cache 变冷，下一轮更慢也更贵；现在需要在同一个 session 里从前端目录切到后端目录时，优先用 /cd，不要为了换目录手动重开一轮。

/fork、/subtask 和 /branch 现在是三种不同操作：/fork 创建独立后台 session，/subtask 委派一个会回传结果的 forked subagent，/branch 则让你本人切换到对话副本。/fork 只有在 v2.1.77 到 v2.1.161 之间曾是 /branch 的 alias；从 v2.1.161 到 v2.1.211，它执行的是如今 /subtask 承担的行为。关闭 agent view 时，/subtask 不可用，/fork 会保留旧的 forked-subagent 行为。

独立的 /output-style 已在 v2.1.91 移除（v2.1.73 起弃用）。现在请从 /config 的 Output style 选项切换，或设置 outputStyle。

截至 2026 年 5 月，上游内建命令已经到了 60+，并且部分命令会继续改名或调整默认行为。这里保留的是中国小白最该先掌握的一批。

本目录里的示例命令

文件 触发方式 用途
optimize.md /optimize 分析性能与优化机会
pr.md /pr 提交 PR 前的整理与检查
generate-api-docs.md /generate-api-docs 生成 API 文档
commit.md /commit 生成提交说明
push-all.md /push-all stage + commit + push
doc-refactor.md /doc-refactor 文档重构
setup-ci-cd.md /setup-ci-cd CI/CD 初始化
unit-test-expand.md /unit-test-expand 扩充测试覆盖

怎么安装

安装全部示例命令

mkdir -p .claude/commands
cp 01-slash-commands/*.md .claude/commands/

安装单个命令

mkdir -p .claude/commands
cp 01-slash-commands/optimize.md .claude/commands/

然后在 Claude Code 中直接输入：

/optimize

command 文件里哪些不能翻

这一点非常重要。*.md 里的说明文字可以中文化，但这些内容不要翻：

  • frontmatter key，例如 description、allowed-tools
  • 真实命令名，例如 /optimize
  • Bash(...) 权限约束
  • 代码块里的可执行命令

例如 pr.md 里的这些行必须保留：

  • allowed-tools:
  • Bash(git add:*)
  • Bash(git status:*)
  • Bash(git diff:*)

在 prompt 中引用文件

在 command 或 skill 的 prompt 里写 @path/to/file，可以把目标文件内容按需带入上下文。适合引用模板、需求文档或局部代码，不必把整份内容复制进 command 文件。

动态值同样要保留原样：

  • $ARGUMENTS、$0、$1：接收调用参数
  • !`command`：先执行 shell 命令，再把输出注入 prompt
  • ${CLAUDE_PROJECT_DIR}：解析为项目根目录的绝对路径（v2.1.196+）

这些写法是解析语法，不要翻译变量名、符号或路径。

推荐你先用哪几个

如果你是第一次认真用 Claude Code，优先试这几个：

/optimize

适合你想让 Claude 帮你看性能问题、内存问题、算法改进时。

/pr

适合你准备发 PR 前做一次结构化检查，顺手整理提交信息。

/generate-api-docs

适合后端或接口项目，尤其是你已经有一些固定的接口风格想统一输出文档时。

/ultraplan

适合复杂任务。它会先帮你产出更完整的计划，再进入浏览器审阅或继续执行，特别适合多文件改动和高风险任务。

/team-onboarding

适合团队刚开始把 Claude Code 用进项目时。它会根据你当前项目里的 CLAUDE.md、skills、subagents、hooks 等实际配置，生成一份给新同事看的 ramp-up guide。

如果你已经把仓库的协作方式写进了 memory，这个命令会特别省时间。

2026 年 5 月这批命令变化，最值得知道什么

  • /pr-comments 已移除；现在更推荐直接让 Claude 查看 PR 评论
  • /vim 已移除；编辑器模式改从 /config 里设置
  • /powerup 新增，用交互式 lesson 带你认识 Claude Code 的能力
  • /tui 新增，适合 tmux / 全屏终端里的无闪烁 TUI 模式
  • /focus 新增，用来切换只显示重点输出的 focus view
  • /recap 新增，适合回来继续旧 session 时快速补上下文
  • /undo 新增，作为 /rewind 的别名
  • /proactive 新增，作为 /loop 的别名
  • /ultrareview 新增，用云端多代理做综合代码审查
  • /fewer-permission-prompts 新增，会分析常见 Bash / MCP 调用并帮你减少重复权限提示
  • Claude Opus 5（claude-opus-5、1M context）现在是默认 Opus 模型，默认 effort 为 high，支持 low 到 max
  • /fast 从 v2.1.219+ 起只适用于 Opus 5 和 Opus 4.8；Opus 4.6 / 4.7 不再是 Fast Mode 目标
  • ultracode 不是模型 effort level；它会发送 xhigh 并让 Claude 编排 dynamic workflows
  • Auto Mode 现在用 --permission-mode auto 直接启动；--enable-auto-mode 已在 v2.1.111 移除
  • /team-onboarding 新增，适合自动生成团队上手说明
  • /ultraplan 新增，适合端到端计划工作流
  • /schedule 更偏向 Cloud scheduled tasks，不再只是本地提醒
  • /init 的交互增强模式现在更常见的写法是 CLAUDE_CODE_NEW_INIT=1
  • /goal 新增，会把“这轮什么时候算完成”变成一个显式的 session 目标
  • /scroll-speed 新增，用来调 TUI live preview 的滚动速度，设置会按机器持久化
  • /usage-credits 成为额外用量配置的主名称；旧的 /extra-usage 仍然能用，但新文档建议写新名字
  • /model 现在默认保存为后续 session 默认值；如果只想影响当前 session，选中后要按 s
  • /reload-skills 新增，用来重新扫描 skill 目录
  • /workflows 新增，用来查看 dynamic workflows 的运行记录
  • /simplify 在 v2.1.154+ 后重新成为独立的清理型命令；如果要找正确性缺陷，仍然用 /code-review
  • /deep-research 从 v2.1.218+ 起仅显式调用；/code-review 同版本起在后台 subagent 中运行，不占满主对话
  • /doctor 在 v2.1.178+ 刷新为 flat tree 布局，状态图标更容易扫读
  • /bug 在 v2.1.178+ 需要先写描述，避免空反馈误提交
  • /review <pr> 在 v2.1.186+ 起不再按“已废弃”理解；它用于审查 GitHub PR，并复用 /code-review medium 的 review engine。要审查当前本地工作区 diff，继续用 /code-review [effort]
  • /dataviz 在 v2.1.198+ 成为 bundled skill，用于图表、dashboard 和调色板设计
  • ${CLAUDE_PROJECT_DIR} 在 v2.1.196+ 可用于 command / skill prompt，表示项目根目录绝对路径
  • v2.1.212+ 中，/fork [prompt] 创建独立后台 session，/subtask <task> 启动会回传结果的 forked subagent，/branch [name] 则切换到当前对话副本
  • /resume 无参数时会打开历史 session picker，其中也包括已从 Agent View 可见列表移除的 session；选中后会作为后台 session 恢复

slash commands 和 skills 的关系

很多人一开始会混：

  • slash commands：更像“我主动输入一个命令，触发一个固定动作”
  • skills：更像“Claude 在合适的时候自动调用的复用能力”

简单理解：

  • 想自己明确触发：先用 slash commands
  • 想让 Claude 自动判断是否该启用：再考虑 skills

什么时候该升级成 skill

如果你发现某个 slash command 出现这些情况，就可以考虑迁移到 skill：

  • 你在多个项目里都要重复用
  • 它不只是一个短 prompt，还依赖脚本、模板、参考文档
  • 你希望 Claude 在合适场景下自动调用，而不是每次手动输入

下一步可以看 03-skills。

常见坑

1. 文件放对了，但命令不生效

优先检查：

  • 路径是不是 .claude/commands/
  • 文件扩展名是不是 .md
  • frontmatter 格式是不是正确

2. 翻译后命令坏了

最常见是把这些东西翻译掉了：

  • description
  • allowed-tools
  • /command-name

3. 以为 command 和 skill 是两套完全不同的东西

不是。现在推荐实践是更偏向 skill，只是调用方式和使用时机不同。

4. 看到旧资料还在用 /pr-comments 或 /vim

这类写法大多已经过时。遇到老截图、老博客时，优先以当前版本的 /help 和官方 CLI 行为为准。

5. /color 现在支持无参数随机配色

从 v2.1.128 开始：

  • 直接输入 /color：会随机给当前 session 选一个颜色
  • 输入 /color <name|hex>：仍然是明确设置指定颜色

如果你在旧资料里看到“/color 必须带参数”的说法，现在优先以新版行为为准。

推荐下一步

← Previous
Claude Code 概念总览
Next →
Commit / 提交改动

Content rendered from Slash Commands 指南 on GitHub. Markdown is the single source of truth — re-run scripts/build_website.py after editing to refresh the site.