← 返回文章列表

> 一篇给 Claude Code 新手的命令速查教程。这也是我自己的学习笔记。

摘要

刚装好 Claude Code,打开终端,闪烁的光标静静等待输入。接下来的几分钟,你大概率会撞上这几个高频困惑:默认跑着 Sonnet,想换 Opus 该怎么操作?对话一长就卡顿,听说有 `/compact` 但拿不准时机;AI 一通猛改把项目改崩了,能不能一键回滚?每个教程都喊你写一份 `CLAUDE.md`,这文件到底是干啥的?

一位年轻人在温馨的小房间里面对一台发光的老式终端机,屏幕光芒照亮他专注的脸庞,桌面上摊开一张手绘的航海图,象征命令速查表是他探索代码世界的地图

一篇给 Claude Code 新手的命令速查教程

刚装好 Claude Code,打开终端,闪烁的光标静静等待输入。接下来的几分钟,你大概率会撞上这几个高频困惑:默认跑着 Sonnet,想换 Opus 该怎么操作?对话一长就卡顿,听说有 /compact 但拿不准时机;AI 一通猛改把项目改崩了,能不能一键回滚?每个教程都喊你写一份 CLAUDE.md,这文件到底是干啥的?想跳过每次手点的确认,让 AI 自己跑测试、跑构建,有没有现成方案?

年轻人初次面对终端的困惑时刻,周围漂浮着象征各种疑问的透明气泡和问号形状的小精灵

这些问题的答案,全部藏在 Claude Code 的命令系统里。60+ 条命令按场景分了 8 个大类,本文先把那张密密麻麻的官方速查图翻译成人话,再挑出最常用的几组示范怎么搭配着用。建议先收藏,后续随时翻查。

命令的基本规矩:只认行首的斜杠

在消息最开头敲 /,会自动弹出所有可用命令,继续打字则自动过滤。例如敲 /comp 就能快速定位 /compact/config

但有个铁律:斜杠命令只在消息首字符时生效。前面已经有别的文字,AI 会把整个内容当成普通文本读。

带参数的写法很自然:

/model opus
/effort high
/btw 这个项目的 Node 版本要求是几?

记好这一条,下面的分类速查就都能直接对照用了。

一、会话与上下文:省 Token、防串戏

Claude 的回答质量,70% 取决于它"看到"的上下文。这一组命令控制它能看到什么、看到多少。

/clear — 清空当前对话

旧任务收尾、准备开新功能时,第一件事敲 /clear。所有旧讨论一笔勾销,AI 不会再被前面的代码思路带偏。别名 /reset/new

注意:/clear 不会动 CLAUDE.md 和已加载的 skills,那些属于项目级记忆。被清掉的只是当前这一通对话。

/compact — 压一压,腾出空间

长对话快撑不住时,比 /clear 更温和的选择。它把前面 N 轮对话提炼成一份精简的"技术摘要",Token 占用大幅回落,关键信息仍然保留。

/compact 重点保留我们对认证模块的设计决策

带一段 focus instruction,让它知道哪部分不能丢。

/context — 看看上下文吃了多少

输入 /context,Claude 会用一张彩色网格告诉你:系统提示占多少、skills 占多少、历史对话占多少、还有多少富余。一旦看到接近 80%,就该 /compact 了。这是防止 AI 突然"失忆"的经验法则。

/resume — 接回历史会话

昨天写到一半的活,今天回来继续。不带参数时开交互式选择器;带 ID 或会话名也行。/background 推到后台的会话也会列在里面,标着 bg。别名 /continue

/branch — 开个平行宇宙

主线对话顺畅,但想试一个激进重构又怕翻车:

/branch 试试用 Zustand 替换 Redux

分支出去后,主线原封不动。实验失败就 /resume 回主线。别名 /fork

/btw — 顺嘴问一句

正在写核心业务,突然想问"这个依赖最新版是几":

/btw axios 最新稳定版本是多少

AI 答完直接回到主线上下文。本质是给主线对话开了个临时通话,不污染主对话记忆。

/rewind — 时光倒流

最关键的"撤销键"。/rewind 回到之前任意一个检查点,特别适合 AI 一连改了 8 个文件、跑起来全崩、你也忘了到底改了啥的时候。别名 /checkpoint/undo

这一类还有: - /rename [新名字] — 给会话改名,方便 /resume 时认 - /export [filename] — 把对话导出成纯文本,归档或复盘 - /recap — 一句话总结当前进度 - /goal <condition> — 设个目标,AI 跨多轮一直推进直到达成 - /focus — 全屏模式下只显示最后一次问答

