Claude Code 全部斜杠命令详解：从 /usage、/clear 到 /agents

Q: /compact 和 /clear 怎么选？

`/compact` 压缩当前会话但保留摘要——做完一个阶段、想继续在同一任务里推进时用。`/clear` 直接清空对话保留 CLAUDE.md——切换到不相关的新任务时用。`/compact` 不带提示直接压会把重要的“已改文件清单”丢掉，养成 `/compact ` 的习惯。

Q: /usage 和 /status 显示的是什么？

`/usage` 偏当月 / 本会话的 token 消耗与剩余额度；`/status` 偏当前账号、模型、IDE 集成、登录状态那一摞诊断信息。token 用完时先 `/usage` 分清是这次会话用得多还是月配额到顶。

Q: 自定义命令放在哪里？

项目级放 `.claude/commands/ .md`，跟着 git 走；用户级放 `~/.claude/commands/ .md`，所有项目共享。命令文件就是 markdown，执行时把内容作为 prompt 插入。要带参数用 `$ARGUMENTS` 占位。

Q: /doctor 报 PATH 里有两个 claude 怎么办？

先在 shell 里 `which -a claude` 列出所有路径，确认哪个是真在跑的版本（通常是 `~/.claude/local/bin/claude` 或 `npm` 全局安装那个）。把不要的那个从 PATH 里去掉，或者直接 `rm` 掉旧的。

Claude Code 所有内置斜杠命令的完整指南：会话生命周期、用量成本、配置、subagent / hook / MCP 扩展、诊断与 IDE / git 集成命令。

发布于: 2026/05/21 作者: AI Productivity Guide Team 🌐 查看英文版本

这篇讲什么

Claude Code 所有内置斜杠命令的完整指南：会话生命周期、用量成本、配置、subagent / hook / MCP 扩展、诊断与 IDE / git 集成命令。

本文涉及的工具 / 概念：

Claude Code: Anthropic 推出的命令行 AI 编程 agent。
斜杠命令（slash command）: 在 Claude Code 输入框开头敲 /，会弹出可用命令菜单。
Skill / Subagent / Hook / MCP: 扩展 Claude Code 行为的四种机制。

这篇适合谁看

已经用过几天 Claude Code、但只会 /init 和 /clear、想搞清楚剩下那一长串命令到底干嘛的人。如果还没装好 Claude Code，先看 Claude Code 新手指南。

什么时候适合用

token 用完了，想分清是这一次会话用得多还是当月配额到顶。
上下文塞满了，要决定 /compact 还是 /clear。
想给团队配统一的 subagent / hook / MCP，但搞不清入口在哪里。
新装的 Claude Code 卡在登录、IDE、PATH，要做诊断。

开始前准备

进会话后直接敲 /，把当前版本支持的命令列一遍——不同版本、不同插件会差几条。
本文以最新稳定版为基准。如果某条命令在你这里不显示，多半是版本旧了或没装对应插件。
把”命令”和”skill”分清楚：命令是 Claude Code 内置的（核心功能），skill 是按需挂载的工作流（详见 Claude Code Skills 指南）。

会话生命周期

这一组管”一次对话”的开始、暂停、回收。日常用最多。

命令	作用	什么时候用
`/clear`	清空当前对话历史，保留 CLAUDE.md	一个任务做完了、开新任务前
`/compact`	把当前会话压成摘要继续	上下文快满了但还要往下做
`/compact 重点保留改过的文件和待办`	带提示的 compact	让它压的时候知道哪些必须留下
`/resume`	列出可恢复的历史会话	关了终端想接着做
`/export`	把当前对话导出到文件或剪贴板	留档、贴给同事、写复盘报告
`/status`	查看账号、模型、版本、工作目录	排查”是不是连错账号 / 跑错版本”
`/context`	查看上下文窗口被什么占住	在 `/compact` 之前先看看是谁在吃 token

/compact 后面带一段话是真正”会用”的人都会做的事。空压会把闲聊一起留下，定向压会优先保留”已改文件、关键决策、剩余待办”。

