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

序:什么是"指令"?
Claude Code 是个跑在终端里的 AI 编程助手。你可以像跟同事聊天那样跟它说"帮我把这个函数重构一下",它就会去读代码、改文件、写测试。
但除了"聊天"之外,它还提供了一批以斜杠 / 开头的快捷命令,叫做 Slash Commands(斜杠指令)。这些指令是终端界面提供的控制按钮,比如:
/clear清空对话/model换模型/resume回到之前的会话
一句话区分:
普通 prompt = 你让 AI 干活的内容(比如"帮我写个登录接口")斜杠指令 = 你操作 Claude Code 这个工具本身的按钮(比如"清空"、"换模型"、"退出")
一、必须先记住的 3 个常识
1. 指令必须是消息的第一个字符
bash
/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 大类:

| 类别 | 干嘛用的 | 典型指令 |
|---|---|---|
| 会话与上下文 | 管理对话、压缩历史、撤销 | /clear /compact /resume /rewind |
| 模型与外观 | 换模型、调推理强度、换主题 | /model /effort /theme |
| 权限与安全 | 控制 AI 能用什么工具 | /permissions /sandbox |
| 项目与规划 | 项目初始化、任务规划 | /init /plan /memory |
| Git 与 PR | 代码审查、自动修复 PR | /review /security-review |
| 集成与远程 | IDE、浏览器、远程控制 | /ide /remote-control |
| Skills 与插件 | 扩展能力 | /skills /plugin |
| 账号与诊断 | 登录、用量、疑难杂症 | /login /usage /doctor |
新手其实只需要掌握 10 条左右就够用了 ,后面会在第四章专门讲。先继续看第三章,先把两个最容易踩坑的指令 /btw 和 /branch 搞清楚。
三、新手 99% 会卡住的问题:/btw 和 /branch 怎么切回去?
这是用户最常问的问题,没有之一。先看图:

