课程0基础Agent开发课 / Claude-Code实战教程 / 斜杠命令速查
— 16 min read

斜杠命令速查

> **时效说明**:本文内容以 2026 年 3 月为基准。

Claude Code:斜杠命令速查

时效说明:本文内容以 2026 年 3 月为基准。

12.1 斜杠命令概览

斜杠命令是Claude Code的功能快捷键,在输入框里输入/就能看到可用命令列表。它们分为两大类:

  • 内置命令:Claude Code自带的,不需要任何配置
  • 项目命令:你在.claude/commands/目录下自定义的,通过/project:xxx调用

这篇文章先把所有内置命令过一遍,再介绍项目命令的创建和使用。

12.2 会话管理类命令

12.2.1 /clear——清空上下文重新开始

code
/clear

把当前会话的所有上下文清空,相当于重新开一个干净的对话。

什么时候用:做完一个任务,准备切换到完全不相关的任务时。比如你刚帮一个微服务做了重构,下一件事是给另一个项目写API文档——两件事没有关联,清空上下文可以避免之前的信息干扰。

什么时候不用:同一个任务的后续步骤不要清空。Claude的记忆清空后,它不知道你们之前决定了什么,会重新从头来。

注意/clear清空的是对话上下文,不清空CLAUDE.md里的规则。规则会在新会话里继续生效。

12.2.2 /compact——压缩上下文省Token

code
/compact

把历史对话摘要化——把长长的对话历史压缩成一段摘要,保留关键信息(你们决定了什么、实现了什么),丢掉冗余的对话过程。

什么时候用:长时间工作会话,感觉Claude开始有点"记忆模糊",或者看/cost发现Token消耗快速增长时。在一个大任务的中途用一次/compact,后续对话会更快更省钱。

效果:上下文从几万token压缩到几千token,后续每次对话的消耗降低。压缩后Claude还记得项目背景,但不记得每一步的具体细节。

适用节奏:大约每工作1-2小时用一次,或者感觉Claude回复变慢时用。

12.2.3 /resume——恢复历史会话

code
/resume [session-id]

在已启动的会话内,通过session ID恢复指定的历史对话。

claude -c的区别claude -c是在终端启动时恢复最近的历史会话(启动参数),而/resume是在当前运行中的会话内切换到指定历史(会话内命令)。

session-id从哪里找/status命令会显示当前会话ID,你也可以在日志目录~/.claude/sessions/里找到历史会话。

什么时候用:昨天进行到一半的任务,今天想接着继续做。

12.2.4 /new——在当前终端开新会话

code
/new

不退出Claude Code,直接在当前终端开一个全新的空会话。

/clear的区别/clear是清空当前会话的内容,会话ID不变;/new是新建一个独立的会话,有新的会话ID,旧会话还存在可以用/resume回来。

12.3 配置类命令

12.3.1 /model——切换语言模型

code
/model
/model claude-opus-4-5
/model claude-sonnet-4-5

切换Claude Code使用的底层模型。

可选模型(截至2026年3月):

  • claude-opus-4-5:能力最强,适合复杂的架构设计、难题分析
  • claude-sonnet-4-5:速度更快、费用约是Opus的五分之一,适合常规编码任务
  • claude-haiku-3-5:最快最便宜,适合简单问答、快速检索

什么时候切换

  • 做代码生成、写注释这类常规任务 → Sonnet,省钱省时间
  • 做架构评审、解决复杂bug、分析大型系统 → Opus,多花一点钱值得
  • 只是快速问个语法问题 → Haiku

实用技巧:在同一次会话里可以随时切换。先用Sonnet做大量初步工作,发现卡住了再切Opus来突破,比全程用Opus要省不少钱。

12.3.2 /status——查看当前会话状态

code
/status

显示当前会话的关键信息:

  • 当前使用的模型
  • 上下文窗口的使用量(多少token已用,多少剩余)
  • 当前会话ID
  • 本次会话的费用估算
  • 已启用的MCP Server列表

什么时候看:感觉Claude回复质量下降,可能是上下文快满了;想知道剩余上下文还够不够完成当前任务。