用量与成本

命令	作用	什么时候用
`/usage`	当前订阅（Pro / Max / Team）的用量、剩余配额、下一次重置时间	”我这个月还能用多少次 Opus？“
`/cost`	当前会话的 token 用量与按 API 计费的累计成本	API key 模式下，想看一次任务花了多少美元

/usage 是订阅制账号关心的命令（按次数与重置周期），/cost 是 API key 用户关心的命令（按 token 与美元）。两个不冲突，看你怎么登录。

项目记忆与初始化

命令	作用
`/init`	在当前项目根目录生成或更新 `CLAUDE.md`
`/memory`	打开 memory 编辑器，分项目级 / 用户级两种作用域

/init 跑一次足矣——后续要改就用 /memory，或者直接编辑 CLAUDE.md。在输入框开头打 # 也可以快速追加一条 memory。

配置与模型

命令	作用	什么时候用
`/config`	打开 Claude Code 设置面板	改主题、字体、自动接受、通知
`/model`	切换主模型	在 Opus / Sonnet / Haiku 之间选；macOS 上 `Option + P` 也行
`/vim`	切到 vim 模式输入	习惯 vim 的人编辑长 prompt 时
`/terminal-setup`	让 Claude Code 帮你配好终端键映射	`Shift + Enter` 不能换行、其它键无响应时
`/add-dir`	临时把另一个目录加进当前会话的工作根	跨仓库改动、把脚本目录拉进来一起改
`/permissions`	查看 / 修改当前权限规则（允许跑哪些 Bash、读哪些目录）	收紧或放开某条工具规则
`/privacy-settings`	打开隐私设置	关闭训练数据共享、调整数据保留策略

/permissions 是新手最容易忽略的命令。每次有人抱怨”Claude 又问我要不要跑 npm install”，答案多半是把 Bash(npm install) 加进 allow 列表。

内置审查工作流

命令	作用
`/review`	评审一个 PR 或当前 diff
`/security-review`	用安全视角审当前分支变更

这两条是 Anthropic 官方维护的工作流，不属于 skill 也不属于 hook，开箱即用。审 PR 时把 PR 号或 URL 跟在命令后面。

扩展系统：subagent / hook / MCP

这三条是 Claude Code 扩展性的核心。每条都是”通往一个子系统”的入口，里面的菜单单独是一套世界。

命令	作用	什么时候用
`/agents`	管理 subagent（创建、删除、查看可用列表）	想让”代码审查”或”测试编写”由一个独立人格做
`/hooks`	配置 hook（PreToolUse / PostToolUse / SessionStart 等）	自动化”每次跑命令前先 lint”、“会话开始时打开 README”
`/mcp`	管理 MCP server（连接、认证、查看可用工具）	把 Linear、Slack、Notion、自家数据库接进来

设计哲学：subagent 是”换个脑子”，hook 是”换个反射弧”，MCP 是”换个外部世界”。三者经常组合使用——比如 PreToolUse hook 调用 MCP 工具去校验输入。

账号与升级

命令	作用
`/login`	登录或切账号
`/logout`	退出当前账号
`/upgrade`	跳转到升级页面（Pro / Max / Team）

多账号用户的常见痛点是不知道当前用的是哪个——先 /status，不对再 /login。

帮助与诊断

命令	作用	什么时候用
`/help`	显示帮助菜单	找命令、找文档链接
`/doctor`	跑环境健康检查	安装完成后第一次跑；遇到奇怪问题第一时间跑
`/bug`	提交 bug 反馈	遇到能复现的 bug、想要 Anthropic 看到时
`/release-notes`	查看最近版本更新	升级完不知道多了什么时

/doctor 输出里要重点看：CLI 版本、Node 版本、PATH 中的 claude 是哪个、账号状态、网络可达性。装错版本 / PATH 顺序错 / 公司代理拦截，这条命令一次都能看出来。

IDE 与 git 集成

