Claude Code 指令手册

前言

Claude Code 作为目前全球顶尖的 AI 编程助手，其强大的指令系统是提升开发效率的核心。本文整合了 Claude Code 全部 6 类符号指令（/、@、!、#、&、\），按使用频率排序、搭配场景说明，覆盖从基础控制到高级操作的全场景，新手可快速上手，老手可直接用作速查！

核心指令分类总览：

• / 控制指令：控制 AI 行为、切换模式、管理会话（最基础常用）

• @ 引用指令：定位文件、目录、Git 等操作目标（精准指定范围）

• ! 执行指令：执行系统级操作、调用外部工具（主动触发动作）

• # 标签指令：标记、分类上下文，聚焦特定主题（精准管理内容）

• & 组合指令：并发执行、串联多任务（提升操作效率）

• \ 转义指令：控制格式、避免符号误解析（底层格式控制）

一、/ 控制指令（核心常用，控制 AI 行为）

用于控制 Claude Code 的会话状态、模式切换、配置管理等，是日常使用频率最高的指令类型，按真实使用频率排序。

操作符	作用	常见使用场景
/clear	清空当前会话上下文，重置对话	换一个新需求、避免旧上下文干扰、重新开始编码任务
/diff	显示最近修改的代码差异对比	确认 AI 修改是否符合预期、排查误改、准备提交代码前核对
/model	切换使用的 AI 模型（sonnet/opus/haiko）	复杂架构用 Opus，日常开发用 Sonnet，简单查询用 Haiko 省成本
/compact	压缩上下文，清理冗余信息，节省 token	对话过长、上下文溢出、继续长任务但不想新开会话
/context	查看当前上下文长度与剩余空间	判断是否需要压缩上下文、避免因内容过长导致截断
/cost	查看本次会话 token 消耗与预估费用	控制使用成本、核对当月额度、估算大任务开销
/rewind	回滚上一步修改，撤销最近操作	AI 改错代码、误覆盖文件、想回到上一版内容
/init	初始化项目，生成 CLAUDE.md 记忆文件	新项目接入 Claude Code、建立项目规范与记忆
/memory	编辑或查看项目长期记忆（CLAUDE.md）	让 AI 记住项目架构、规范、常量、常用逻辑
/fast	开启极速模式，加快生成速度	简单查询、小修改、快速写注释/单函数，追求响应速度
/btw	插入旁路问题，不中断当前主线任务	边开发边问知识点、查语法、临时咨询不打断当前任务
/usage	查看账户整体额度、使用量与限制	月度额度监控、判断是否快超量、规划使用频率
/review	自动审查代码，检查问题与优化点	代码写完自查、找 Bug、优化逻辑与规范、做 Code Review
/config	打开全局配置，修改 API Key、代理等	首次配置、更换 Key、设置代理、调整模型默认参数
/help	查看所有命令帮助与说明	忘记指令用法、初次使用、快速查阅功能说明
/token	单独统计文本 / 代码的 token 数量	估算长文本消耗、判断是否超上下文、控制请求大小
/plan	让 AI 先规划任务步骤，再执行	大型重构、多文件修改、复杂需求、避免 AI 盲目修改
/auto	进入自动模式，AI 自主完成多步任务	简单批量任务、生成 CRUD、按规划自动执行代码修改
/task	管理当前任务列表，标记完成 / 待办	复杂需求拆解、跟踪开发进度、分步完成功能
/reset	完全重置 Claude Code 所有状态	配置出错、程序异常、上下文彻底混乱、恢复初始状态
/prompt	查看或导出当前完整提示词	调试 AI 行为、查看系统提示、复制用于其他场景
/version	查看当前 Claude Code 版本信息	检查更新、排查版本兼容问题、反馈问题时提供版本号
/exit	退出 Claude Code 程序	结束工作、关闭终端、切换工具
/log	查看会话日志，用于调试	程序报错、连接异常、定位执行失败原因
/status	查看当前连接、模型、上下文状态	检查 API 是否正常、确认当前模式、查看上下文负载
/cache	管理上下文缓存，清理或重建	缓存异常、文件识别错误、提升大项目加载速度
/sync	手动同步文件变更到 AI 上下文	外部编辑器修改后、让 AI 感知最新代码、避免内容不一致
/agent	切换或配置 Agent 模式	使用自动化智能体、开启自主规划执行、复杂工程任务
/api	测试 API 连接与密钥有效性	配置新 Key 后验证、排查 401/连接失败、检查服务状态

