Claude Code指令入门教程：照抄实例精选

这是一份专为零基础接触Claude Code的用户设计的手把手实战指南。每一条指令都会先给出官方定义，再用直白解读说明其实际用途，最后附上可直接套用的代码示例。读完就能立刻上手操作。

序：到底什么是“指令”？

Claude Code 是运行在终端环境里的AI编程伙伴。你可以像与同事协作一样，直接对它说“请帮我重构这个函数”，它会自动读取代码、修改文件、编写测试。

除此之外，它还内置了一批以斜杠 / 开头的快捷命令，称为Slash Commands（斜杠指令）。这些指令相当于控制Claude Code工具本身的快捷操作按钮，例如：

• /clear 清空当前对话
• /model 切换AI模型
• /resume 恢复之前的会话

一个清晰的区分：

普通 prompt = 你让AI执行的具体任务（例如“帮我设计一个登录接口”）斜杠指令 = 你操作Claude Code这个工具的功能开关（例如“清空聊天”、“更换模型”、“退出程序”）

一、务必先牢记的 3 个基础常识

1. 指令必须写在消息最开头

/model sonnet              ✅ 正确：会触发模型切换
请帮我 /model sonnet        ❌ 错误：这只是一句普通对话内容

原因：Claude Code 只在消息的起始位置检测到 / 时，才会将其解析为指令。夹在文字中间的 / 一律视为普通文本。

2. 记不清指令？直接输入一个/

在输入框中只键入一个 /，界面会立刻弹出当前可用的全部指令列表。你还可以继续输入字母进行过滤（例如输入 /br 会展示 /branch）。

每位用户看到的指令数量可能不同！原因在于：

• 部分指令仅在特定操作系统上存在（如 /desktop 只在 macOS/Windows 可用）
• 部分指令仅面向特定订阅等级（如 /upgrade 只对 Pro/Max 用户开放）
• 安装插件后，部分指令才会出现

因此，“本地输入 / 看到的列表”永远比任何文档中的列表更准确。

3. 看懂官方文档的参数标记

• 表示必填参数，缺省会报错

  • 例：/add-dir → 必须写成 /add-dir ~/myproject

• [arg] 表示可选参数，不填也能正常运行

  • 例：/compact [instructions] → 可以只输入 /compact，也可以输入 /compact 只保留登录模块相关内容

二、全景地图：Claude Code 总共有多少指令？

截至 2026 年 5 月，官方文档 Commands - Claude Code Docs 列出的内置指令共计 83 个（包含别名和已废弃的指令）。按功能可划分为 8 大类：

对新手而言，只需掌握大约 10 条核心指令即可满足日常工作，第四章会专门讲解这 10 条。先看第三章，重点解决两个最容易踩坑的指令：/btw 和 /branch，以及正确的切换方式。

三、新手 99% 会卡住的问题：/btw和/branch如何切回原会话？

这是用户提问频率最高的问题，没有之一。先看示意图：

/btw — 看起来像切换，实际上并未离开

官方说明：Ask a quick side question without adding to the conversation.（在不增加主对话记录的前提下，提出一个简短的问题。）

直白解读：当你正在和Claude讨论一个大型功能，突然想问一个完全不相关的问题，比如“Python dataclass 和 pydantic 有什么区别？”。如果直接提问，这次问答会永久写入对话历史，以后每次交互Claude都要重复读取这段记录，导致 token 消耗持续增加。/btw 提供了一个临时空间：

1. 它会复制当前上下文到这个临时区域
2. 在这个临时空间里回答你的问题
3. 回答结束后，立即丢弃这个临时空间

因此，主对话的历史记录不会增加任何内容，也不会浪费多余的 token。

示例

/btw git rebase 和 git merge 有什么区别？

如何回到原会话？ — 无需切换，因为你从未离开。答案显示后，你仍然在原会话中，直接输入下一条 prompt 即可继续。