/btw --- 表面像切换,其实没切
官方说明:Ask a quick side question without adding to the conversation.(问一个不加入主对话的小问题)
大白话 :你正和 Claude 讨论一个大项目,突然想问一句完全无关的"Python dataclass 和 pydantic 有啥区别?"。如果直接问,这次问答会永久写进你的对话历史,以后每次 Claude 都要把它带上一起读,越攒越贵 。/btw 就是给你开个小后门:
- 它会复制一份当前上下文到临时空间
- 在这个临时空间里回答你这一个问题
- 答完把临时空间丢掉
所以主对话的历史不会多一行字,也不会多花 token。
示例
bash
/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 的分支:
- 把当前对话原样拷贝一份作为新会话
- 把你切进新会话里继续折腾
- 原会话完整保留,随时能回去
示例:先命名主线,再开分支
bash
/rename main
/branch try-another-way
现在你已经在 try-another-way 这个分支里了。折腾完想回主线?有两种办法:
方法 1:/resume 切回(推荐)
bash
/resume
敲完会弹出一个会话选择器,列出你所有历史会话。选 main 那条即可回到主线。如果你记得名字,还能直接:
bash
/resume main
方法 2:先退出再重进
css
# 先 /exit 退出
claude --resume main
# 或者交互式选
claude --resume
3 个防止迷路的小习惯
- 分支前先
/rename main给主线起个名字,免得一堆 "Unnamed session" 分不清 - 不确定自己现在在哪条线?用
/recap看一行总结,或/status看会话信息 - 分支玩完不想要了,直接
/resume切回主线就行,分支依然保留但不干扰你
一句话总结 :/btw 自动回来,/branch 要靠 /resume 回来。
四、新手 10 条黄金指令(配超详细解释)
这 10 条覆盖了 90% 的日常场景。先把这 10 条练熟,其他用到再查。
1. /help --- 救命文档
官方:Show help and available commands.
大白话:你忘了有哪些指令、某条指令怎么拼,第一反应就按这个。它会把当前环境下所有可用指令列出来,点对点告诉你怎么用。
bash
/help
什么时候用 :任何时候都可以------刚装好想看看有什么玩的、忘了 /compact 还是 /compress、插件装好想看有没有新命令进来。
2. /init --- 让 Claude 认识你的项目
官方 :Initialize project with a
CLAUDE.mdguide.
大白话 :Claude 第一次进你这个项目目录时,对你代码库一无所知。/init 会让 Claude 自动扫描一遍项目,然后在根目录生成一个 CLAUDE.md 文件,里面写着:
- 项目是干嘛的、用什么技术栈
- 关键目录结构
- 重要约定(比如"所有 API 都要走 middleware 校验")
以后你每次打开这个项目,Claude 都会自动读一遍 CLAUDE.md,不用你重新解释。等于给它一本"新员工入职手册"。
bash
/init
什么时候用:在一个新项目第一次用 Claude Code 时,第一步就该敲它。
3. /clear 和 /compact --- 两兄弟:省钱、续命
这两个指令长得像,作用完全不同。
/clear --- 清空一切,重新开始
官方 :Start a new conversation with empty context. The previous conversation stays available in
/resume.
大白话 :把当前对话彻底清空,从零开始聊,效果就像关了 App 又重新打开。不用担心丢数据 :老会话不会被删除,想找回来用 /resume 即可。
arduino
/clear
/compact --- 压缩历史,继续当前话题
官方:Free up context by summarizing the conversation so far.
大白话 :你正在聊的这个项目很复杂,已经来回 50 轮对话了,每次 Claude 都要把前面 50 轮全部读一遍才能回答你下一句------又慢又贵。/compact 会让 Claude 把前面 50 轮总结成一小段摘要 ,后面继续聊时只带着这段摘要,历史信息保留,但体积变小。
bash
/compact
/compact 只保留和登录模块相关的内容 ← 可以指定重点
对比决策:
- 这件事做完了,要开始做新的 →
/clear - 这件事没完,但对话太长了 →
/compact
4. /resume --- 找回昨天没说完的话
官方 :Resume a conversation by ID or name, or open the session picker. Alias:
/continue.
大白话 :下班前你和 Claude 正讨论一个 bug,关机走人;第二天想接着聊------用这个。它会弹出一个历史会话列表,选一条就回到当时的对话上下文,连同你之前的改动记录、讨论细节都在。
bash
/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:只回退代码,保留对话
bash
/rewind
比手动 git reset --hard 安全得多,因为它还管对话历史,不用你重新给 Claude 解释状况。
什么时候用:Claude 自作主张改多了、改错方向了、或者你自己话说错了想重来。
6. /model --- 换模型,省钱或提质
官方:Select or change the AI model.
大白话:Claude 有不同型号:
- Haiku:便宜、快、笨一点------适合写注释、改错别字、整理格式
- Sonnet:中等价位、中等智力------日常开发主力
- Opus:最贵、最强------复杂架构设计、难题攻关
简单活用便宜模型省钱,难题用强模型才能想清楚。
bash
/model ← 打开选择器
/model sonnet ← 直接切换到 Sonnet
顺手记一下 /effort :同一个模型,还能调推理强度。/effort high 会让它想得更仔细(更贵),/effort low 会让它答得更快(更便宜)。
7. /btw --- 问一句不污染主线的题外话
见第三章详解。一句话记住 :/btw 你的问题,答完自动回主线,省钱不破坏对话历史。
bash
/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 扫描你的历史记录,自动把那些只读的、没危险的命令加进白名单
bash
/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 注入、明文密钥、越权检查
bash
/review 1234
/security-review
什么时候用:自己提交前跑一遍,比被同事在评论区喷强多了。
10. /doctor --- 什么都不对劲时按它
官方:Diagnose and verify your Claude Code installation and settings.
大白话:Claude Code 响应奇怪、工具用不了、登录好像过期了、配置文件好像坏了------先按这个。它会:
- 检查安装是不是完整
- 检查账号登录状态
- 检查插件、权限、配置有没有冲突
- 列出所有问题
然后你按 f 键,Claude 会尝试自动修复。
bash
/doctor
五、5 分钟上手流程:第一次用照着敲就行