二、@ 引用指令（精准定位，指定操作目标）

用于直接引用文件、目录、Git 仓库等操作目标，精准指定 AI 的工作范围，避免误操作，比 / 指令更偏向“定位”，是多文件、复杂项目开发的核心指令。

操作符	作用	常见使用场景
@文件路径	直接引用 / 加载指定文件到上下文	让 AI 分析、修改、解释单个文件；基于文件写文档 / 测试
@目录路径/	引用整个目录（含所有子文件）	分析模块结构、批量修改目录下所有文件、生成目录级文档
@git	关联 Git 仓库，读取变更 / 分支 / 日志	基于 Git diff 做 Code Review、生成提交信息、处理合并冲突
@diff	加载最近代码变更（本次会话）	仅审查 / 优化本次修改、基于 diff 写变更说明
@url	读取网页 / 在线文档内容	参考 API 文档写代码、根据设计文档实现功能
@memory	直接引用项目记忆（CLAUDE.md）	让 AI 严格遵守项目规范、查询已存储的架构信息
@task	关联当前任务清单	基于待办任务开发、标记任务完成依据
@clipboard	读取剪贴板内容	快速导入外部代码 / 文本、临时补充上下文
@image	引用本地图片 / 截图	根据 UI 设计图写页面、分析报错截图定位问题

三、! 执行指令（主动触发，执行系统级操作）

用于执行系统级操作、调用外部工具（如包管理、Git、构建工具），核心是“主动触发动作”，突破常规对话场景，实现代码运行、依赖安装等一站式操作。

操作符	作用	常见使用场景
!run	直接执行当前上下文或指定的代码片段	快速测试 AI 生成的函数/脚本、验证代码逻辑正确性、运行调试代码
!install	安装指定的依赖包（支持 npm/pip 等包管理工具）	AI 生成代码后，快速安装所需依赖、补全项目依赖环境
!test	执行项目中的测试用例（自动识别测试框架）	验证代码修改是否影响原有功能、运行单元测试/集成测试
!commit	快速生成 Git 提交信息并执行提交操作	完成代码修改后，自动生成规范 Commit、快速提交本地变更
!build	触发项目构建命令（自动识别构建脚本）	测试代码编译效果、生成项目构建产物、验证构建配置正确性
!lint	执行代码检查（调用项目 ESLint/Pylint 等工具）	规范代码格式、检查语法错误、统一代码风格
!deploy	触发简易部署命令（需提前配置部署脚本）	快速部署测试环境、推送代码到测试服务器
!debug	启动调试模式，定位代码中的 Bug	代码运行报错时，快速调试定位问题、排查异常逻辑
!logs	查看项目运行日志或终端输出日志	排查程序运行异常、查看接口请求日志、定位报错原因
!alias	查看或设置常用命令的别名	简化高频操作（如设置 !c=!commit）、提升操作效率
!env	查看或修改当前运行环境变量	配置 API 密钥、调整运行参数、切换开发/测试环境
!uninstall	卸载指定的依赖包	清理无用依赖、解决依赖冲突、精简项目环境
!restart	重启 Claude Code 服务或相关运行进程	程序卡死、配置生效后重启、解决运行异常
!clean	清理项目构建产物、缓存文件或临时文件	解决构建缓存冲突、释放磁盘空间、重置项目运行环境
!export	导出当前会话的代码、日志或配置信息	保存 AI 生成的代码、导出会话记录用于归档/分享

四、# 标签指令（分类标记，聚焦上下文）

用于给对话、代码片段、任务打上标签，帮助 AI 聚焦特定主题、过滤无关信息，实现更精准的上下文管理，尤其适合复杂需求、多任务并行场景。