不适用场景：需要多轮追问的情况。/btw 仅提供一次单轮问答机会。如果你想追问“那 rebase 冲突怎么解决？”，这次追问不会继承上一个 /btw 的上下文。此时使用普通 prompt 更合适。

/branch（别名/fork）— 确实创建了新会话，需要手动切回

官方说明：Create a branch of the current conversation at this point. Switches you into the branch and preserves the original.（从当前节点创建一条会话分支，将你切换到分支中，原会话完整保留。）

直白解读：假设你正在和Claude一起开发，中途想“换个方案试试”，但又担心丢失当前成果。/branch 类似于 Git 的分支机制：

1. 将当前对话完整复制一份作为新会话
2. 将你切换到新会话中继续操作
3. 原会话不受任何影响，随时可以返回

示例：先命名主线，再创建分支

/rename main
/branch try-another-way

现在你处于 try-another-way 分支。想回到主线？有两种方法：

方法 1：/resume 切回（推荐）

/resume

执行后会弹出会话选择器，展示所有历史会话。选择名为 main 的那条即可回到主线。如果你记得会话名称，也可以直接：

/resume main

方法 2：先退出再重新进入

# 先 /exit 退出
claude --resume main
# 或者交互式选择
claude --resume

3 个防止迷路的实用习惯

1. 创建分支前，先使用 /rename main 给主线命名，避免出现一堆 “Unnamed session” 难以区分
2. 不确定当前位置？用 /recap 查看会话摘要，或 /status 查看会话详细信息
3. 分支用完不想要了，直接 /resume 切回主线即可，分支虽保留但不会干扰当前操作

一句话总结：/btw 自动返回原会话，/branch 需要靠 /resume 手动切回。

四、新手 10 条黄金指令（配详细解读）

这 10 条指令覆盖了 90% 的日常场景。先熟练掌握这 10 条，其他指令用到时再查阅。

1. /help — 随时调取帮助文档

官方：Show help and a vailable commands.

直白解读：当你忘记有哪些指令可用，或者不确定某条指令的具体拼写时，第一时间使用它。它会列出当前环境下所有可用的指令，并附带使用方法说明。

/help

适用场景：任何时刻——刚安装完成想探索功能、忘了 /compact 还是 /compress、安装插件后想查看新增的命令。

2. /init — 让 Claude 了解你的项目结构

官方：Initialize project with a CLAUDE.md guide.

直白解读：当你首次进入一个项目目录时，Claude 对你的代码库一无所知。/init 会让 Claude 自动扫描项目，然后在根目录生成一个 CLAUDE.md 文件，其中记录：

• 项目的功能定位和使用的技术栈
• 关键目录结构
• 重要开发约定（例如“所有 API 必须通过 middleware 校验”）

之后每次在该项目中使用 Claude，它都会自动读取 CLAUDE.md，无需你重复解释。这相当于给了它一本“新员工入职手册”。

/init

适用场景：在新项目中首次使用 Claude Code 时，第一步就应该执行它。

3. /clear和/compact — 两兄弟：节省 token、延长会话

这两个指令虽然名称相似，但作用完全不同。

/clear — 清空所有，重新开始

官方：Start a new conversation with empty context. The previous conversation stays a vailable in /resume.

直白解读：彻底清空当前对话，从零开始重新交流，效果类似于关闭应用再重新打开。不用担心数据丢失：旧会话不会被删除，需要通过 /resume 即可找回。

/clear

/compact — 压缩历史，继续当前话题

官方：Free up context by summarizing the conversation so far.

直白解读：当前项目讨论得十分复杂，已经来回交流了 50 轮。每次 Claude 都需要读取前 50 轮的全部内容才能回答——既慢又贵。/compact 会让 Claude 将前 50 轮对话总结为一段简短的摘要，后续交流只基于这段摘要进行，保留了关键信息，但大幅减小了上下文体积。

/compact
/compact 只保留和登录模块相关的内容    ← 可以指定压缩重点

决策对比：

