本文面向刚装好 Claude Code、却面对一片空白云端的零基础开发者。你将掌握把内置斜杠命令当作"控制面板"的方法：按项目阶段（初始化 → 执行 → 并行 → 交付 → 跨会话 → 排障）理解每条命令的用途，并在一个可运行的最小项目里亲手串联起十余条高频命令，最后学会用一行 Markdown 造出自己的专属命令。

一、概述与学习目标

Claude Code 在 2026 年（v2.1.x）已经内置了上百条斜杠命令，但 90% 的新手只会用 /init 和 /clear。本教程的目标是让你在 30 分钟内：

1. 理解"命令只在消息开头被识别、其后文本作为参数传入"这一核心规则；
2. 按工作流阶段建立命令心智地图，知道什么时候该用哪条命令；
3. 在一个真实的小项目里跑通 /init → /plan → /model → /compact → /diff → /code-review → /rewind 的完整闭环；
4. 学会创建一条带参数、带工具白名单的自定义命令。

适用人群：已完成 Claude Code 安装与首次认证（/login）、能进入交互式会话的开发者。如果你还没装好，请先完成安装，再回到本篇。

二、前置条件

确认环境无误后，在任意目录输入 claude 进入交互会话，输入 / 即可看到全部可用命令。

三、核心心智模型：命令是会话的控制面板

理解斜杠命令，先记住三条铁律：

铁律一：命令必须出现在消息开头。 请帮我 /clear 不会触发清除——/clear 不在开头，会被当成普通文字。正确写法是新起一条消息，直接输入 /clear。

铁律二：命令后面的文字是参数。 输入 /plan 重构登录模块，其中"重构登录模块"是传给 /plan 的描述参数；输入 /compact 只保留数据库相关的决定，"只保留数据库相关的决定"是压缩时的聚焦指令。

铁律三：命令分三类来源。 内置命令（编码在 CLI 里）、捆绑技能（bundled skill，本质是交给 Claude 的提示词，Claude 也能在相关时自动调用）、动态工作流（fan-out 到多个子代理的后台编排）。在 / 菜单里它们外观一致，但底层机制不同。

下面这张流程图把命令按"一个项目的生命周期"组织起来，是后续每一节的导航图：

flowchart TD
    A[首次进入仓库] -->|/init| B[生成 CLAUDE.md]
    B -->|/memory| C[精炼项目记忆]
    C -->|/permissions| D[设定审批规则]
    D --> E[执行任务]
    E -->|/plan| F[进入计划模式]
    F -->|/model /effort| G[调整推理预算]
    G -->|/context /compact| H[管理上下文窗口]
    H --> I{要并行?}
    I -->|是| J[/agents /tasks /batch/]
    I -->|否| K[继续单线程]
    J --> K
    K --> L[交付前]
    L -->|/diff| M[查看改动]
    M -->|/code-review| N[查 bug 与清理]
    N --> O[跨会话]
    O -->|/clear /resume /branch| P[新任务或回溯]
    P --> Q{出问题?}
    Q -->|是| R[/rewind /doctor /debug/]
    Q -->|否| E
    R --> E

四、阶段一：首次进入仓库——把项目"交代"给 Claude

刚 clone 下来的代码库，Claude 对它一无所知。这一阶段的三条命令负责建立"项目记忆"。

4.1 /init —— 生成项目说明书

在仓库根目录执行：

cd my-project
claude

进入会话后输入：

/init

预期结果： Claude 会扫描目录结构、读取关键文件（README、package.json/pyproject.toml 等），生成一份 CLAUDE.md，内容通常包含：项目概览、构建/测试命令、代码风格约定、目录结构说明。

进阶用法： 设置环境变量 CLAUDE_CODE_NEW_INIT=1 再跑 /init，会进入交互式流程，额外带你配置技能、钩子（hooks）和个人记忆文件，适合首次配置。

常见问题： - 生成的 CLAUDE.md 太长/太短？ 直接在会话里说"把 CLAUDE.md 精简到 30 行以内，只保留构建命令和约定"，Claude 会就地改写。 - 项目是多语言混合仓库？ 跑完 /init 后手动补一段"各子目录的语言与构建方式"。

4.2 /memory —— 精炼与维护记忆

/memory

这条命令打开记忆管理界面，可以做四件事：编辑 CLAUDE.md、开关自动记忆（auto-memory）、查看已自动写入的记忆条目。CLAUDE.md 是分层的——个人级（~/.claude/CLAUDE.md）与项目级（仓库内）会叠加生效。

实战建议： 项目级 CLAUDE.md 放"构建命令、目录约定、禁用某些操作"；个人级放"我偏好的注释密度、提交信息风格"。不要把容易过期的信息（如某个临时分支名）写进记忆。

4.3 /permissions —— 设定审批规则

/permissions