命令	作用
`/ide`	把 Claude Code 连到当前打开的 VS Code / JetBrains 实例
`/install-github-app`	在仓库里安装 Claude GitHub App，让 Claude 在 PR 上自动回应
`/pr_comments`	查看当前 PR 的评论

/ide 跑过一次后，IDE 那边会出现一个 Claude Code 面板，diff 也会直接在编辑器里渲染——比纯终端体验好很多。

自定义命令与 skill

你不止能用内置命令。Claude Code 允许：

自定义 slash command：在 .claude/commands/<name>.md 或用户级 ~/.claude/commands/ 放一个 prompt 模板，输入 /<name> 就触发。
skill：在 .claude/skills/<name>/SKILL.md 里写完整工作流（含脚本、引用文档），同样以 /<name> 调用。
插件：把一组 command / skill / agent / hook 打包成插件，用 /plugin 类命令管理。

什么时候自定义命令 vs skill：一句 prompt 就够、不需要附带文档 → 自定义命令。固定多步流程、要复用引用文件、要团队对齐 → skill。详细对比见 Claude Code Skills 指南。

实操：把命令用成肌肉记忆

按使用频次排序，前 8 条几乎覆盖日常 80% 场景：

/clear — 切任务前先清。
/compact <提示> — 上下文吃紧前定向压。
/resume — 切走了再回来。
/usage 或 /cost — 心里有数。
/init — 新仓库第一件事。
/model — 复杂任务切 Opus，琐碎查询切 Haiku。
/permissions — 把高频 Bash 加白名单，减少弹窗。
/doctor — 遇到怪问题先跑这个。

再下一层：/agents、/hooks、/mcp 各看一次菜单，知道入口在哪——具体配置等真要用了再深挖。

完成后检查

是不是还在为了”看一眼用了多少”而点设置面板？——直接 /usage。
是不是还在上下文塞满后愣着等？——/compact 带具体提示。
是不是每跑一条 npm test 都要确认？——/permissions 加白名单。
是不是还在终端粘 PR 评论？——/pr_comments 直接读出来。

容易踩的坑

把 /clear 和 /compact 搞混：/clear 是清掉重来，/compact 是压缩继续，弄反了会丢上下文或塞不下。
/compact 不带提示直接压，结果重要的”已改文件清单”被丢了——养成 /compact <你要它优先保留的内容> 的习惯。
/permissions 给太宽，比如把所有 Bash 都白名单——别这么干，除非在隔离 worktree。
/login 切了账号但 /status 还显示旧的：通常是没重启会话，开个新终端再试。
/doctor 报 PATH 里有两个 claude：先在 shell 里 which -a claude，确认哪个是真在跑的版本。
把内置命令和 skill 混着叫：内置命令版本一致、不可禁用；skill 是按需挂载的，团队成员之间可能不一样。

FAQ

Q：/compact 和 /clear 怎么选？ A：/compact 压缩当前会话但保留摘要——做完一个阶段、想继续在同一任务里推进时用。/clear 直接清空对话保留 CLAUDE.md——切换到不相关的新任务时用。/compact 不带提示直接压会把重要的“已改文件清单”丢掉，养成 /compact <你要它优先保留的内容> 的习惯。

Q：/usage 和 /status 显示的是什么？ A：/usage 偏当月 / 本会话的 token 消耗与剩余额度；/status 偏当前账号、模型、IDE 集成、登录状态那一摞诊断信息。token 用完时先 /usage 分清是这次会话用得多还是月配额到顶。

Q：自定义命令放在哪里？ A：项目级放 .claude/commands/<name>.md，跟着 git 走；用户级放 ~/.claude/commands/<name>.md，所有项目共享。命令文件就是 markdown，执行时把内容作为 prompt 插入。要带参数用 $ARGUMENTS 占位。

Q：/doctor 报 PATH 里有两个 claude 怎么办？ A：先在 shell 里 which -a claude 列出所有路径，确认哪个是真在跑的版本（通常是 ~/.claude/local/bin/claude 或 npm 全局安装那个）。把不要的那个从 PATH 里去掉，或者直接 rm 掉旧的。