12.3.3 /config——打开配置界面

code
/config

打开交互式配置界面,可以调整:

  • 自动批准级别:Claude执行文件操作、Shell命令时是否需要你每次确认
    • ask(默认):每次都问
    • auto:自动批准,适合信任Claude的场景
  • 颜色主题:终端显示的颜色方案
  • 换行模式:输入框的换行行为

常用配置:如果你已经很熟悉Claude的工作方式,把批准级别改成auto可以省去大量确认点击,大幅提升效率。但新手建议保持ask,每次都看一眼Claude要做什么。

12.3.4 /cost——查看费用

code
/cost

显示当前会话消耗的Token数量和对应的费用(美元)。

输入Token vs 输出Token:通常分开显示。输入Token(你发的内容)比输出Token(Claude回复)便宜很多。一般规律是,让Claude读大量代码时输入消耗大,让Claude写大量代码时输出消耗大。

建议:做完每个大任务后看一下,建立对不同类型任务成本的直觉认知。

12.4 功能类命令

12.4.1 /init——初始化项目的CLAUDE.md

code
/init

在新项目里第一次使用Claude Code时跑这个命令。Claude会扫描项目结构(目录层级、技术栈、框架、配置文件),然后自动生成一份适合这个项目的初始CLAUDE.md文件。

生成的内容包括

  • 技术栈识别(Java版本、Spring Boot版本、用的中间件)
  • 项目结构说明(哪些目录放什么代码)
  • 构建工具和常用命令(mvn testmvn package等)
  • 识别到的代码风格约定

注意/init生成的是一个起点,不是最终版。生成后一定要检查一遍,补充项目特有的规范、团队约定、禁用的API等。

12.4.2 /memory——查看和编辑记忆文件

code
/memory

打开当前的CLAUDE.md文件(在编辑器里),可以直接查看和修改。

两种CLAUDE.md的区别

  • CLAUDE.md(项目根目录):团队共享的规范,提交到git
  • CLAUDE.local.md(项目根目录):个人本地的补充规则,加入.gitignore
  • ~/.claude/CLAUDE.md:跨项目的全局规则

/memory默认打开当前项目的CLAUDE.md。

12.4.3 /help——查看帮助

code
/help
/help compact
/help hooks

不带参数显示所有命令列表。带命令名参数显示那个命令的详细说明。

最常用法/help看一眼有什么命令,/help <command>看某个命令的具体用法。

12.4.4 /login 和 /logout

code
/login
/logout

/login:切换登录的Anthropic账户,或者切换API Key。如果你有多个账户(比如个人账户和公司账户),用这个来切换。

/logout:退出当前账户。

12.5 项目命令类

12.5.1 什么是项目命令

项目命令是你自己创建的自定义快捷命令。在.claude/commands/目录下创建Markdown文件,文件名就是命令名,内容就是Claude执行这个命令时要做的事。

创建后通过/project:命令名调用。

12.5.2 创建第一个项目命令

步骤1:创建命令文件

bash
mkdir -p .claude/commands

创建.claude/commands/deploy-check.md

markdown
# 部署前检查清单

执行以下所有检查步骤,每一步都汇报结果:

## 1. 代码质量
运行 `mvn checkstyle:check` 检查代码格式。

## 2. 单元测试
运行 `mvn test` 确认所有测试通过。

## 3. 依赖安全
运行 `mvn dependency:check` 检查是否有已知漏洞的依赖。

## 4. 配置文件检查
确认 application.properties 里没有 localhost 的数据库地址(生产环境应该用变量)。
确认没有硬编码的密码。

## 5. 版本号
检查 pom.xml 的版本号是否已更新(不是 SNAPSHOT)。

所有检查完成后,给出一个总结:是否可以安全部署?有哪些需要关注的问题?

步骤2:调用命令

code
/project:deploy-check

Claude会按照你定义的步骤,逐一执行检查并汇报结果。

12.5.3 更多项目命令示例

release-notes.md——生成发布说明:

markdown
# 生成发布说明

根据最近的git commits生成格式化的发布说明。

