<!-- title: 斜杠命令全解：交互与三模式入门 -->

# 斜杠命令全解：新手如何驾驭 Claude Code 的交互界面

## 概述

本教程面向已经装好 Claude Code、却不知如何"开车"的零基础用户。安装只是点火，真正决定效率的是 REPL（交互式命令行）里那一套**斜杠命令**、**键盘快捷键**和**四种权限模式**。读完本文，你将掌握 30+ 个核心命令、5 个高频快捷键、4 种模式的切换时机，并能用一个真实重构案例把它们串起来，告别"只会打字聊天"的初级阶段。

## 前置条件

- 已完成 Claude Code 安装（npm 或原生安装包均可）
- 终端可正常启动 `claude` 并完成登录认证
- 准备一个本地代码目录作为练手项目（任何语言都行）
- 建议阅读过"给项目装记忆：CLAUDE.md 入门"，理解 `CLAUDE.md` 的作用

> 本文不涉及安装与登录步骤，相关内容已有专门教程覆盖。我们聚焦"装好之后怎么开"。

---

## 一、为什么新手必须先学斜杠命令

很多新手装完 Claude Code 后，会直接在 REPL 里打自然语言问题，像用网页版聊天一样。这能用，但极其低效——你会遇到三大典型困境：

1. **上下文越聊越长**，到中途报错 `Context length exceeded`，前面的成果全废。
2. **每次改文件都要手动确认**，改 20 个文件要点 20 次回车，手指抽筋。
3. **想看花了多少 token、用了哪个模型、当前在哪个目录**，全靠猜。

这三个困境的解药，全在斜杠命令和权限模式里。Claude Code 把"会话管理、成本控制、文件引用、模式切换"全部做成了命令和快捷键，**这是它与网页版最大的区别**，也是新手最快能拉开差距的地方。

下面这张总览图，先帮你建立全局认知：

```mermaid
graph TD
    A[Claude Code REPL] --> B[斜杠命令 /xxx]
    A --> C[键盘快捷键]
    A --> D[权限模式]

    B --> B1[会话管理<br/>/clear /compact /rewind /resume]
    B --> B2[上下文与记忆<br/>/init /memory /context /add-dir]
    B --> B3[配置与诊断<br/>/config /model /cost /doctor /status]
    B --> B4[扩展能力<br/>/agents /hooks /mcp /tasks]

    C --> C1[Esc 中断]
    C --> C2[Esc Esc 回退]
    C --> C3[Shift+Tab 切模式]
    C --> C4[@ 引用文件 # 写入记忆]

    D --> D1[default 逐项确认]
    D --> D2[plan 只读规划]
    D --> D3[acceptEdits 自动改文件]
    D --> D4[bypassPermissions 全自动]

    style A fill:#fff3e0,stroke:#e65100,stroke-width:2px
    style B fill:#e3f2fd,stroke:#1565c0
    style C fill:#f3e5f5,stroke:#6a1b9a
    style D fill:#e8f5e9,stroke:#2e7d32
```

---

## 二、认识命令体系：四大分类

打开终端，启动 `claude`，在光标处输入 `/`，会弹出命令补全列表。2026 年 6 月版本（2.1.x）内置命令可归为四类。我们逐一拆解高频项。

### 分类速查表

| 类别 | 代表命令 | 一句话作用 |
|------|----------|-----------|
| 会话管理 | `/clear` `/compact` `/rewind` `/resume` `/export` | 控制对话上下文的生死与回退 |
| 上下文与记忆 | `/init` `/memory` `/context` `/add-dir` | 决定 Claude 看到什么、记住什么 |
| 配置与诊断 | `/config` `/model` `/cost` `/status` `/doctor` `/login` `/fast` | 调参、查账、体检 |
| 扩展能力 | `/agents` `/hooks` `/mcp` `/tasks` `/review` `/security-review` | 子代理、钩子、外部工具 |

**新手第一步**：在 REPL 里输入 `/help`，看到所有命令的简短说明。这是你的"仪表盘说明书"，记不住命令时就 `/help`。

---

## 三、会话管理三件套：`/clear` `/compact` `/rewind`