• 当前任务已完成，准备开始新任务 → /clear
• 当前任务尚未完成，但对话过长 → /compact

4. /resume — 找回之前的对话记录

官方：Resume a conversation by ID or name, or open the session picker. Alias: /continue.

直白解读：下班前，你正和Claude讨论一个 bug，关机离开。第二天想继续讨论——使用这个指令。它会弹出一个历史会话列表，选中一条就能回到当时的对话上下文，之前的修改记录、讨论细节都完整保留。

/resume             ← 打开选择器，查看历史列表
/resume login-bug   ← 如果会话已命名，可直接跳转

配合 /rename 效果更佳：开始一个新话题时，先执行 /rename my-task，以后直接 /resume my-task 即可一秒回到现场。

5. /rewind — 终极撤销键（Ctrl+Z 增强版）

官方：Rewind the conversation and/or code to a previous point. Aliases: /checkpoint, /undo.

直白解读：Claude 刚帮你修改了 5 个文件，但结果反而更糟糕——不必慌张。/rewind 会弹出一个菜单让你选择：

• Restore code and conversation：代码和对话同时回到该节点
• Restore conversation：仅回退对话记录，保留代码修改
• Restore code：仅回退代码修改，保留对话记录

/rewind

比手动执行 git reset --hard 更安全，因为它同时管理对话历史，无需你重新向Claude解释当前状态。

适用场景：Claude 自作主张修改过多、修改方向错误、或者你自己表述错误需要重来。

6. /model — 切换模型，省钱或提升质量

官方：Select or change the AI model.

直白解读：Claude 提供多种型号：

• Haiku：价格最低、响应最快、能力相对较弱——适合写注释、修正错别字、格式化文档
• Sonnet：中等价位、中等能力——日常开发的主力选择
• Opus：价格最高、能力最强——处理复杂架构设计、疑难问题的首选

简单任务用便宜模型节省成本，复杂问题用强模型确保思考深度。

/model           ← 打开选择器
/model sonnet    ← 直接切换到 Sonnet

顺带了解 /effort：同一模型内，还可以调整推理强度。/effort high 会让它思考得更细致（消耗更大），/effort low 会让它更快回应（消耗更少）。

7. /btw — 问一个不污染主对话的临时问题

详见第三章详解。一句话记忆：/btw 你的问题，回答后自动返回原会话，节省 token 且不破坏对话历史。

/btw Nginx 的 proxy_pass 末尾加不加斜杠有什么区别？

8. /permissions和/fewer-permission-prompts — 消除频繁的授权弹窗

官方 /permissions：Manage allow, ask, and deny rules for tool permissions.官方 /fewer-permission-prompts：Scan your transcripts for common read-only Bash and MCP tool calls, then add a prioritized allowlist.

直白解读：Claude 每次要执行一条 bash 命令（例如 ls、grep、git status）时，都会弹窗询问“是否允许？”——相当烦人。这两个指令就是为了减少这种打扰。

• /permissions：手动设置白名单，精细控制哪些命令可以免确认执行
• /fewer-permission-prompts：让 Claude 扫描你的历史使用记录，自动把那些只读、无风险的命令加入白名单

/permissions                    ← 进入手动管理界面
/fewer-permission-prompts       ← 让 AI 自动帮你配置

安全提醒：仅将只读命令（ls、cat、grep、git status）加入白名单是安全的；切勿将写入操作（rm、mv、curl）一股脑加入，否则 Claude 执行危险命令时你可能毫不知情。

9. /review和/security-review — 提交 PR 前自我检查

官方 /review：Review a pull request locally in your current session.官方 /security-review：Analyze pending changes on the current branch for security vulnerabilities.

直白解读：代码开发完毕准备提 PR 时，让 Claude 先帮你过一遍，能有效阻挡许多低级错误。

• /review [PR号]：像代码审查者一样阅读你的改动，指出逻辑问题和代码风格问题
• /security-review：专门扫描安全风险，例如 SQL 注入、明文密钥、越权检查等问题