操作符	作用	常见使用场景
#code	强制将内容识别为代码块，高亮并解析语法	粘贴外部代码、让 AI 专注解析代码逻辑、避免文本误识别
#todo	标记待办任务，加入任务列表	记录后续要做的开发点、提醒 AI 后续处理、生成开发清单
#bug	标记内容为 Bug 相关，聚焦问题排查	描述报错信息、定位异常、让 AI 优先分析问题原因
#feature	标记为新功能需求，用于规划开发	提出新功能点、梳理需求细节、生成功能实现方案
#refactor	标记为重构任务，聚焦代码优化	说明重构范围、让 AI 给出优化方案、梳理重构步骤
#question	标记为纯技术问题，不执行代码修改	咨询知识点、询问原理、查询语法与用法
#docs	标记为文档编写需求	生成接口文档、写注释、整理项目说明、生成使用指南
#test	标记为测试相关内容	编写单元测试、分析测试用例、生成测试数据
#config	标记为配置文件相关操作	修改配置项、排查配置错误、生成环境配置
#performance	标记为性能优化需求	分析慢查询、优化接口速度、提升代码执行效率
#security	标记为安全相关问题	排查漏洞、修复安全风险、处理权限与加密逻辑

五、& 组合指令（并发串联，提升操作效率）

用于并发执行多个指令、串联多步操作，将多个独立指令组合为一个操作，避免重复输入，大幅提升开发效率，适合高频、多步骤的常规操作。

操作符	作用	常见使用场景
&sync	自动同步文件 + 刷新上下文	修改外部文件后，自动同步最新内容到 AI
&clear	清空上下文 + 重置会话	快速开启全新任务，不残留历史信息
&diff	查看差异 + 生成修改说明	自动对比代码并生成变更日志/注释
&plan	规划任务 + 自动执行	先出方案，确认后直接执行开发
&review	代码审查 + 自动修复问题	检查代码并一键修复规范/语法错误
&git	关联 Git + 读取变更	自动加载当前分支修改，无需手动输入
&memory	加载记忆 + 应用规则	自动读取项目规范并应用到当前任务
&cache	清理缓存 + 重建上下文	解决文件识别异常，重置 AI 认知
&token	统计消耗 + 压缩上下文	自动计算并优化 Token 占用
&fast	极速模式 + 简化输出	快速响应，适合简单查询/小修改

六、\ 转义指令（格式控制，避免误解析）

属于底层格式控制指令，用于转义特殊符号、控制换行格式，避免 Claude Code 将普通符号误解析为指令，确保输入内容的准确性，尤其适合复杂代码、路径、正则等场景。

操作符	作用	常见使用场景
\ 行尾续行	将多行内容合并为一条指令，避免提前提交	编写长需求、复杂描述、多行配置时分段输入
|转义一个反斜杠，保留原字符	路径、正则、代码中需要显示 \ 时使用
@	转义 @，不解析为文件引用	代码里出现邮箱、注解等，防止被误识别为文件指令
#	转义 #，不解析为标签	代码注释、颜色值、哈希值中保留 # 原样
/	转义 /，不解析为命令	路径、URL、正则中避免 / 触发命令识别
!	转义 !，不执行系统命令	代码逻辑、感叹号表达式中保留 ! 字符
|转义 &，不视为组合指令	HTML、SQL、逻辑表达式中保留 & 符号
" / '	转义引号，不结束字符串	代码字符串内部嵌套引号，保证语法完整
\n / \t	控制换行、缩进格式	精确排版输出、生成格式化代码片段

七、高频指令组合技巧（提升效率必备）

单一指令的作用有限，组合使用能大幅提升开发效率，分享 5 个最常用的组合场景，直接复制可用：

1. 复杂需求开发：/plan & @src/api/user.js 帮我添加分页和搜索接口（先规划、再指定文件、自动执行）

2. 代码修改后核对：&diff & review（查看差异 + 自动审查优化）

3. 新任务开启：&clear @git（清空上下文 + 关联 Git 变更）

4. 长对话优化：&compact & token（压缩上下文 + 统计消耗）

5. 代码测试部署：!run & test & build（运行代码 + 测试 + 构建）

八、总结

Claude Code 的 6 类指令各有侧重，核心逻辑的是：用 @ 定位目标、用 / 控制行为、用 ! 执行操作、用 # 分类管理、用 & 提升效率、用 \ 保证准确。

熟练掌握这些指令，能让 AI 编程助手完全适配你的开发节奏，从简单的代码生成到复杂的项目重构，都能大幅节省时间，把精力聚焦在更有价值的技术思考上。

日常开发遇到指令疑问，直接速查即可，建议搭配 Claude Code 的 /help 指令，快速补充细节~