打开权限对话框，按作用域查看 allow/ask/deny 规则，决定哪些工具调用免审批、哪些要确认、哪些直接拒绝。对新手最实用的做法：把"只读类"操作（Read、Glob、Grep、git status）放进 allow，把 rm、git push 留在 ask。

小贴士：不想一条条加？用 /fewer-permission-prompts 这条捆绑技能，它会扫描你的历史会话，把高频的只读调用自动整理成一份建议清单，写入项目 .claude/settings.json。

五、阶段二：执行任务——掌控推理与上下文

进入实际编码后，重点是两件事：花多少算力去想（推理预算）、把多少历史塞进窗口（上下文管理）。

5.1 /plan —— 大改动先出方案

/plan 把日志模块从 Winston 迁移到 Pino

带描述参数调用，会直接进入计划模式并以此任务开局。计划模式下 Claude 只读不写，先产出分步方案给你审阅，你确认后才动手。对任何"涉及 3 个文件以上"的改动，养成先 /plan 的习惯。

5.2 /model 与 /effort —— 调节推理挡位

/model
/effort high

/model 切换模型并保存为新会话默认值；在支持的模型上还能用左右方向键调 effort（推理强度）。/effort 接受 low / medium / high / xhigh / max / ultracode，auto 重置为模型默认。

挡位策略（省钱又保质）： - 读代码、答疑问 → low / medium； - 写新功能 → high； - 跨文件重构、排查疑难 bug → xhigh； - ultracode = xhigh 推理 + 自动工作流编排，留给大型改造。

5.3 /context 与 /compact —— 别让窗口爆掉

/context
/compact 只保留与鉴权相关的讨论

/context 用彩色网格可视化当前上下文占用，并给出"哪个工具吃得最多、记忆是否臃肿、是否接近容量上限"的优化建议。当占用偏高时，用 /compact 把历史总结成摘要，可带聚焦指令告诉它"压缩时重点保留什么"。注意：/compact 是保留同一会话地腾空间；想彻底另起炉灶用 /clear。

别忘了 /btw <问题>：想问个不相关的小问题（比如"顺便问下这个正则什么意思"），又不想污染主线历史，用它做"旁白"，不写入对话。

六、阶段三：并行与后台——让 Claude 自己分身

2026 版显著强化了并行能力，新手至少要认识这四条：

/background（别名 /bg）则把整个会话 detach 成后台代理、释放你的终端，用 claude agents 监控。

新手第一原则： 拿不准就用 /fork——它继承上下文、结果会回到你的会话，风险最低。

七、阶段四：交付前——看改动、查 bug

/diff

打开交互式 diff 查看器：左右切换"当前 git diff"与"每一轮 Claude 的改动"，上下浏览文件。这是提交前必看的一步。

/code-review
/code-review high --fix
/code-review ultra

/code-review 检查当前 diff 的正确性 bug 与清理机会（复用、简化、效率）。加 --fix 直接把发现应用到工作区；加 --comment 作为内联评论贴到 GitHub PR；ultra 触发云端多代理深度评审。

从 v2.1.154 起，/simplify 拆出来只做"清理类"评审（不查 bug），四路并行覆盖复用、简化、效率、抽象层次。想找 bug 用 /code-review，只想顺手清理用 /simplify。

更深度的只读审查还有 /review（本地评审 PR）与 /security-review（安全漏洞扫描）。

八、阶段五：跨会话与排障——回溯与自愈

/rewind 是新手的"后悔药"：Claude Code 会自动建检查点，改坏了能整体回退，比手动 git stash 安全得多。

九、实战案例：在一个最小项目里串起十余条命令

下面用一个可运行的示例项目，把上述命令真正跑一遍。

9.1 准备项目

mkdir cc-demo && cd cc-demo
git init -q
npm init -y >/dev/null
npm pkg set scripts.test="node --test"
mkdir lib
cat > lib/math.js <<'EOF'
function add(a, b) { return a + b; }
module.exports = { add };
EOF
git add -A && git commit -qm "init"

9.2 跑通命令闭环

在 cc-demo 目录启动 claude，依次执行（每条单独成行、放在消息开头）：

/init

生成 CLAUDE.md，Claude 会识别出这是个 Node 项目、测试命令是 npm test。

/permissions

把 Bash(npm test)、Read 加入 allow，减少后续审批。

/plan 给 lib/math.js 增加 multiply 函数并补一个测试文件

审阅方案、确认后让 Claude 实现。它通常新建 test/math.test.js 并改 lib/math.js。

/diff

查看这两处改动，确认符合预期。

/code-review

让它自查 bug。若发现问题，/code-review --fix 直接修。

npm test

（在会话里直接让 Claude 跑，或自己跑）确认测试通过。

/rewind

假设你不喜欢某个改动，回滚到检查点，再重新来过。

/clear 实验完成

给这次会话起名"实验完成"，开新任务；旧的用 /resume 随时找回。