## 步骤

1. 运行 `git log --oneline $(git describe --tags --abbrev=0)..HEAD` 获取最近的提交记录
2. 把提交按类型分类(feature/fix/refactor/docs)
3. 用以下格式输出:

---
## [版本号] - [日期]

### 新功能
- 功能描述...

### Bug修复
- 修复描述...

### 性能优化
- 优化描述...

### 其他
- 其他改动...
---

版本号从 pom.xml 读取,日期用今天的日期。

onboard.md——新人引导:

markdown
# 新人项目引导

帮助新加入团队的工程师快速了解这个项目。

## 输出内容

1. **项目简介**:这个项目是做什么的(读README.md总结)
2. **技术栈一览**:用的主要框架和中间件(读pom.xml)
3. **项目结构**:主要目录的功能说明(展示目录树,每层注释)
4. **本地启动步骤**:按顺序列出本地跑起来需要哪些步骤
5. **开发流程**:分支命名规范、提交规范、PR流程(读.github/CONTRIBUTING.md)
6. **常见问题**:列出最容易踩的3个坑

用友好的语气,假设读者是第一天入职的Java工程师。

health-check.md——项目健康度检查:

markdown
# 项目健康度检查

从几个维度评估项目的技术健康状况,给出改善建议。

## 检查维度

### 1. 依赖版本
检查 pom.xml 里的主要依赖版本是否过旧(超过2年没更新的)。
特别关注有安全漏洞历史的库:log4j、fastjson、jackson-databind、Spring Security。

### 2. 测试覆盖率
运行 `mvn jacoco:report`,分析测试覆盖率报告。
重点关注核心业务Service类的覆盖率是否达到70%以上。

### 3. 代码复杂度
找出最复杂的5个方法(方法行数 > 100 或者嵌套层数 > 4)。

### 4. TODO和FIXME数量
搜索代码里的 TODO 和 FIXME,统计数量和位置。

### 5. 输出报告
用A/B/C/D四个等级评分,每个维度给一个等级和具体改善建议。

12.5.4 项目命令的参数

项目命令支持通过$ARGUMENTS获取调用时传入的参数:

在命令文件里写:

markdown
# 分析指定模块

分析以下模块:$ARGUMENTS

检查该模块的代码质量、接口设计和测试覆盖率。

调用时:

code
/project:analyze-module order payment

Claude会把order payment替换进去,分析order和payment这两个模块。

12.6 命令的组合使用技巧

12.6.1 开始新任务的标准流程

code
/compact          # 如果上一个任务刚结束,先压缩上下文
/clear            # 如果新任务和上一个完全不相关,清空上下文
                  # (二选一,不要两个都用)
@src/order/       # 引入相关目录,让Claude有背景信息

12.6.2 长任务中途的管理

code
/status           # 查看上下文使用量
/cost             # 看一眼当前花费
/compact          # 如果上下文用了超过一半,及时压缩

12.6.3 任务结束的收尾

code
/cost             # 看这个任务的总费用
/project:release-notes   # 如果是功能开发,生成发布说明

12.6.4 模型切换策略

code
/model sonnet     # 日常编码用Sonnet
                  # ...发现问题复杂了...
/model opus       # 切到Opus分析复杂问题
                  # ...得到方案了...
/model sonnet     # 回到Sonnet按方案写代码

12.7 最高频使用的5个命令

根据实际使用体验,这5个命令用得最多,值得重点熟悉:

12.7.1 第一名:/compact

使用频率最高,每个长任务都会用到。上下文用了一半就该压缩,否则后续对话越来越慢、越来越贵。

记住这个规律:感觉Claude回复变慢或者"不在状态",第一反应是/compact,不是/clear

12.7.2 第二名:/clear

切换任务时用。建立一个好习惯:每次准备做新任务时,先想一下"我需要清空上下文吗?"。如果新任务和之前完全不同,清空;如果是同一任务的延续,不清空。

12.7.3 第三名:/model

知道什么时候该用Opus、什么时候用Sonnet,能省很多钱。简单任务一直用Opus是一种浪费。