/review 1234
/security-review

适用场景：自己提交前先执行一遍，远好过在同事的代码评审中被指出问题。

10. /doctor — 遇到异常情况时使用

官方：Diagnose and verify your Claude Code installation and settings.

直白解读：当 Claude Code 响应异常、工具无法使用、登录状态过期、配置文件损坏时——先执行这个指令。它会：

1. 检查安装是否完整
2. 验证账号登录状态
3. 检查插件、权限、配置是否存在冲突
4. 列出所有发现的问题

然后，按 f 键，Claude 会尝试自动修复。

/doctor

五、5 分钟上手流程：首次使用按步骤操作即可

六、全部 83 条指令分类完整清单（每条均附示例）

以下是完整列表，无需死记硬背。作为参考目录使用即可——真正需要某条指令时再查阅。标记 [Skill] 的为官方内置技能（可手动调用，也可被自动触发）。

会话与上下文管理（最常用）

模型、效果与外观配置

权限、安全与工具管理

项目与任务规划

Git / PR / Code Review

集成、分发与远程访问

Skills 与插件扩展

账号、计费与反馈

诊断与系统维护

七、最容易混淆的指令对比（附示例）

以下指令名称相似或功能容易混淆，单独列表帮助快速区分差异。

八、进阶：自定义你的/指令

Claude Code 现在将“自定义命令”与 Skills 整合为统一机制。在项目目录中创建以下文件：

.claude/skills/commit-msg/SKILL.md

在该文件中定义 name、description 和 prompt 模板，之后在会话中即可使用：

/commit-msg

团队成员克隆仓库后，即可共享同一套自定义命令。

MCP 服务器暴露的 prompt 会自动注册为 /mcp____ 格式，可直接调用：

/mcp__github__create_issue

九、常见疑问 FAQ

Q1：我看到的指令比文章中列出的少，这正常吗？

A：完全正常。指令是否显示取决于你的操作系统、订阅计划和插件安装情况。在终端中输入 / 看到的列表始终是最准确。

Q2：/compact 会导致 Claude “忘记”关键信息吗？

A：会进行压缩，但不会彻底丢失。为保险起见，可以给指令添加提示：/compact 保留 API 设计部分和数据库 schema。如果担心丢失细节，压缩前先用 /export 导出一份对话备份。

Q3：/rewind 可以回退多少步？

A：可以回到当前会话中任意一个 Claude 做出更改的节点，不限步数。但前提是这次会话尚未关闭——关闭会话后重新打开，回退历史将丢失（但代码修改仍在磁盘上）。

Q4：/model 切换模型后，前面的对话记录会丢失吗？

A：不会。切换模型只是更换 AI 的处理核心，对话上下文依然保留。

Q5：创建了太多 /branch，最后分不清怎么办？

A：为每条分支使用 /rename 命名。/resume 选择器中会按名称加时间排序。不用的分支无需特意清理，保留即可，只要不打开就不会产生消耗。

Q6：/usage 显示的价格准确吗？

A：准确。它是基于实际 API 调用计算的。Pro/Max 订阅用户会显示相对于套餐额度的消耗比例。

结语

指令虽然看起来数量多，但日常使用中第四章列出的 10 条核心指令就足够了。其余 70 多条留到遇到实际需求时再查阅即可。最容易卡住的问题是“进入某个状态后如何退出”，记住三个反悔键：

• 忘记路径 → /help
• 回到之前状态 → /resume
• 撤销刚才操作 → /rewind

做到这些，你就已经比 80% 的 Claude Code 用户更熟练了。

最终建议：无需一次性读完本文。先把第三章（/btw vs /branch）+ 第四章（10 条黄金指令）+ 第五章（5 分钟上手流程）这三部分吃透，立刻就能开始实际开发；第六章作为参考目录收藏备用；第七章是遇到问题时的急救工具包。

本文参考：Commands - Claude Code Docs（官方）