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

相关推荐
weixin_382395232 小时前
为小工厂量身打造:本地部署的物料管理系统带缺料计算
前端·制造
__zRainy__2 小时前
解决pnpm v10+不自动构建
前端·pnpm·工程化
猫猫不是喵喵.3 小时前
Vue3 Props 属性
前端·javascript·vue.js
醉城夜风~4 小时前
CSS元素显示模式(display)
前端·css
AI大模型-小华5 小时前
Codex 三方充值快速入门指南
java·前端·数据库·chatgpt·ai编程·codex·chatgpt pro
做前端的娜娜子7 小时前
同一链接实现 PC Web 与移动 H5 自适应
前端·掘金·金石计划
小帅不太帅7 小时前
架构没变、规模没变,DeepSeek V4 Flash 正式版凭什么暴涨 47 分?
前端·aigc·deepseek
jarvisuni8 小时前
DeepSeekFlash前端依旧拉垮,而且变慢了很多!
前端·javascript·算法
卷福同学9 小时前
AI编程出海第二步:验证关键词能否做站
前端·人工智能·后端