Claude Code 指令入门教程

这是一篇写给完全没用过 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 就是给你开个小后门:

  1. 它会复制一份当前上下文到临时空间
  2. 在这个临时空间里回答你这一个问题
  3. 答完把临时空间丢掉

所以主对话的历史不会多一行字,也不会多花 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 的分支:

  1. 把当前对话原样拷贝一份作为新会话
  2. 把你切进新会话里继续折腾
  3. 原会话完整保留,随时能回去

示例:先命名主线,再开分支

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 个防止迷路的小习惯

  1. 分支前先 /rename main 给主线起个名字,免得一堆 "Unnamed session" 分不清
  2. 不确定自己现在在哪条线?用 /recap 看一行总结,或 /status 看会话信息
  3. 分支玩完不想要了,直接 /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.md guide.

大白话 :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 命令(比如 lsgrepgit 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 响应奇怪、工具用不了、登录好像过期了、配置文件好像坏了------先按这个。它会:

  1. 检查安装是不是完整
  2. 检查账号登录状态
  3. 检查插件、权限、配置有没有冲突
  4. 列出所有问题

然后你按 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

文件里写好 namedescription 和 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 分钟流程)三章吃透,立刻就能开干;第六章当目录收藏着随时查;第七章是踩坑急救包。

本文参考:Commands - Claude Code Docs(官方)

相关推荐
yingyima2 小时前
正则表达式实战:从日志中精准提取关键字段
前端
TeamDev2 小时前
如何在 DotNetBrowser 中使用本地 AI 模型
前端·后端·.net
谢尔登2 小时前
10_从 React Hooks 本质看 useState
前端·ubuntu·react.js
辰同学ovo2 小时前
从全局登录状态管理学习 Redux
前端·javascript·学习·react.js
陈随易2 小时前
2年没用Nodejs了,Bun很香
前端·后端·程序员
donecoding3 小时前
Corepack 完全解析:从懵到懂,包管理器自由了
前端·node.js·前端工程化
yqcoder3 小时前
端经典面试题:为什么 0.1 + 0.2 !== 0.3?
前端·css
ZC跨境爬虫3 小时前
跟着 MDN 学 HTML day_12:(HTML网页图片嵌入)
前端·javascript·css·ui·html
光影少年3 小时前
reeact虚拟DOM、Diff算法原理、key的作用与为什么不能用index
前端·react.js·掘金·金石计划