一位小图书管理员在漂浮着文件夹的奇幻图书馆中,用羽毛笔给每个文件夹贴上名牌和标签

二、代码开发:从规划到验证一条龙

这一组是干活时按得最多的命令。

/plan — 先想后做

跨多个文件的大改动,先 /plan 再说:

/plan 把所有 axios 调用改成 fetch,统一错误处理

AI 会列出受影响的文件、改动顺序、潜在风险,完全不动代码。你点头确认后再退出规划模式执行。实际收益不是省时间,是省返工。

/diff — 看看到底改了啥

/diff 弹出一个交互式 diff 浏览器,左右键切换 git 整体 diff 或 AI 单轮改动,上下键浏览文件。速度比打开 VS Code 看 diff 还快。

/review/code-review/security-review — 三道关

提交前的标准动作: - /review [PR] — 本地代码评审,挑 Bug 和坏味道 - /code-review — 专扫正确性 Bug,可用 effort 级别调强度(如 /code-review high) - /security-review — 安全审计,找注入、硬编码密钥、权限漏洞

老版本里的 /simplify 已合并进 /code-review,旧名字仍兼容。

/run/verify — 让 AI 真跑起来验证

AI 写完代码说"应该好了",让 /run 真启动一下。它会读 package.jsonMakefile 之类的配置,把 App 跑起来,自己驱动它看一眼是否真生效。

/verify 更进一步:构建、运行、观察结果,不靠测试和类型检查兜底,直接看 App 真实表现。

如果项目启动姿势复杂(要数据库、要 env、要前端编译),先跑一次 /run-skill-generator,它把启动配方记成项目级 skill 存到 .claude/skills/run-<name>/,以后 /run/verify 都按这个配方来。每个项目跑一次就行。

/add-dir — 临时加目录

工作中突然要参考另一个仓库:

/add-dir ~/code/another-project

当前会话就能读那个目录的文件。/clear 不会清这个加进来的目录,要清得用 /permissions 里的工作目录管理。

/copy — 复制上一条回答

最后一条 AI 回复有代码块?敲 /copy 弹选择器,可挑单个代码块或全部内容到剪贴板。要复制倒数第二条用 /copy 2;选择器里按 w 还能直接写到文件里,SSH 远程开发时特别好用。

三、智能体与并发:让 AI 自己组队干

这一类是 Claude Code 的"高阶玩法",初学者可以先扫一眼,知道有这些功能就行。

/batch — 大任务拆并行小队

/batch 把 src/ 下所有 React class 组件迁移成函数组件

先研究代码库,给一份执行计划。你点确认后,每个小任务在独立的 git worktree 里并行跑,跑完各开一个 PR。要求项目是 git 仓库。一个早上跑完一个跨 30 个文件的迁移,并不是夸张。

/agents — 管子智能体

子智能体(subagent)是 Claude Code 的多角色系统:可以预定义"测试专家""安全专家""重构专家"等专项 agent,主线对话遇到对应任务时,主 Claude 把活派给它们。/agents 打开管理面板,新建、改 agent 的工具权限。

/tasks — 看后台跑啥呢

后台任务列表。/batch 派出去的子任务、/background 推到后台的会话、/loop 在循环跑的活,全在这里。/bashes 是别名。

/background — 把整个会话踢到后台

/background 继续跑测试,跑完发我通知

腾出来给你干别的。后面用 claude agents 命令在终端外查状态,或用 /resume 拉回前台。别名 /bg

/loop — 定时循环

/loop 5m 检查部署状态,部署完了告诉我

每 5 分钟跑一次。不指定 interval,Claude 会自己控节奏。也可把循环里要做的事写在 .claude/loop.md,命令什么都不带就执行那份。别名 /proactive

/schedule — 云端例行任务

/schedule 让 Claude 一步步配置一个云端例行任务:每周一早上 9 点扫一次依赖更新、每天午夜跑一次安全审计……跑在 Anthropic 云上,不占本地资源。别名 /routines

一个机械师站在山顶仰望天空中的齿轮云朵,云中藏着按照时间表自动运转的钟表机械装置

这一类还有: - /autofix-pr [prompt] — 监听当前分支 PR,CI 挂了或评审有意见就自动修,需要 gh CLI - /teleport — 把 claude.ai 网页版会话拉进当前终端继续聊。别名 /tp - /remote-control — 反过来,把当前本地会话开放给 claude.ai 远程接管。别名 /rc - /ultraplan <prompt> — 在云端 sandbox 起一个深度规划任务,浏览器审阅后再打回终端执行 - /ultrareview [PR] — 多 agent 深度评审,包含 3 次免费配额(Pro/Max) - /stop — 附在后台会话时停掉它(要保留 transcript 用 /exit 脱离即可)

