如果你最近开始认真用Claude Code做开发,大概率已经遇到过这种场景:想让Claude按团队规范审查代码,每次都要在对话框里重复一大段要求;想让它动手改文件之前先跑一遍安全检查,却发现它总是埋头往前冲,拦都拦不住。Commands和Hooks就是为这两个痛点设计的。Commands是自定义斜杠命令,本质是把高频使用的提示词固化成 /xxx 这样的快捷入口,相当于把资深工程师的审查标准、提交规范做成团队可复用的“模板库”;Hooks则是挂在生命周期事件上的自动化脚本,在Claude每次读取文件、编辑文件、回复用户的前后,自动执行你预先写好的命令。这篇我会把两个系统的设计思路讲透,再给完整配置和可直接抄的实操案例,最后聊聊我踩过的坑和排查方法。适合已经装好Claude Code、想进一步提升日常效率的开发者参考。
1. Commands与Hooks到底解决什么问题
1.1 Commands:把高频提示词固化成斜杠命令
用过终端的人都知道alias的好处——把一长串命令缩成一个词,效率提升立竿见影。Claude Code的Commands就是这个思路,只不过它压缩的不是shell命令,而是你反复输入给Claude的提示词。
什么叫高频提示词?我举几个真实场景:
- 每次想让Claude审查代码时,你都要输入“请以资深工程师视角审查当前分支改动的代码,重点检查安全性、可维护性、是否遵守项目规范,发现问题按严重程度列出,并给出可执行建议”。
- 每次要写提交信息时,你都要输入“根据当前git diff生成符合Conventional Commits规范的提交信息,语言用中文,控制在50字以内”。
- 每次让Claude解释一段复杂逻辑时,你都要补一句“不要只罗列代码,要说明设计意图、调用链和潜在风险”。
这些话单独输入一次不觉得累,但一天重复十几次就变得非常烦躁,而且每次说法不一样,Claude的输出质量也不稳定。Commands就是把这些固定表述抽出来,做成 /review、/commit、/explain 这样的斜杠命令。团队里每个人敲同一个命令,拿到同一套标准,输出自然更可控。
更关键的是,Commands不只是“一段固定文字”。它可以接收参数,比如 /review 只检查src目录下的改动;可以限制Claude能用的工具,比如审查命令只允许读文件不允许改文件;还可以指定使用哪个agent子代理来执行。这些能力让命令从“快捷输入”升级成“带约束的工作流入口”。
1.2 Hooks:给工具调用装一层自动化的“门卫”
如果说Commands是主动发起的指令,那Hooks就是被动触发的“条件反射”。你不需要告诉Claude“你改文件之前要先跑lint”,而是配置一个Hook,让Claude每次准备调用Edit或Write工具时,系统自动先执行一遍lint脚本,不过就打断。
这个概念有点像是给Claude Code装了一个门卫——它想进哪个门(调用哪个工具),门卫按规则检查一下你的通行证(执行Hook脚本),通过了才放行。这解决的是AI编程助手的天然短板:不可控。模型再聪明,也可能在改代码时引入格式问题、忘记跑测试、或者不小心动了不该动的文件。Hooks把这些检查变成机制,而不是依赖模型“自觉”。
我用Hooks最多的几个场景:
- 编辑文件前先备份或检查目标文件是否在允许修改的白名单内;
- 改动代码后自动跑lint或单测,失败就中断Claude的下一步操作;
- Claude每次回复前,自动把当前分支的未提交变更追加到上下文里,避免它“失忆”;
- 把Claude每一次工具调用记录下来,用于审计和复盘。
Hooks本质上是事件驱动的外部脚本调用,它不改变Claude本身的能力,而是改变了Claude做事的“环境”和“流程”。这也是很多团队敢把Claude Code放进生产流的核心原因——有了Hooks,你才能对AI的行为设置硬性边界。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. Commands系统配置与实战
2.1 命令文件放哪里
Commands的配置非常简单,本质上就是一堆Markdown文件,文件名就是命令名。注意文件名就是触发词本身。
存放位置有两个级别:
- 项目级:放在项目根目录下
.claude/commands/文件夹里,比如.claude/commands/review.md。这个目录会提交到git仓库,跟着项目走,适合团队共享规范。 - 用户级:放在用户目录下
~/.claude/commands/。放这里的命令对所有项目生效,适合个人高频短语,比如你习惯让Claude用某种风格写代码,放在用户级就不用每个项目都复制一遍。
两个位置会合并生效,同名命令以项目级优先。我实际用下来的经验是:跟业务规范有关的(如提交格式、审查标准)放项目级,跟着仓库走;跟个人习惯有关的(如“说话简洁点”“不要用emacs快捷键”)放用户级。
有些新版本还支持子命令,比如命令文件命名为 review-security.md,就可以用 /review-security 触发;如果命名为 review/create.md,还能实现二级目录形式的子命令。团队命令一多,这个分层能力会很有用。
2.2 一个标准命令文件的完整写法
命令文件是Markdown格式,但头部带有一段YAML frontmatter,用来声明元信息。我写一个完整的例子:
markdown复制---
description: 按团队规范审查本次改动
argument-hint: [可选] 指定审查范围
allowe