这是新手**最该优先掌握**的三条命令，直接关系到你能不能顺利完成长任务。

### 3.1 `/clear` —— 彻底清空，从头开始

**作用**：清空当前会话的全部上下文，回到"刚启动"的空白状态。

**何时用**：
- 切换到完全无关的新任务时（比如从"修 bug"切到"写文档"）
- 上下文被无关信息污染，Claude 开始胡说八道时
- 想要一个干净的低 token 起点

**命令**：
```
/clear
```

**预期结果**：REPL 显示一条分隔线，上下文计数归零，之前的对话历史不再被模型读取。

**常见坑**：很多人在 `/clear` 之前忘了让 Claude 把结论写进文件，结果一清空，刚分析好的方案全没了。**对策**：清空前先让 Claude 把成果落到 `CLAUDE.md` 或一个 `.md` 文件里，下次 `/resume` 还能找回。

> **2.1.191 新特性**（2026-06-25 更新）：`/rewind` 现在可以恢复 `/clear` 之前的上下文了，不再只是普通检查点。也就是说，误清空也能救回来。但这不意味着可以随便 `/clear`——养成"清空前留痕"的习惯永远没错。

### 3.2 `/compact` —— 压缩而非清空

**作用**：把当前长上下文**摘要压缩**成一个总结，保留关键信息，腾出 token 空间继续工作。

**何时用**：
- 上下文用到 60%~80%，还没完成任务，但不想丢失进度
- 任务本身连续性强，前面的决策后面还要引用

**命令**：
```
/compact
```

也可以带自定义指令，告诉它压缩时重点保留什么：
```
/compact 重点保留接口设计决策和已完成的函数列表
```

**预期结果**：REPL 显示压缩前后 token 数，比如 `Context: 142000 → 31000 tokens`，对话继续。

**`/clear` vs `/compact` 的核心区别**：

| 维度 | `/clear` | `/compact` |
|------|----------|-----------|
| 上下文 | 全部丢弃 | 摘要保留 |
| 适用场景 | 换任务 | 续任务 |
| Token 占用 | 归零 | 大幅降低但不归零 |
| 风险 | 丢失细节 | 可能压缩掉细节 |

**经验法则**：**换任务 `/clear`，续任务 `/compact`**。

### 3.3 `/rewind` —— 时光倒流

**作用**：回退到对话中的某个检查点，撤销之后 Claude 产生的修改。

**命令**：
```
/rewind
```

系统会列出可回退的检查点（通常是每轮交互后自动保存的快照），你选一个时间点即可回退。

**何时用**：
- Claude 走错方向，连续改了几轮文件，想回到岔路口
- 手滑批准了不该批准的修改

**配合快捷键**：双击 `Esc`（Esc Esc）可以快速回退到上一条用户消息，比 `/rewind` 更轻量，适合"就回退一步"。

---

## 四、上下文与记忆：让 Claude 看对东西、记对东西

### 4.1 `/init` —— 生成项目记忆文件

**作用**：让 Claude 扫描项目，自动生成 `CLAUDE.md`，记录项目结构、构建命令、代码风格。

**命令**：
```
/init
```

**预期结果**：项目根目录出现 `CLAUDE.md`，之后每次启动 Claude Code 都会自动加载它作为持久记忆。

**新手误区**：以为 `/init` 是一次性命令。实际上它生成的文件**可以反复编辑**，建议手动补充"测试怎么跑、提交规范、禁忌事项"，效果远超纯自动生成。

### 4.2 `/memory` 与快捷 `#` —— 写入记忆

**作用**：`/memory` 打开记忆文件进行编辑；在输入框直接打 `#` 开头的一行，可快速写入记忆。

**命令**：
```
/memory
```
或快速记一笔（在输入框）：
```
# 本项目用 pnpm，不要用 npm install
```

**预期结果**：这条规则被追加到 `CLAUDE.md`，今后 Claude 自动遵守。

### 4.3 `/context` —— 看清当前上下文

**作用**：列出当前会话占用了哪些上下文（文件、命令输出、记忆），帮你判断为什么会爆 token。

**命令**：
```
/context
```

