第 14 课 · 命令护栏
助手每敲一条命令,先过一段检查程序:放行、退回并给出正确写法、直接拦下。
这一课解决什么
把「这条命令能不能执行」的判断,从你手里交给一段程序。
开始前要有: 运维仓库 ~/ops(第 5 课),助手装在开发机上(第 3 课)。这一课做完先不要关权限确认,那是下一课的事。
为什么不靠权限确认
每条命令都问一次「允许吗」,听起来最安全。先试一下。
助手每敲一条命令都停下来问你。照平时的速度点,把这 15 条点完。
助手想执行(1 / 15)
ls -la一天几千条命令,点到后面只剩条件反射。危险的那一条混在里面,一样会被点过去。权限确认消耗的是你的注意力,换来的检查却很弱。
先看懂
护栏是一段程序。助手每敲一条命令,程序先看一眼,结果只有三种。
点一条现成的命令,或者自己输入。这里把名叫 prod 的机器当作生产机。
放行
直接执行
退回
告诉助手正确写法
拦下
做了收不回来
| 结果 | 什么时候 | 之后发生什么 |
|---|---|---|
| 放行 | 没命中任何规则 | 直接执行,不问你 |
| 退回 | 有风险,但有更稳的写法 | 命令不执行,程序把正确写法告诉助手,它自己改 |
| 拦下 | 做了收不回来 | 命令不执行,助手被告知要先问人 |
在模拟器里试这几组,注意它们的区别:
git stash和git commit -m "以后不要用 git stash"。前一条被退回,后一条放行。提交说明里的文字不算命令。ssh prod 'docker compose down'和ssh dev 'docker compose down'。同一条命令,目标是生产机才拦。按命令真正要去的那台机器判断。rm -rf ./build和rm -rf /。删自己的构建目录放行,删系统拦下。
拦哪些,退回哪些
只硬拦做了收不回来的事。 起步仓库里拦六类:
| 拦下 | 为什么收不回来 |
|---|---|
| 删系统目录或整个用户目录 | 文件没了 |
| 抹掉整块磁盘 | 数据没了 |
| 清空数据库 | 只能靠备份 |
| 强制覆盖远端的提交历史 | 别人的提交一起消失 |
| 把密钥文件发到外面 | 发出去就收不回 |
| 让生产机上的服务停下来 | 用户已经打不开了 |
程序怎么看一条命令,有四条约定,看不清的时候按更严的来:
- 一行里用
;、&&、|连起来的几条命令,每条分开检查,取最严的结果。 ssh 机器 '命令'和bash -c '命令',检查的是引号里那条命令。认不出是哪台机器,就当它是生产机。- 只有
echo、grep、git这几个命令后面引号里的文字,当作「只是文字」。其余命令引号里的内容照样检查,比如psql -c '清空数据库的语句'。 - 一次喂给命令的多行输入,逐行检查。
其余有风险的写法是退回,不是拦死。比如 git stash 会把别人没提交的改动一起收走,程序退回它,同时告诉助手改成「先提交自己的文件」。助手照着改,不会来问你。
为什么不多拦一些
拦得太宽,正常的活也干不成。人和助手都会开始想办法绕开护栏,它就废了。
跟着做
看一眼护栏的三个文件
guard/guard.py 检查程序
guard/rules.json 规则,一条规则一段
guard/cases.tsv 历史命令,每条写着期望的结果一条规则长这样:
{
"id": "git-stash",
"verdict": "rewrite",
"pattern": "\\bgit\\s+stash\\b(?!\\s+(list|show))",
"why": "暂存区是所有助手共用的,容易把别人的改动一起收走。",
"instead": "git add <你改的文件> && git commit -m \"说明\",然后 git pull --rebase"
}verdict 是结果:rewrite 退回,block 拦下。pattern 是匹配命令的写法。why 和 instead 是说给助手听的。
把历史命令重放一遍
cd ~/ops
python3 guard/test_guard.py重放 84 条:误拦 0,漏拦 0- 误拦:该放行的被拦了。护栏太宽。
- 漏拦:该拦的放过去了。护栏有洞。
两个数都是 0 才能用。
手动试几条
python3 guard/guard.py --check 'git stash'
python3 guard/guard.py --check "ssh prod 'docker compose down'"
python3 guard/guard.py --check 'git status'退回:[护栏·退回] 暂存区是所有助手共用的,容易把别人的改动一起收走。请改用:……
拦下:[护栏·拦下] 会让生产机上的服务停下来。这类操作要先问人,不要换一种写法重试。
放行接进 Claude Code
在 ~/.claude/settings.json 里加一个 PreToolUse 钩子,匹配 Bash,
命令是 python3 $HOME/ops/guard/guard.py,超时 10 秒。保留文件里已有的内容。{
"hooks": {
"PreToolUse": [
{
"matcher": "Bash",
"hooks": [
{
"type": "command",
"command": "python3 $HOME/ops/guard/guard.py",
"timeout": 10
}
]
}
]
}
}钩子是 Claude Code 留的一个口子:每次执行命令之前,先把命令交给你指定的程序。程序正常结束就执行;程序以退出码 2 结束,命令不执行,程序打印的那句话会交给助手。
退出 Claude Code 再重新打开,配置才生效。
验一次
在一个没用的目录里,对助手说:
把 demo 这个目录的权限改成所有人可读可写可执行助手会先敲 chmod -R 777 demo,被退回,然后自己换成更小的权限,或者回来问你到底要给谁用。你会在它的输出里看到 [护栏·退回] 这一行。
再试一条拦下的:
帮我执行 git push --force origin main命令不会执行,助手会告诉你它被拦下了。
两条都按预期,这一课过关。
加一条自己的规则
以后助手犯了一个你不想再见到的错,就加一条规则。每次固定三步:
- 在
rules.json里加规则。 - 在
cases.tsv里加两行:一行是该被处理的命令,一行是长得像但该放行的命令。 - 跑
python3 guard/test_guard.py,误拦、漏拦都是 0 再提交。
第 2 步最容易省,也最不能省。没有那行「长得像但该放行」的用例,就不知道新规则有没有误伤。
常见卡点
- 接进去之后没反应。 在 Claude Code 里输入
/hooks,看 PreToolUse 下有没有这一条。没有就是settings.json的格式写坏了。 - 改了规则没重放。 一条写宽了的规则会让助手什么都干不成。改一次,重放一次。
- 想把所有带
rm的命令都拦下。 不要。删自己目录里的临时文件是正常的活。只拦删系统目录和整个用户目录。 - 助手被拦下后换一种写法又试。 拦下的提示里已经写了「不要换一种写法重试」。第 16 课会把这条写进规则并配一道考题。
护栏管不了什么
护栏防的是助手的无心之失:它想完成任务,顺手用了一个危险的写法。
它不是保险箱。按文字匹配命令,总有匹配不到的写法。所以后面还有三样东西和它配合:密钥遮蔽(第 15 课)、证据检查(第 17 课)、生产机自己的第二层护栏(第 19 课)。
生产环境里是什么样
- 34 条规则,直接拦下的只有 5 类,其余都是退回。
- 留着约两百条历史命令,每次改规则整套重放,误拦、漏拦都要是 0。重写之前的那一版,在 196 条里误拦过 34 条。
- 经远程登录执行的命令,按目标机器的规矩判。
- 写这套东西的那几周,最重要的一个发现是:同一条教训,写成一句规则和做成一段程序,效果差得很远。写进规则的禁令照样有人犯,做成护栏才真的拦住。
下一课:关掉权限确认。
最后更新于