四、模型与算力:在速度与深度之间挑一个

/model — 切模型

/model opus
/model sonnet
/model haiku

不带参数会开选择器。普通搬砖、改 Bug、写测试用 Sonnet 就够;遇到逻辑绕的算法、跨多文件的架构题,切 Opus。在选择器里某行按 d,可把这个模型设成新会话默认。

/effort — 思考强度

/effort high

可选 low / medium / high / xhigh / max,越往上 AI 越深度思考,但响应更慢、Token 更贵。auto 会重置为模型默认。

不带参数会弹出交互式滑块,左右键调,回车确认。改完立刻生效,不用等当前回答跑完。

/fast — 极速流

/fast on

牺牲一些复杂推理换响应速度。聊设计、聊架构不要开;写脚手架、改 boilerplate 时开着挺爽。

/config — 设置面板

主题、默认模型、输出风格、编辑器模式(包括 Vim 模式)都在这里。/settings 是别名。

注意:老版本里有个独立的 /vim 命令,新版本已合并到 /config → Editor mode,找不到不要慌。

/output-style — 输出风格

让 AI 回答得更简短直接,或者更详尽冗长,按场景选。

五、项目记忆:让 AI 记住你的规范

这一类是 Claude Code 的灵魂,也是新手最容易忽略的部分。

/init — 给项目一份记忆

第一次进项目,先跑:

/init

生成一份 CLAUDE.md,每次启动 Claude Code 都会自动加载。里面通常写: - 项目用什么语言、什么框架 - 怎么编译、怎么测试、怎么 lint - 有没有特殊约束(不要引入新依赖 / 不要动某些目录) - 团队规范(命名风格、commit 信息格式、分支策略)

写得越具体,AI 越听话。

/memory — 编辑记忆文件

/memory 直接打开 CLAUDE.md 编辑。也能在这里管理"自动记忆"——Claude 会从对话里抽取它认为有价值的事实自动追加进来,你能看着、删着、改着。

实操技巧:每次发现 AI 又踩了同一个坑,立刻 /memory 把这条规则加进去。下次它就记住了。

/skills — 看技能、管技能

/skills 列出当前会话能用的所有 skill:用户级、项目级、插件带的。按 t 按 token 占用排序,按空格隐藏不想让 AI 看到的,按回车保存。

这一类还有: - /insights — 分析开发会话,找出高频摩擦点和架构演进规律,复盘神器 - /team-onboarding — 从近 30 天的使用历史,生成一份团队新人入职指南 - /fewer-permission-prompts — 扫历史,自动给常用的只读 Bash 命令和 MCP 工具加白名单,少弹窗 - /claude-api — 载入 Claude API SDK 参考文档,还能 /claude-api migrate 自动升级旧代码到新模型 - /powerup — 交互式小课程 + 动画演示,挖一些你不知道的功能

六、诊断与计费:看花了多少、坏了去哪修

/usage/cost/stats — 看账单

订阅用户看:每日额度用了多少、剩多少、连续打卡多少天。按量付费用户看:当前会话花了多少美元。/cost/stats 都是 /usage 的别名,/stats 默认打开 Stats tab。

/usage-credits — 触顶后续命

订阅额度炸了想继续工作?/usage-credits 配置一下,超额后自动按量付费继续。这条命令以前叫 /extra-usage,新版本改名了。

一位旅人在古老客栈柜台前和老板娘结账,柜台上一个自动运转的铜制计数器持续记录消耗

/doctor — 环境一键体检

装完发现不工作?升级后行为变怪?/doctor 逐项检查 CLI 安装、二进制依赖、Node 运行时、网络连通、配置文件是否正常。每项前面有状态图标,按 f 让 AI 自动尝试修复有问题的项。

/status — 看当前状态

/status 打开设置面板的 Status tab:版本号、当前模型、登录账号、网络连接质量。AI 在回答中也能直接打开看,不用等当前回答跑完。

这一类还有: - /debug [description] — 开启调试日志,定位问题。写明描述能让分析更聚焦 - /heapdump — 写一份 JS 堆快照到桌面,排查内存爆炸 - /release-notes — 交互式查看更新日志,挑版本看 - /help — 最简交互速查表