**何时用**：上下文莫名变大时，用它找出"罪魁祸首"——通常是某个被全量读入的大文件。

### 4.4 `/add-dir` —— 加入工作目录

**作用**：让 Claude 访问启动目录之外的其他目录。

**命令**：
```
/add-dir /path/to/another/project
```

**何时用**：需要跨项目引用代码（比如前端项目要参考后端 API 定义）。

---

## 五、四种权限模式：用 `Shift+Tab` 切换

这是新手进阶的关键。Claude Code 有四种权限模式，决定了它在多大程度上"自己动手"。**按 `Shift+Tab` 在 REPL 里循环切换**，无需退出。

```mermaid
flowchart LR
    M1[default<br/>逐项确认] -->|Shift+Tab| M2[plan<br/>只读规划]
    M2 -->|Shift+Tab| M3[acceptEdits<br/>自动改文件]
    M3 -->|Shift+Tab| M4[bypassPermissions<br/>全自动]
    M4 -->|Shift+Tab| M1

    style M1 fill:#fff9c4
    style M2 fill:#bbdefb
    style M3 fill:#c8e6c9
    style M4 fill:#ffcdd2
```

### 模式详解

| 模式 | 文件编辑 | 命令执行 | 适用场景 | 风险 |
|------|----------|----------|----------|------|
| **default** | 每次问 | 每次问 | 新手默认、不熟悉的项目 | 低 |
| **plan** | 禁止 | 禁止 | 让 Claude 先出方案不动手 | 最低 |
| **acceptEdits** | 自动 | 仍问 | 批量重构、可信任务 | 中 |
| **bypassPermissions** | 自动 | 自动 | 沙箱、一次性环境 | 高 |

**新手黄金法则**：
- **刚接触一个陌生代码库 → 用 `plan`**：让 Claude 先读、先规划，你审完方案再切回 `default` 或 `acceptEdits` 动手。这能避免它一上来就乱改。
- **方案已定、要批量改文件 → 切 `acceptEdits`**：免去几十次回车确认，但命令执行仍要你点头，安全垫还在。
- **`bypassPermissions` 慎用**：仅在 Docker 容器、临时虚拟机等可丢弃环境里用。别在生产目录、别在有未推送提交的仓库里用。

**`/config` 也能改默认模式**：不想每次 `Shift+Tab`，可用 `/config` 把启动默认模式设为 `acceptEdits`。

---

## 六、键盘快捷键速查

斜杠命令之外，快捷键是高频操作的"肌肉记忆"。

| 快捷键 | 作用 | 使用频率 |
|--------|------|----------|
| `Esc` | 中断 Claude 当前操作 | ★★★★★ |
| `Esc Esc` | 回退到上一条用户消息 | ★★★★ |
| `Shift+Tab` | 循环切换权限模式 | ★★★★ |
| `↑` / `↓` | 翻历史输入 | ★★★ |
| `Ctrl+C` | 取消当前输入行 | ★★★ |
| `Ctrl+D` | 退出 Claude Code | ★★ |
| `Ctrl+R` | 切换详细输出（verbose） | ★★ |
| `@` | 输入框引用文件/目录 | ★★★★★ |
| `#` | 输入框快速写入记忆 | ★★★ |
| `Tab` | 命令/文件名补全 | ★★★★ |

**最该先练的三招**：
1. **`@` 引用文件**：输入 `帮我看下 @src/utils/auth.ts 的登录逻辑`，Claude 会精准读取该文件，而不是猜路径。这比"帮我看看认证代码"精确得多。
2. **`Esc` 及时刹车**：发现 Claude 跑偏，立刻 `Esc` 中断，比等它改完一通再 `Esc Esc` 回退省事。
3. **`Esc Esc` 兜底回退**：手滑批准了错误操作，双击 Esc 回到上一步。

---

## 七、配置与诊断：查账与体检

### 7.1 `/cost` —— 查花费

```
/cost
```
显示当前会话累计消耗的 token 和美元。长任务中途看一眼，避免不知不觉烧超预算。

### 7.2 `/model` —— 切模型

