以下是 Claude Code 的常用指令完整参考：

启动新会话

claude

带初始提示直接启动

claude "帮我分析这个项目结构"

非交互模式（适合 CI/CD）

claude -p "检查代码中的 lint 错误并修复"

---

📁 文件引用

用 @ 引用具体文件

> Review @./src/components/Button.tsx

引用整个目录

> Analyze @./src/ and suggest improvements

运行 shell 命令（! 前缀）

> !npm test
> !git status

---

💬 会话管理（Shell 层）

claude                    # 开启新会话
claude --continue         # 恢复上一次会话
claude --resume           # 列出历史会话，选择恢复
/btw                      # 不占用上下文，相当于开小差，额外了解别的信息
/rewind                   # 也就是按两下Esc，你可以把他理解成撤销或者回退，也就是很多设计软件里面的Ctrl+Z
/insights                 # 会生成一份HTML报告，分析你过去一个月使用Claude Code的习惯
/model opusplan           # 会在需要复杂推理时自动以plan模式使用Claude Opus 4.6，然后切换到Claude Sonnet 4.6进行执行
/simplify                 # 可以理解成一个三合一的代码审查工具，本质上其实是个Skills
/branch                   # 其实就是可以把当前对话分叉出一个新会话，原来的会话不受影响
/loop                     # 可以让Claude定时重复执行某个任务
/remote-control           # 在终端里打/rc，或者打完整的/remote-control，它会生成一个URL
/Export                   # 当前的整段对话就会被导出成一个Markdown文件
/init                     # 命令重构/初始化CLAUDE.md 文档
# 按 Esc 键是停止。按 Esc+Esc 可以直接进入/rewind 模式进行回滚。

一些命令的详细介绍：

1. /btw是干嘛的呢，它让你在Claude正在干活的时候插一个问题进去，但这个问题不会被加入对话历史。以前你让Claude Code重构一个大模块，干着干着你突然想到一个问题，比如"诶那个测试文件在哪个目录来着"，你一问，Claude停下来回答你，然后上下文窗口里就多了一段完全不相关的对话，它重新开始干活的时候可能就跑偏了。这就是所谓的上下文污染，用Claude Code时间长的人应该都被坑过。要不然就是呆呆的，等到整个任务跑完，再去问，但是其实也是污染。现在打/btw，然后说一个问题，比如我在执行过程中，突然想知道现在我这个项目的抓取流程是啥，我就可以直接敲/btw。
2. /rewind 特别适合做实验。就是让Claude试一种新方案，不行的话，代码回退，对话留着，这样Claude还记得你刚才聊了什么，知道这条路不通，可以直接换方向，不用重新解释一遍需求。真的，以前经常含泪git reset，我又没那么懂，搞得乱七八糟。现在/rewind就回来了。贼好用，推荐大家一定要用。
3. /insights这个命令是我觉得被严重低估的一个。它会生成一份HTML报告，分析你过去一个月使用Claude Code的习惯，包括你最常用哪些命令，你有哪些重复性的操作模式，然后给你推荐一些自定义命令和Skills。
4. /model opusplan是正儿八经的隐藏命令。你直接/model切换模型，可是没有这个模式的。这对每个月20美刀Pro订阅的用户来说简直是福音。道理很简单，Pro用户的Opus额度是有限的，真的很少，我现在都是Max才够用。你20刀的Pro会员，全程用Opus写代码，可能干到一半就开始被限速了。但规划和写代码对模型能力的要求是完全不一样的。规划需要深度思考，需要理解整个项目的架构和各种依赖关系，这种事情Opus确实比Sonnet强很多。但到了具体写代码的环节，其实一些小的项目，Sonnet真的完全够用了，而且快得多。如果你是那种确实只开20刀Pro会员的轻度用户，或者确实要省一些钱，那我真的建议开/model opusplan这个，真的，两全其美。
5. 你输入/simplify之后，Claude Code会同时启动三个平行的Agent，分别从代码复用、代码质量、运行效率三个角度审查你的改动。然后汇总结果告诉你哪些地方可以优化，以前的/review命令现在几乎感觉已经没用了，我感觉/simplify好用的多。我现在的习惯是，每次跟Claude code对话了很多轮，写了几个大的功能更新之后，都顺手跑一遍/simplify。AI写的代码经常会有一些微妙的冗余，多余的import、重复的逻辑、可以用更简洁写法替代的地方，/simplify基本上都能挑出来。相当于找了三个同事帮你同时review。还是很香的。
6. /branch其实就有点像ChatGPT的这个新聊天中的分支。这个适合你在跟Claude聊到一半，突然想试另一个方向，但又不想丢掉当前对话进度的时候。跟/rewind的区别是，/rewind是回退，/branch是分叉。 你可以理解成，一个是后悔药，一个是平行宇宙。
7. 用法是/loop后面跟时间间隔和你要它做的事情。比如/loop 5m 检查一下部署状态，它会每五分钟帮你跑一次，不用你自己盯着，默认间隔是10分钟。有点类似于OpenClaw的心跳机制，Claude code以前确实不行。/loop的好处是结果直接在对话上下文里，Claude可以基于这些结果做判断和后续操作。然后因为很多任务其实都是短期循环的，所以Claude Code定期任务在创建3天后自动过期。任务会最后触发一次，然后自我删除，这其实就限制了被遗忘的循环能运行的最长时间。如果你希望一直运行下去，Claude给到的方式，是使用桌面版。比如Claude刚帮你梳理完一个方案的思路，你想沿着这个思路试两种不同的实现方式，/branch一下，两个会话各走一边，最后挑效果好的那个。
8. /remote-control，用手机打开这个链接，你的整个Claude Code会话就出现在手机上了。而且是完全同步的，你在手机上发一条指令，终端那边也能看到，你在终端上操作，手机上也会实时更新。两边可以交替使用，对话历史完全一致。代码始终在你的电脑上跑，手机只是一个遥控器，你的文件系统、MCP服务器、项目配置，全部还在本地，手机只是给你提供了一个远程操作的窗口。所以除了方便之外，也非常的安全，很好用。
9. 快捷键
   除了这些命令之外，其实，还有很多好用的快捷键，大家不知道。所以，我也顺便推几个我用的习惯的，非常好用的快捷键。
   Ctrl+V可以直接粘贴截图，不需要先保存成文件再拖进去。Debug的时候遇到报错，直接截屏粘过去，Claude看图说话。
   Mac用户注意，这里是Ctrl+V不是Cmd+V。别再傻傻的每次把截图保存到本地再拖进去了。。。
   Ctrl+J，Mac用户也可以Option+回车，都可以直接实现换行。Ctrl+R，可以搜索你之前输入过的所有prompt历史。
   Ctrl+U，可以删除整行输入。大概就是这几个。
   上面这些功能，有些是三月份刚出的，有些是二月底出的。太快了，在AI加持之下，产品的进化速度，太快了。

