Blast Radius：Claude Code rm -rf 预览，先看危险命令会改动什么

Blast Radius 是一款提供 Claude Code rm -rf 预览的社区插件，作者是 Hamza Zafar（hamzafer），出自他的 claude-code-mods 合集。当 Claude 准备通过 Bash 工具运行一条有风险的 shell 命令时，插件会先把它拦下，展示它会改动什么，然后等你按下 Cancel 或 Proceed。

有三类命令会被拦下。递归的 rm 会得到一份将被删除的文件列表及其总大小，例如 delete 42 files (1.3 MB)。~ 和 $HOME 会被展开；如果路径中含有其他 shell 变量、命令替换或 ~user，则显示 "can't preview"，而不是去猜测。git push --force 会列出将会丢失的远程提交和将被推送的本地提交，以最近一次 fetch 为准。数据库迁移（prisma、supabase、drizzle-kit、knex、sequelize、rails、alembic、typeorm）无法预览，因此插件会列出名称看起来像迁移或 schema 的未提交文件。

报告会在侧边窗格中打开；如果终端太窄放不下窗格，则显示在输入框上方的横条中。默认聚焦在 Cancel 上（快捷键 c）；Proceed 是 y。倒计时显示为 auto-cancels in 42 s，60 秒内没有回应就会取消命令。无论哪种情况，Claude 都会得到一个理由，因此无人值守的会话会继续进行，而不是卡住。同一时间只拦下一条命令；第二条命令会排队等候，轮到它时再获得完整的倒计时。

我们的 危险命令拦截 会直接拒绝一组固定的破坏性模式，相比之下，Blast Radius 是一种"拿事实来问我"的防护：它从不阻止你批准的命令，而且覆盖普通的 rm -r，而不仅仅是灾难性的目标。两者可以一起使用。作者的 README 要求 Claude Code 2.1.287 或更高版本。

录屏中，我们在演示项目里创建一个临时的 dist 文件夹，里面有三个小文件，然后让 Claude 运行 rm -r dist。Blast Radius 在命令执行前将其拦下，显示它会删除的内容（3 个文件、12 KB，逐一列出路径），并附带 Cancel 和 Proceed 按钮以及自动取消倒计时。我们按下了 Cancel，所以什么都没有被删除。

使用安装区块中的任意一种方式；它们都直接从作者自己的插件市场安装。插件一加载，防护就会生效。

插件为 Bash 挂接 tool.call。纯函数 classify 按 &&、||、; 和换行拆分命令，查找三类有风险的命令。如果都不匹配，调用会通过 next(e) 直接放行。以下是 hooks/register.tsx 中针对递归删除的预览：

// Unquoted $t expands globs, and nothing else, without running the command.
const script =
  'shopt -s nullglob; for t in "$@"; do for p in $t; do [ -e "$p" ] || continue; ' +
  'echo "S $(du -sk "$p" | cut -f1)"; find "$p" -type f | head -n 5000 | sed "s/^/F /"; done; done'
const r = await $.process.run(['bash', '-c', script, 'blast-radius', ...targets], init)

目标以参数形式传入，而不是拼接进脚本，列表最多 5000 个文件。测量完成后，插件把被拦下的命令存入一个 $.state 原子，用 $.ui.open 打开 blast-radius 窗格，并每四分之一秒轮询一次，检查是否有按钮被按下、是否到达截止时间或调用是否被中止。Proceed 返回 next(e)，所以命令会完全按原样运行。Cancel 或超时则返回 { deny: ... }，消息中附带预览摘要。在这一切之前，会先检查 $.session.surfaces()：如果没有屏幕，调用会被立即拒绝。

只有一个选项 timeoutSeconds（默认 60，最小 0），用于设置被拦下的命令在取消前等待多久；0 表示一直等待并隐藏倒计时。可以在 /config 中该插件名称下修改，也可以在 settings.json 的 pluginConfigs 中修改。迁移工具列表是 register.tsx 顶部的 MIGRATION 正则表达式，MAX_LISTED（200）限制报告最多显示多少行。

在运行之前，我们读过了插件可以执行的每一个文件：hooks/hooks.json、hooks/register.tsx、类型声明以及测试。没有 package.json、安装脚本或打包后的代码。

之所以会出现拦截工具调用，是因为插件会把关 Bash 调用：它可以拦下并拒绝调用，但从不改写命令。之所以会出现执行命令，是因为调用了 $.process.run。它运行的程序都是只读的：带有上面 du/find 脚本的 bash -c，针对强制推送的两次 git log --oneline，针对迁移的 git status --porcelain，以及轮询循环中的 sleep 0.25。每次预览调用都有 10 秒超时；注意，对非常大的目标运行 du 和 find 可能会一直耗到超时。它会读取 HOME 环境变量来展开 ~。修改界面对应的是窗格和横条。

它不写文件、不使用网络，也不调用模型。claude plugin validate 没有报告任何错误或警告，作者的 17 个测试在 Claude Code 2.1.291 上全部通过。请把它当作多看一眼的保障，而不是沙箱：把 rm 藏在变量或其他程序背后的命令不会被识别出来。

已在 macOS 上使用 Claude Code 2.1.291 检查（validate 和测试）。如果有风险的命令没有被拦下：

• claude --version 为 2.1.287 或更高版本，并且插件在 /plugin 中处于启用状态。
• 该命令属于那三类之一。不带 -r 的普通 rm file.txt 不会被拦下。
• 强制推送的预览以最近一次 fetch 时的上游为基准统计提交；运行 git fetch 可以得到最新列表。
• 在 claude -p 和其他没有屏幕的会话中，被拦下的命令会立即被拒绝，而不是显示出来。