整个闭环用一张时序图概括：

sequenceDiagram
    participant U as 你
    participant C as Claude Code
    participant G as Git/文件系统
    U->>C: /init
    C->>G: 扫描项目，生成 CLAUDE.md
    U->>C: /plan 增加 multiply
    C->>U: 输出方案
    U->>C: 确认
    C->>G: 改 math.js + 新建 test
    U->>C: /diff
    C->>U: 展示改动
    U->>C: /code-review
    C->>U: 报告(可选 --fix)
    C->>G: npm test 通过
    U->>C: /rewind (如需回退)
    C->>G: 恢复检查点
    U->>C: /clear 实验完成

十、进阶：用一行 Markdown 造你自己的命令

当某段提示词你反复输入，就该把它变成命令。Claude Code 支持用 Markdown 文件定义命令，分两种作用域：

• 项目级：.claude/commands/<名字>.md → 仅当前项目可用；
• 个人级：~/.claude/commands/<名字>.md → 所有项目可用。

子目录会形成命名空间：.claude/commands/tests/unit.md → /tests:unit。

文件体就是提示词模板，文件名即命令名，正文可用 $ARGUMENTS（用户传入的参数）、$1/$2（位置参数）占位。可选 YAML frontmatter：

---
description: 给一段代码写简洁注释
allowed-tools: Read, Edit
argument-hint: <文件路径>
---

阅读 $ARGUMENTS 的代码，为每个函数补充一行简洁的中文注释，
不要改变逻辑，不要新增依赖。

把上面内容存为 .claude/commands/doc.md，会话里就能用：

/doc lib/math.js

$ARGUMENTS 被替换成 lib/math.js，allowed-tools 把该命令可用的工具收窄到 Read 与 Edit（更安全），argument-hint 让 / 菜单里显示参数提示。

注意：在 2026 版官方文档中，"添加你自己的命令"被统一指向 skills 机制（.claude/skills/，带 SKILL.md 与渐进式披露，还能在相关时被 Claude 自动调用）。上面的 Markdown 命令方式更简单、适合固化单一提示词；想做更智能、可复用、能自动触发的能力，请进阶到 skills（那是下一轮教程的主题）。新增/改了命令文件后，用 /reload-skills 让本会话立即识别，无需重启。

常见问题： - 命令没出现在 / 菜单？ 检查文件是否在正确目录、扩展名是否 .md、是否在消息开头调用。改完跑 /reload-skills。 - 参数没替换？ 确认用的是 $ARGUMENTS（大写、带美元符），且调用时命令名后有空格再接参数。

十一、命令速查卡（按场景）

延伸阅读

• 官方命令全表：code.claude.com/docs/en/commands——最权威的命令清单与版本说明，遇到不确定的命令优先查这里。
• 交互模式手册：键盘快捷键、Vim 模式、命令历史——补足"怎么高效输入"这一面。
• Skills 文档：当你觉得 Markdown 命令不够用，想造可自动触发的能力时，从这里进阶。
• CLI 参考与启动参数：claude --help 列出的启动期 flag，与本文的会话内命令互补。

掌握命令词汇只是起点。真正的高手，是把 /plan /effort /compact /rewind 编进肌肉记忆——让 Claude Code 在你的节奏里工作，而不是被它的节奏拖着走。

训练营适用性评估

• 适合类型：开发者入门营、AI 编程工具实战营、企业内部 Claude Code 推广营。零基础友好，前置只需装好 Claude Code。
• 教学时长：讲授 + 跟练约 90 分钟（讲授 40 分钟、第九节实战跟练 40 分钟、答疑 10 分钟）。
• 评估方式：要求学员在自建仓库里跑通 /init → /plan → /diff → /code-review 并截图提交；加分项为创建一条带 allowed-tools 的自定义命令。
• 延伸衔接：本篇为"命令词汇层"，下一轮可衔接到 Skills 开发（把命令升级为可自动触发的技能）与 Hooks（用事件钩子织自动化）。

参考来源

1. Commands — Claude Code Docs — 官方命令全表，含每条命令用途、参数与引入版本，本文工作流分阶段框架即据此整理。
2. Claude Code Cheat Sheet - Shortcuts, Commands, Tips [2026] — 2026 版（2.1.x，Opus 4.8 默认）速查表，覆盖斜杠命令、CLI flag 与快捷键。
3. Claude Code Custom Slash Commands — Complete Guide 2026 — 自定义命令实操指南，详解 frontmatter、$ARGUMENTS、allowed-tools 与 argument-hint。
4. Claude Code Slash Commands: Complete Reference Guide 2026 — 命令全景与按工作流分组的使用示例。
5. claude-code-docs / claude-code-slash-commands.md (GitHub) — 社区维护的命令文档，含参数系统与子目录命名空间说明。

[!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 等场景全覆盖。