> 本文面向刚装好 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 Code 版本 | v2.1.x（2026 当前主线） | 本教程命令以 v2.1.150+ 为准，部分命令标注了引入版本 | | 账号 | 已 `/login` 登录 | 默认模型 Opus 4.8 | | 终端 | 任意现代终端 | 推荐 iTerm2 / Windows Terminal / GNOME Terminal | | Git | 已安装 | 实战案例需要 git 仓库 | | Node.js | 18+ | 仅当你要运行示例项目代码时需要 | 确认环境无误后，在任意目录输入 `claude` 进入交互会话，输入 `/` 即可看到全部可用命令。 ## 三、核心心智模型：命令是会话的控制面板 理解斜杠命令，先记住三条铁律： **铁律一：命令必须出现在消息开头。** `请帮我 /clear` 不会触发清除——`/clear` 不在开头，会被当成普通文字。正确写法是新起一条消息，直接输入 `/clear`。 **铁律二：命令后面的文字是参数。** 输入 `/plan 重构登录模块`，其中"重构登录模块"是传给 `/plan` 的描述参数；输入 `/compact 只保留数据库相关的决定`，"只保留数据库相关的决定"是压缩时的聚焦指令。 **铁律三：命令分三类来源。** 内置命令（编码在 CLI 里）、捆绑技能（bundled skill，本质是交给 Claude 的提示词，Claude 也能在相关时自动调用）、动态工作流（fan-out 到多个子代理的后台编排）。在 `/` 菜单里它们外观一致，但底层机制不同。 下面这张流程图把命令按"一个项目的生命周期"组织起来，是后续每一节的导航图： ```mermaid 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` —— 生成项目说明书 在仓库根目录执行： ```bash 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 版显著强化了并行能力，新手至少要认识这四条： | 命令 | 用途 | 适用场景 | | --- | --- | --- | | `/agents` | 管理子代理配置；委派边角任务 | 让一个子代理专门跑测试 | | `/fork <指令>` | 派生一个继承全部对话的后台子代理 | "你去把文档补全，我继续写代码" | | `/tasks` | 查看当前会话后台在跑什么 | 监控 fork 出去的子代理 | | `/batch <指令>` | 把大改动拆成 5–30 个独立单元并行执行 | 全仓库框架迁移、批量改名 | `/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`（安全漏洞扫描）。 ## 八、阶段五：跨会话与排障——回溯与自愈 | 命令 | 用途 | | --- | --- | | `/clear`（别名 `/reset` `/new`） | 清空上下文开新任务，旧会话仍可在 `/resume` 找到 | | `/resume`（别名 `/continue`） | 按 ID/名称恢复会话，后台会话也会出现在选择器（标 `bg`） | | `/branch [名称]` | 在当前点开一条对话分支，尝试另一方向而不丢原线 | | `/rewind`（别名 `/checkpoint` `/undo`） | 把对话和/或代码回滚到检查点，或从某条消息开始总结 | | `/doctor` | 诊断安装与设置，按 `f` 让 Claude 修复报告的问题 | | `/debug [描述]` | 开启当前会话调试日志并读日志排查 | | `/status` | 显示版本、模型、账号、连通性（Claude 响应中也能用） | `/rewind` 是新手的"后悔药"：Claude Code 会自动建检查点，改坏了能整体回退，比手动 `git stash` 安全得多。 ## 九、实战案例：在一个最小项目里串起十余条命令 下面用一个可运行的示例项目，把上述命令真正跑一遍。 ### 9.1 准备项目 ```bash 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` 随时找回。 整个闭环用一张时序图概括： ```mermaid 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： ```markdown --- 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`（大写、带美元符），且调用时命令名后有空格再接参数。 ## 十一、命令速查卡（按场景） | 场景 | 首选命令 | | --- | --- | | 新仓库上手 | `/init` → `/memory` → `/permissions` | | 大改动前 | `/plan` | | 想更聪明/更省 | `/model`、`/effort` | | 上下文吃紧 | `/context` → `/compact` | | 委派边角活 | `/fork`、`/agents` | | 大规模并行改造 | `/batch` | | 提交前自查 | `/diff` → `/code-review` | | 只想顺手清理 | `/simplify` | | 改坏了回退 | `/rewind` | | 换任务/找回旧会话 | `/clear`、`/resume` | | 安装/运行异常 | `/doctor`、`/debug`、`/status` | | 减少审批弹窗 | `/fewer-permission-prompts` | ## 延伸阅读 - **官方命令全表**：`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](https://code.claude.com/docs/en/commands) — 官方命令全表，含每条命令用途、参数与引入版本，本文工作流分阶段框架即据此整理。 2. [Claude Code Cheat Sheet - Shortcuts, Commands, Tips [2026]](https://computingforgeeks.com/claude-code-cheat-sheet/) — 2026 版（2.1.x，Opus 4.8 默认）速查表，覆盖斜杠命令、CLI flag 与快捷键。 3. [Claude Code Custom Slash Commands — Complete Guide 2026](https://www.claudebuddy.art/blog/claude-code-custom-slash-commands-guide) — 自定义命令实操指南，详解 frontmatter、`$ARGUMENTS`、`allowed-tools` 与 `argument-hint`。 4. [Claude Code Slash Commands: Complete Reference Guide 2026](https://learn-prompting.fr/blog/claude-code-slash-commands-reference) — 命令全景与按工作流分组的使用示例。 5. [claude-code-docs / claude-code-slash-commands.md (GitHub)](https://github.com/gregpriday/claude-code-docs/blob/main/claude-code-slash-commands.md) — 社区维护的命令文档，含参数系统与子目录命名空间说明。 > [!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 等场景全覆盖。