```
/model
```
弹出可选模型（Opus / Sonnet / Haiku）。**新手建议**：复杂重构用 Opus，日常问答用 Sonnet 省 token，简单任务用 Haiku 最便宜。`/fast` 可开启 Opus 的快速输出模式（不会降级到小模型）。

### 7.3 `/doctor` 与 `/status` —— 体检

- `/doctor`：检查安装是否正常、配置有无问题。装完第一天跑一次，排除隐患。
- `/status`：查看当前登录账号、订阅类型、版本号。

### 7.4 `/config` —— 全局配置面板

```
/config
```
打开设置，可改默认模型、主题、编辑器、权限默认值等。新手不必一次全懂，先记住"入口在这里"即可。

---

## 八、扩展能力命令（先认识，后续教程深挖）

新手只需"知道有这些"，进阶教程会专章讲解：

- `/agents`：管理子代理（subagents），把大任务拆给专职代理并行处理。
- `/hooks`：配置钩子，在特定事件（如编辑前、命令前）自动触发脚本。
- `/mcp`：管理 MCP 服务器，接入外部工具与数据源。
- `/tasks`：查看后台任务（如后台运行的 agent）。
- `/review`：对当前代码改动做审查。
- `/security-review`：安全专项审查。
- `/install-github-app` + `/pr-comments`：与 GitHub 集成，处理 PR 评论。

---

## 九、实战案例：用命令驱动一次真实重构

**场景**：你要给一个 Express 项目添加请求日志中间件，并重构现有路由文件。

**第 1 步——只读规划（`plan` 模式）**

按 `Shift+Tab` 切到 `plan` 模式，输入：
```
请阅读 @src/routes 和 @app.ts，规划如何统一加请求日志中间件，先不要改任何文件
```
Claude 会输出方案但不动文件。你审阅方案，觉得可行。

**第 2 步——切回动手（`acceptEdits`）**

按 `Shift+Tab` 切到 `acceptEdits`，输入：
```
按方案实施，新建 src/middleware/logger.ts，并在 app.ts 中挂载
```
Claude 自动创建和编辑文件，无需逐次确认。但若它要 `npm install` 依赖，仍会问你（命令执行仍受控）。

**第 3 步——跑测试验证**

```
运行测试，确认没破坏现有功能
```
Claude 执行测试命令（会先请求权限），你批准后看结果。

**第 4 步——压缩上下文续任务**

任务完成一半，发现 `/cost` 显示 token 已用到 70%。输入：
```
/compact 保留 logger 中间件的设计决策和已修改文件清单
```
压缩后继续下一步。

**第 5 步——把成果写进记忆**

输入框打：
```
# 请求日志中间件位于 src/middleware/logger.ts，通过 app.ts 全局挂载
```
下次新会话也能自动知道这个约定。

**第 6 步——切换任务前清理**

下一个任务是写文档，与重构无关。先让 Claude 把改动总结写入 `CHANGELOG.md`，然后：
```
/clear
```
干净开始新任务。

这个案例把 **`plan` → `acceptEdits` → `/compact` → `#` → `/clear`** 串成了完整工作流，正是高效用户每天在用的节奏。

```mermaid
sequenceDiagram
    participant U as 用户
    participant C as Claude Code
    U->>C: Shift+Tab 切 plan 模式
    U->>C: 读 @routes 规划方案（不动文件）
    C-->>U: 输出方案
    U->>C: Shift+Tab 切 acceptEdits
    U->>C: 实施重构（自动改文件）
    C-->>U: 完成 logger.ts + 挂载
    U->>C: 运行测试（请求权限）
    C-->>U: 测试通过
    U->>C: /compact 压缩上下文
    C-->>U: 142k→31k tokens
    U->>C: # 写入记忆
    U->>C: /clear 切换任务
```

---

## 十、新手最常踩的 5 个坑

1. **从不 `/clear`，上下文撑爆报错** → 换任务必清，续任务用 `/compact`。
2. **全程 `default`，点确认点到崩溃** → 可信批量任务切 `acceptEdits`。
3. **陌生仓库直接动手改** → 先 `plan` 模式只读规划，审完再改。
4. **用自然语言描述文件而非 `@` 引用** → Claude 容易读错文件，养成 `@路径` 习惯。
5. **`/clear` 前不留痕** → 重要结论先写进 `CLAUDE.md` 或文件，配合 2.1.191 的 `/rewind` 双保险。

