平时做技术实践时，很多问题不是概念不会，而是细节没串起来。拿“Claude Code指令超详细入门教程(含照抄的例子)”来说，它看着像小点，放到项目里常会牵出环境、配置、兼容性和维护成本。下面按实际采用顺序，把思路、关键写法和容易踩坑的地方讲清楚，便于大家直接对照操作。

目录

• 序:什么是"指令"?
• 一、必须先记住的 3 个常识
• 1. 指令必须是消息的第一个字符
• 2. 忘了指令?直接敲一个/
• 3. 看懂官方文档的参数记号
• 二、整体地图:Claude Code 一共有多少指令?
• 三、新手 99% 会卡住的问题:/btw和/branch怎么切回去?
• /btw— 表面像切换,其实没切
• /branch(别名/fork)— 真的开了新会话,要手动切回
• 四、新手 10 条指令(配超详细解释)
• 1./help— 救命文档
• 2./init— 让 Claude 认识你的项目
• 3./clear和/compact— 两兄弟:省钱、续命
• /clear— 清空一切,重新开始
• /compact— 压缩历史,继续当前话题
• 4./resume— 找回昨天没说完的话
• 5./rewind— 终极反悔键(Ctrl+Z 加强版)
• 6./model— 换模型,省钱或提质
• 7./btw— 问一句不污染主线的题外话
• 8./permissions和/fewer-permission-prompts— 告别弹窗骚扰
• 9./review和/security-review— 提 PR 前自查
• 10./doctor— 什么都不对劲时按它
• 五、5 分钟上手流程:第一次用照着敲就行
• 六、所有 83 条指令分类大全(每条都带示例)
• 会话与上下文(最常用)
• 模型、效果与外观
• 权限、安全与工具
• 项目与规划
• Git / PR / Code Review
• 集成、分发与远程
• Skills 与插件
• 账号、计费、反馈
• 诊断与系统
• 七、最容易混淆的指令对比(带示例)
• 八、进阶:定义你自己的/指令
• 九、常用疑问 FAQ
• 结语

在这个场景下，这是一篇写给完全没用过 Claude Code 的同学的超详细入门教程。每条指令都会先给你官方说明,再用大白话解释它到底是干嘛用的,最后配一个能够照抄的例子。读完就能上手。

序:什么是"指令"?

结合项目来看，Claude Code 是个跑在终端里的 AI 编程助手。你能够像跟同事聊天那样跟它说"帮我把这个函数重构一下",它就会去读代码、改文件、写测试。

但除了"聊天"之外,它还提供了一批以斜杠 / 开头的快捷命令落到代码里，,叫做 Slash Commands(斜杠指令)。这些指令是终端界面提供的控制按钮,比如:

• /clear 清空对话
• /model 换模型
• /resume 回到之前的会话

一句话区分:

普通 prompt = 你让 AI 干活的内容(比如"帮我写个登录接口")斜杠指令 = 你操作 Claude Code 这个工具本身的按钮(比如"清空"、"换模型"、"退出")

一、必须先记住的 3 个常识

1. 指令必须是消息的第一个字符

/model sonnet              ✅ 正确:会触发换模型
请帮我 /model sonnet        ❌ 错误:这就是一句普通聊天

为什么从实现思路看，:Claude Code 只在你消息开头看到 / 才把后面当指令解析,中间的 / 一律当普通文字。

2. 忘了指令?直接敲一个/

在对话框里只输入一个 /,界面会自动弹出当前能用的全部指令列表落到代码里，,能够继续输字母过滤(比如输 /br 会看到 /branch)。

每个人能看到的指令数量可能不一样!因为:

• 有些指令只在特定平台有(如 /desktop 只在 macOS/Windows)
• 有些指令只对特定订阅有(如 /upgrade 只对 Pro/Max)
• 有些指令装了插件才出现

所以"本地输 / 看到的列表"永远比文章里的列表更准。

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

• <arg> 表示必填参数,不给会报错

  • 例:/add-dir <path> → 必须写 /add-dir ~/myproject

• [arg] 表示可选参数,不给也能跑

  • 例:/compact [instructions] → 能够光写 /compact,也能够写 /compact 只保留登录相关

二、整体地图:Claude Code 一共有多少指令?

截至 2026 年 5 月,官方文档 Commands - Claude Code Docs 列出的内置指令共 83 个(含别名和已移除的)。按用途大致能够分成 8 大类:

新手其实只需掌握 10 条左右就够用了在这个场景下，,后面会在第四章专门讲。先继续看第三章,先把两个最容易踩坑的指令 /btw 和 /branch 搞清楚。

三、新手 99% 会卡住的问题:/btw和/branch怎么切回去?

这是用户最常问的问题,没有之一。先看图:

/btw— 表面像切换,其实没切

官方说明:Ask a quick side question without adding to the conversation.(问一个不加入主对话的小问题)

大白话从实现思路看，:你正和 Claude 讨论一个大项目,突然想问一句完全无关的"Python dataclass 和 pydantic 有啥区别?"。如果直接问,这次问答会永久写进你的对话历史,以后每次 Claude 都要把它带上一起读,越攒越贵。/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 available 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— 两兄弟:省钱、续命

这两个指令长得像,作用完全不同。

/clear— 清空一切,重新开始

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

大白话:把当前对话彻底清空,从零开始聊,效果就像关了 App 又重新打开。不用担心丢数据结合项目来看，:老会话不会被删除,想找回来用 /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 你的问题,答完自动回主线,省钱不破坏对话历史。

/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号]:像个 reviewer 那样读你的改动,指出逻辑问题、风格问题
• /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] 的是官方内置 Skill(可手动调用也可被自动触发)。

会话与上下文(最常用)

模型、效果与外观

权限、安全与工具

项目与规划

Git / PR / Code Review

集成、分发与远程

Skills 与插件

账号、计费、反馈

诊断与系统

七、最容易混淆的指令对比(带示例)

这些指令名字长得像、作用容易搞混,单独列一张表记住差异。

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

Claude Code 现在把"自定义命令"和 Skills 合成一套机制。在项目里新建:

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

文件里写好 name、description 和 prompt 模板,会话里用:

/commit-msg

就能调用。团队成员 clone 仓库即可共享同一套自定义命令。

MCP 服务器暴露的 prompt 会自动注册成 /mcp__<server>__<prompt> 形式,同样直接调用:

/mcp__github__create_issue

九、常用疑问 FAQ

Q1:我看到的指令比文章里少,正常吗?

A:完全正常。指令是否出现取决于你的操作系统、订阅计划和插件安装情况。在终端里敲 / 看到的列表永远最准。

Q2:/compact 会不会让 Claude "忘记"关键信息?

A:会压缩但不会彻底丢失。想保鲜一点能够给它指示:/compact 保留 API 设计部分和数据库 schema。真的担心压丢细节,压之前先 /export 导出一份对话备份。

Q3:/rewind 能回退几步?

A:能回到本次会话中任意一个 Claude 做出更改的节点,不限步数。但前提是这次会话还没关从实现思路看，——关了会话再开回来,rewind 历史就丢了(但代码修改在磁盘上还在)。

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(官方)

结合项目来看，到此这篇关于Claude Code指令超详细入门教程的文章就介绍到这了,更多相关ClaudeCode指令入门内容请搜索脚本之家以前的文章或继续浏览下面的相关文章，希望大家以后多多兼容脚本之家！