12.7.4 第四名:/cost

每隔一段时间看一眼,建立对自己使用习惯的成本感知。很多人不看账单,等月底看到扣款才觉得"哇这么贵"。

12.7.5 第五名:/project:xxx(你最常用的那个)

每个项目都应该有几个高频的自定义命令。把你每周都要手动重复的操作封装成命令,一次配置终身受益。

12.8 完整命令速查表

12.8.1 内置命令汇总

命令 分类 功能 常用参数
/clear 会话 清空当前会话上下文
/compact 会话 压缩历史对话为摘要
/resume 会话 恢复指定历史会话 [session-id]
/new 会话 新建空白会话
/rename [name] 会话 重命名当前会话 [name]
/branch [name] 会话 创建对话分支(别名: /fork) [name]
/rewind 会话 回退对话和/或代码到某个节点(别名: /checkpoint)
/export [filename] 会话 导出对话为纯文本 [filename]
/model 配置 切换使用的语言模型 模型名称
/status 配置 查看会话状态和上下文用量
/config 配置 打开配置界面
/cost 配置 查看当前会话费用
/effort [level] 配置 设置模型effort等级(low/medium/high/max/auto) [low|medium|high|max|auto]
/fast [on|off] 配置 切换fast模式 [on|off]
/theme 配置 更换颜色主题
/color [color] 配置 设置prompt bar颜色 [color]
/keybindings 配置 打开快捷键配置文件
/vim 配置 切换Vim编辑模式
/statusline 配置 配置Claude Code状态行
/init 功能 初始化项目CLAUDE.md
/memory 功能 查看/编辑CLAUDE.md
/help 功能 查看帮助文档 [命令名]
/add-dir <path> 功能 添加新工作目录到当前会话 <path>
/context 功能 可视化当前上下文使用情况
/copy [N] 功能 复制最后N条助手响应 [N]
/diff 功能 交互式diff查看器
/plan [description] 功能 直接进入plan模式 [description]
/permissions 功能 查看或更新权限(别名: /allowed-tools)
/sandbox 功能 切换沙箱模式
/security-review 功能 分析当前分支变更的安全漏洞
/btw <question> 功能 快速侧问,不计入对话历史 <question>
/stats 分析 可视化每日使用情况、会话历史
/insights 分析 生成会话分析报告
/hooks 工程 查看工具事件的hook配置
/mcp 工程 管理MCP服务器连接和OAuth
/agents 工程 管理代理配置
/tasks 工程 列出和管理后台任务
/skills 工程 列出可用技能
/plugin 工程 管理插件
/reload-plugins 工程 重载所有插件
/schedule [description] 工程 创建/管理云端定时任务 [description]
/ide 集成 管理IDE集成
/chrome 集成 配置Chrome集成设置
/desktop 集成 在Claude Code桌面App中继续当前会话
/remote-control 集成 允许claude.ai远程控制此会话(别名: /rc)
/install-github-app 集成 安装Claude GitHub Actions app
/pr-comments [PR] 集成 获取GitHub PR评论 [PR]
/terminal-setup 集成 配置终端快捷键
/voice 输入 切换语音听写
/doctor 诊断 诊断安装和设置
/release-notes 诊断 查看完整changelog
/feedback [report] 诊断 提交反馈(别名: /bug) [report]
/login 账户 登录/切换账户
/logout 账户 退出登录

12.8.1.1 内置技能(Bundled Skills)

除了上述内置命令,Claude Code还内置了以下技能,通过斜杠命令直接调用:

技能命令 功能
/batch <instruction> 并行大规模代码库变更
/claude-api 加载Claude API参考文档
/debug [description] 启用调试日志
/loop [interval] <prompt> 按间隔重复执行prompt
/simplify [focus] 并行3个review agent检查并优化代码质量

12.8.2 项目命令调用方式

调用方式 示例 说明
/project:命令名 /project:deploy-check 不带参数调用
/project:命令名 参数 /project:analyze-module order 带参数调用
对话里说命令相关的话 "帮我做一次部署前检查" 如果命令有description,可以触发自动匹配

本页目录