---

## 延伸阅读

- **官方命令参考**：`code.claude.com/docs/en/commands` —— 权威的内置命令清单。
- **官方 CLI 参考**：`code.claude.com/docs/en/cli-reference` —— 所有命令行启动参数。
- **会话管理官方博客**：`claude.com/blog/using-claude-code-session-management-and-1m-context` —— `/clear`/`/compact`/`/rewind` 的官方最佳实践，配合 1M 上下文窗口。
- **CLAUDE.md 入门教程**：理解项目记忆机制后再回来读本文，体会更深。
- **自定义斜杠命令**：进阶——把团队常用工作流封装成自己的 `/xxx` 命令（后续教程覆盖）。

---

## 训练营适用性评估

| 评估维度 | 说明 |
|----------|------|
| **适用训练营类型** | AI 编程入门营、开发者效率提升营、Claude Code 专项训练营（第 1 天） |
| **学员基础** | 零基础，仅需会基本终端操作 |
| **建议时长** | 2~3 小时（含动手实操） |
| **教学形式** | 讲授 30% + 跟练 70%，每个命令当场敲一遍 |
| **考核点** | 能独立完成第九节实战案例的完整工作流 |
| **前置衔接** | 安装/登录/CLAUDE.md 教程之后，权限围栏教程之前 |
| **后续衔接** | 自定义命令、Hooks、子代理等进阶主题 |

本教程是入门系列的"驾驶课"——装好车（安装）之后，教你换挡（模式）、踩刹车（中断）、看仪表（`/cost`/`/context`）、规划路线（`/init`/`plan`）。掌握它，你才算真正"会上路"。

---

## 参考来源

1. [Commands — Claude Code Docs](https://code.claude.com/docs/en/commands) — Anthropic 官方内置斜杠命令权威清单。
2. [Using Claude Code: session management and 1M context — Claude Blog](https://claude.com/blog/using-claude-code-session-management-and-1m-context) — `/clear`、`/compact`、`/rewind` 官方最佳实践与 1M 上下文窗口使用策略。
3. [Claude Code Commands: A Practical Guide for 2026 — DataCamp](https://www.datacamp.com/tutorial/claude-code-slash-commands) — 斜杠命令管理上下文、改动与成本的实战指南。
4. [Claude Code Session Management: /clear, /compact, and /rewind Explained — BSWen](https://docs.bswen.com/blog/2026-03-25-claude-code-session-commands/) — 三大会话命令的原理与 `Context length exceeded` 报错排查。
5. [Claude Code Cheat Sheet: Commands, Tips & Shortcuts (2026) — SkillsPlayground](https://skillsplayground.com/guides/claude-code-cheat-sheet/) — 斜杠命令、键盘快捷键、CLI 启动参数速查表（2.1.x 版本）。

> [!tip] 51学通信知识星球
> **星主：爱卫生**（微信：gprshome201101）——公众号「51学通信」创办者，19 年通信行业运维与讲师经验，著有《GPRS网络信令实例详解》《EPC原理与实践》《5G核心网原理与实践》三本纸质书（各大电商平台有售）。
> **星球定位**：深耕 5G 核心网、IMS、NFV/AI、云原生等 ICT 领域，主打运维岗位与信令分析。
> **当前规模**：5200 篇主题 / 990 个回答，198 元/年。
> **加入福利**：加入星球后请加爱卫生微信，拉您进知识星球年度陪伴与答疑群——不限量回复您的各种问题，另有群内分享。
> **AI 加持**：51学通信知识星球已作为 skill 接入 WorkBuddy，使用 deepseek-4-flash 在海量星球帖子中精准找贴、找视频、找 FAQ 和案例，做总结、找文档和 PPT 等场景全覆盖。

![51学通信知识星球海报-扫码加入](https://wiki.500nian.com/images/zhixingqiu_qrcode.png)