| 步骤 | 要敲的 | 为什么这么做 |
|---|---|---|
| 1. 进项目 | cd ~/my-project && claude |
在项目根目录启动,Claude 才能访问你的代码 |
| 2. 初始化 | /init |
生成 CLAUDE.md,让 Claude 熟悉你的项目 |
| 3. 挑模型 | /model sonnet |
日常够用又不贵 |
| 4. 命名会话 | /rename my-feature |
方便明天 /resume my-feature 直接回来 |
| 5. 减少弹窗 | /fewer-permission-prompts |
把常用只读命令加白名单 |
| 6. 开始干活 | 帮我把登录接口改成 JWT |
用普通 prompt 描述需求 |
| 7a. 改错了 | /rewind |
回到改之前的状态 |
| 7b. 对话太长 | /compact 保留鉴权相关 |
压缩不丢重点 |
| 7c. 临时查东西 | /btw JWT 和 Session 优缺点? |
不污染主线 |
| 7d. 换思路试试 | /branch try-oauth |
开分支实验,失败再切回 |
| 8. 提交前自查 | /review + /security-review |
代码质量 + 安全双保险 |
| 9. 看花了多少 | /usage |
监控这次的 token 消耗 |
| 10. 下班 | /exit |
退出。会话会自动保存,明天 /resume 回来 |
六、所有 83 条指令分类大全(每条都带示例)
下面是完整清单,不用硬记。当做目录查即可------真用到哪条再翻哪条 。标 [Skill] 的是官方内置 Skill(可手动调用也可被自动触发)。
🟣 会话与上下文(最常用)
| 指令 | 作用 | 示例 |
|---|---|---|
/help |
显示帮助与当前可用指令 | /help |
/clear |
清空上下文开新对话,原会话保留 | /clear |
/compact [instructions] |
摘要压缩上下文,保留当前话题 | /compact 只保留和登录模块相关的内容 |
/context |
可视化上下文占用,看谁占得多 | /context |
/resume [session] |
恢复历史会话 / 打开选择器 | /resume 或 /resume my-feature |
/rewind |
回退到某个时间点(对话/代码/两者) | /rewind 然后在交互菜单里选 |
/branch [name] |
从当前点分叉一条新会话 | /branch try-redux |
/rename [name] |
给当前会话起名 | /rename login-refactor |
/export [filename] |
导出对话为文本 | /export chat-2026-05-04.txt |
/copy [N] |
复制最近第 N 条回答 | /copy 2(复制倒数第二条) |
/recap |
一行话总结当前会话 | /recap |
/diff |
交互式看未提交改动 + 每轮 diff | /diff |
/focus |
精简视图,只看最后一轮 | /focus |
/btw <question> |
问一个不写入历史的题外话 | /btw Python 里 dataclass 和 pydantic 的区别? |
/exit |
退出(别名 /quit) |
/exit |
🔵 模型、效果与外观
| 指令 | 作用 | 示例 | |
|---|---|---|---|
/model [model] |
切换模型 | /model sonnet |
|
| `/effort [level | auto]` | 调推理强度 | /effort high 或 /effort auto |
| `/fast [on | off]` | Fast 模式开关 | /fast on |
/theme |
切换主题 | /theme 然后选 dark |
|
| `/color [color | default]` | 设提示符颜色 | /color purple |
/statusline |
配置状态栏 | /statusline 显示分支名和 token 用量 |
|
| `/tui [default | fullscreen]` | 切终端 UI 渲染器 | /tui fullscreen |
/config |
打开设置(别名 /settings) |
/config |
|
/status |
打开设置的 Status 标签 | /status |
🟢 权限、安全与工具
| 指令 | 作用 | 示例 |
|---|---|---|
/permissions |
管理 allow/ask/deny 规则 | /permissions |
/sandbox |
切换沙箱模式 | /sandbox |
/hooks |
查看 Hooks 配置 | /hooks |
/mcp |
管理 MCP 连接 | /mcp |
/agents |
管理 Sub-agents | /agents |
/add-dir <path> |
给会话新加可访问目录 | /add-dir ~/work/shared-libs |
/fewer-permission-prompts |
[Skill] 把常用只读命令加进 allowlist | /fewer-permission-prompts |
/security-review |
扫描当前分支安全风险 | /security-review |
🟠 项目与规划
| 指令 | 作用 | 示例 |
|---|---|---|
/init |
生成 CLAUDE.md |
/init |
/memory |
编辑 CLAUDE.md、开关自动记忆 |
/memory |
/plan [description] |
进入 Plan 模式 | /plan 重构用户鉴权模块 |
/ultraplan <prompt> |
云端起草方案 | /ultraplan 设计订单中心的分页 API |
/batch <instruction> |
[Skill] 拆子任务并行 | /batch 把所有 console.log 替换成 logger.info |
/simplify [focus] |
[Skill] 3 个 Agent 并行 review | /simplify 关注性能和内存泄漏 |
/debug [description] |
[Skill] 打开 debug 日志排查 | /debug 为什么这一步卡住了 |
/loop [interval] [prompt] |
[Skill] 循环跑 prompt | /loop 5m /review |
/schedule [description] |
定时任务(别名 /routines) |
/schedule 每天 9 点跑一遍测试并发总结 |
🔴 Git / PR / Code Review
| 指令 | 作用 | 示例 |
|---|---|---|
/review [PR] |
本地 review PR | /review 1234 |
/ultrareview [PR] |
云端多 Agent 深度 review | /ultrareview 1234 |
/autofix-pr [prompt] |
后台 Agent 监视 PR 自动推修复 | /autofix-pr only fix lint and type errors |
/pr-comments [PR] |
v2.1.91 起已移除,直接让 Claude 看即可 | 请读一下 PR #1234 的评论 |
🟡 集成、分发与远程
| 指令 | 作用 | 示例 |
|---|---|---|
/ide |
管理 IDE 集成 | /ide |
/chrome |
配置 Chrome 中的 Claude | /chrome |
/desktop |
接力到 Desktop App(别名 /app) |
/desktop |
/mobile |
手机 App 下载二维码 | /mobile |
/remote-control |
允许 claude.ai 远程控制(别名 /rc) |
/remote-control |
/remote-env |
配 --remote web 会话默认环境 |
/remote-env |
/teleport |
把 web 会话拉到本地(别名 /tp) |
/teleport |
/install-github-app |
装 GitHub Actions App | /install-github-app |
/install-slack-app |
装 Slack App | /install-slack-app |
/web-setup |
用 gh 凭证连 GitHub |
/web-setup |
⚪ Skills 与插件
| 指令 | 作用 | 示例 | |
|---|---|---|---|
/skills |
列出可用 Skills(按 t 排序) |
/skills |
|
/plugin |
管理插件 | /plugin |
|
/reload-plugins |
热重载插件 | /reload-plugins |
|
| `/claude-api [migrate | managed-agents-onboard]` | [Skill] 载入 API 参考/迁移 | /claude-api migrate |
/team-onboarding |
根据 30 天历史生成上手指南 | /team-onboarding |
🟤 账号、计费、反馈
| 指令 | 作用 | 示例 |
|---|---|---|
/login / /logout |
登录 / 登出 | /login |
/usage |
查看用量与费用(别名 /cost、/stats) |
/usage |
/extra-usage |
配置超额后的 Extra Usage | /extra-usage |
/upgrade |
升级套餐 | /upgrade |
/passes |
分享一周免费体验 | /passes |
/privacy-settings |
隐私设置(Pro/Max) | /privacy-settings |
/feedback [report] |
反馈(别名 /bug) |
/feedback diff 视图有时卡死 |
/stickers |
申请贴纸 | /stickers |
/insights |
生成个人会话分析报告 | /insights |
/release-notes |
浏览 changelog | /release-notes |
/powerup |
交互式小教程 | /powerup |
⚫ 诊断与系统
| 指令 | 作用 | 示例 | ||
|---|---|---|---|---|
/doctor |
诊断安装;按 f 自动修复 |
/doctor |
||
/heapdump |
写 heap 快照排查内存 | /heapdump |
||
/keybindings |
打开快捷键配置 | /keybindings |
||
/terminal-setup |
配 VS Code/Cursor 等的 Shift+Enter | /terminal-setup |
||
| `/voice [hold | tap | off]` | 语音听写开关 | /voice tap |
/tasks |
管理后台任务(别名 /bashes) |
/tasks |
||
/vim |
v2.1.92 起已移除 ,改用 /config |
/config → Editor mode |
||
/setup-bedrock |
配置 Amazon Bedrock | /setup-bedrock |
||
/setup-vertex |
配置 Google Vertex AI | /setup-vertex |
七、最容易混淆的指令对比(带示例)
这些指令名字长得像、作用容易搞混,单独列一张表记住差异。
| 你想做什么 | 用哪个 | 示例 | 为什么不是另一个 |
|---|---|---|---|
| 问一句不想写入历史的话 | /btw |
/btw docker COPY 和 ADD 区别? |
/branch 会真的开新会话 |
| 开一条独立实验线 | /branch |
/branch try-graphql |
/btw 只能单轮 |
| 清空当前对话重新开始 | /clear |
/clear |
/compact 不换会话 |
| 减少 token 但继续当前话题 | /compact |
/compact 保留订单模块 |
/clear 会丢历史 |
| 回到昨天的会话 | /resume |
/resume my-feature |
/continue 是别名,等价 |
| 撤销刚才的代码/对话修改 | /rewind |
/rewind |
/clear 不会还原代码 |
| 换模型省钱 | /model |
/model haiku |
/effort 是调同一模型的推理强度 |
| 把常用只读命令免确认 | /fewer-permission-prompts |
/fewer-permission-prompts |
/permissions 要手动一条条加 |
| 给当前会话起名 | /rename |
/rename login-refactor |
/recap 只是总结不改名 |
| 本地过一遍 PR | /review |
/review 1234 |
/ultrareview 是云端深度版,慢 |
八、进阶:定义你自己的 /指令
Claude Code 现在把"自定义命令"和 Skills 合成一套机制。在项目里创建:
bash
.claude/skills/commit-msg/SKILL.md
文件里写好 name、description 和 prompt 模板,会话里用:
bash
/commit-msg
就能调用。团队成员 clone 仓库即可共享同一套自定义命令。
MCP 服务器暴露的 prompt 会自动注册成 /mcp__<server>__<prompt> 形式,同样直接调用:
bash
/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 分钟流程)三章吃透,立刻就能开干;第六章当目录收藏着随时查;第七章是踩坑急救包。