---

🔧 Slash 命令（会话内使用）

命令说明
/help                      # 查看所有可用命令
/clear                     # 清除当前对话上下文
/compact                   # 压缩上下文以节省 token
/status                    # 查看当前会话状态
/plan                      # 进入计划模式（只分析不修改文件）
/review                    # 代码审查
/insights                  # 生成过去一个月的使用报告（HTML）
/memory                    # 查看/编辑 CLAUDE.md 记忆文件
/model                     # 切换模型（Haiku / Sonnet / Opus）
/cost                      # 查看本次会话 token 消耗

/exit 或 /quit退出会话

⚙️ 配置命令

查看当前配置

claude config list

设置全局配置

claude config set --global preferredNotifChannel terminal_bell

初始化项目记忆文件

claude /memory   # 或在项目根目录手动创建 CLAUDE.md

---

🧠 系统提示词（CLI flags）

替换系统提示

claude --system-prompt "你是一个专注安全审查的代码专家"

从文件读取系统提示

claude --system-prompt-file ./my-prompt.txt

追加到默认系统提示（推荐）

claude --append-system-prompt "始终用中文回复"
claude --append-system-prompt-file ./extra-rules.txt

---

📋 常用工作流示例

生成单元测试

> Generate unit tests for @./src/utils/validation.js

调试报错

> Debug this error: "TypeError: Cannot read property 'id' of undefined" @./src/user-service.js

重构代码

> Refactor @./src/services/EmailService.js to use dependency injection

生成 API 文档

> Generate API docs for all endpoints in @./src/routes/

Git 提交辅助

> !git diff | Suggest a commit message for these changes

---

🗂️ 项目记忆文件（CLAUDE.md）
在项目根目录创建 CLAUDE.md，Claude 会自动读取：

# Project context
## Coding standards
- 所有新代码使用 TypeScript
- 遵循 ESLint 配置
- 使用 Jest 编写测试

## Architecture
- Frontend: Next.js + TypeScript
- Backend: Node.js + Express
- Database: PostgreSQL + Prisma

支持层级：~/.claude/CLAUDE.md（全局）→ ./CLAUDE.md（项目）→ 子目录

💡 实用技巧

• 在直接进入写代码之前，先用 /plan 让 Claude 以只读模式分析代码库，再决定实现方案，可以显著减少错误。
• 用 @src/auth.ts 精确引用文件，而不是说"找一下 auth 相关文件"，可以节省 token 并提升准确性。
• Haiku 适合做代码探索、简单搜索等子任务；Opus 留给真正复杂的问题，可以大幅控制成本。

linux下使用最高权限并使用自己设置的简称进入claude：

alias swl='claude --dangerously-skip-permissions'

windows下powershell状态下使用最高权限并使用自己设置的简称进入claude：

function swl { claude --dangerously-skip-permissions $args }