七、权限与扩展:管 AI 能动什么

/permissions — 自动放行

最值钱的一条命令之一。/permissions 打开权限管理面板,可配置: - 把 git statusnpm testls * 这类只读 / 安全命令设成自动放行 - 把 rm -rf 这类危险命令设成永远拒绝 - 给具体的 MCP 工具或 skill 单独配权限

第一周配一次,整个使用体验直接起飞。别名 /allowed-tools

懒得手动配?跑 /fewer-permission-prompts,它从历史里找你常用的只读命令,自动列一份白名单写到 .claude/settings.json

/sandbox — 沙盒隔离

/sandbox 开/关沙盒模式。开启后 AI 的代码执行被严格限制,碰不到宿主机文件系统外的东西。给陌生项目跑实验代码时建议开。

/mcp — 管 MCP 服务器

MCP(模型上下文协议)用来挂外部数据库、本地知识库、第三方工具到 Claude。/mcp 管所有 MCP 服务器的连接、OAuth 鉴权、状态检查。

/hooks — 看生命周期钩子

/hooks 查看当前配的工具事件 hooks。Hooks 能在文件保存、prompt 提交、工具调用前后等节点插入自动化逻辑(跑 lint、跑测试、发通知)。

/plugin — 管插件

/plugin 管理插件的安装、启用、禁用。Claude Code 的插件机制能打包 skills、MCP 服务器、hooks 一起分发。配套的还有 /reload-plugins,不用重启就重载所有插件。

八、账号、界面、个性化:一次配完管很久

这些大都装好的第一周配一次,之后基本不动:

  • /login / /logout — 登录登出 Anthropic 账号
  • /theme — 配色主题,包含 dark / light / 色盲友好(daltonized)/ ANSI 等
  • /color [color|default] — 单独改提示符底条颜色,支持 red / blue / green / yellow / purple / orange / pink / cyan
  • /terminal-setup — 一键配好 Shift+Enter 这类键位,VS Code、Cursor、Windsurf、Alacritty、Zed 用户必跑
  • /keybindings — 直接编辑键位配置文件
  • /statusline — 配状态栏,描述想要的效果,AI 帮你生成
  • /scroll-speed — 调鼠标滚轮速度,全屏模式专用
  • /chrome — 在 Chrome 浏览器中使用 Claude 插件
  • /ide — 管 IDE 集成的状态
  • /feedback [report] — 提 Bug 或反馈,自动附会话上下文(脱敏)。别名 /bug/share
  • /exit — 退出。附在后台会话时只脱离不停止。别名 /quit/bye

不进交互模式:CLI 常用 flag

不进交互模式、从普通终端直接发命令也很高频:

# 接着上次最后一个会话继续
claude -c
claude --continue

# 单次任务,跑完就退
claude -p "扫一遍 src/ 里有没有重复的工具函数"

# 给文件喂进去让 AI 处理
cat logs.txt | claude -p "找出最严重的 5 条错误"

# 升级到最新版
claude update

几条最值钱的高频组合

知道单条命令是一回事,会搭配又是另一回事。下面这几组是天天在用的实战配方:

进新项目 = /init + /memory + /permissions

新项目第一天,三条命令配完,整周顺畅。/init 让 AI 知道项目长啥样,/memory 写清楚团队规范,/permissions 把常用命令免签。

大重构 = /plan + /effort high + /model opus

跨多文件的活,先用强算力规划,确认方案再切回 Sonnet 写代码。算力花在刀刃上。

长对话 = /context + /compact + /rewind

看占用、压一压、出错回滚。三连让你不必整天提心吊胆"AI 是不是又忘了上下文"。

提交前 = /code-review + /security-review + /diff

正确性、安全、改动范围三道关,比手动 review 快多了。

一改全崩 = /rewind

不要一行行去撤。一键回到刚才那个还能跑的检查点,重新开。

写在最后

Claude Code 的命令多,不用一次记住。先把下面这 10 条记熟,覆盖 80% 的日常场景:

一位年轻旅人手持发光的提灯站在山脚,眼前是十条清晰标记的发光石阶通向山顶的城堡

/init        进新项目第一条
/memory      改项目记忆
/clear       开新任务前清场
/compact     上下文快爆了压一压
/plan        大改动先规划
/diff        看 AI 改了啥
/review      提交前检查
/rewind      改崩了一键还原
/model       切模型
/permissions 配自动放行

剩下的等用到了再回来翻速查图。命令不是越多越好,是用熟几个关键的才好。

祝你少弹窗、不返工、改不崩。