精选Blast Radius
在 Claude Code 运行 rm -r、强制推送或数据库迁移之前先拦下,列出会受影响的文件或提交,等你确认。
- 面板
- 输入框上方
- 执行命令
- 拦截工具调用
- 修改界面
已在 v2.1.291 实测
Claude Code 安全插件会在工具运行前拦截危险的 shell 命令、防止密钥进入对话并保护文件。本文说明它们能拦住什么、会漏掉什么。
精选在 Claude Code 运行 rm -r、强制推送或数据库迁移之前先拦下,列出会受影响的文件或提交,等你确认。
已在 v2.1.291 实测
精选
精选为长时间运行的 Claude Code 任务提供状态带、上下文交接、提示缓存追踪和权限规则。
已在 v2.1.296 实测
精选在 Claude 看到之前,把 API 密钥、邮箱和公网 IP 换成稳定的占位符,并在工具运行时还原。
已在 v2.1.291 实测
Claude Code 安全插件会检查 Claude 即将执行的操作,在风险发生之前拦下其中危险的部分。常见的任务包括拦截 rm -rf / 或强制推送到 main 这类危险的 shell 命令、隐藏密钥使其永远不会发送给模型,以及保护 .env 或锁文件等文件不被修改。
最主要的钩子是 tool.call。它在 Bash、Edit 或 Write 等工具执行之前运行,插件可以用 next(e) 放行这次调用,用 { deny: reason } 拒绝它,或者直接返回 { result } 作答而完全不运行该工具。匹配器可以缩小钩子的范围,例如 on('tool.call', { tool: 'Bash' }, ...)。tool.check 则在 tool.call 和传统的 PreToolUse 钩子运行之后,决定允许、询问还是拒绝。
隐藏密钥的插件通常使用 prompt.submit 来检查或修改你发送的内容,并用 session.append 在每一行被保存之前查看它。由于防护插件处在每次调用的必经之路上,它应当注册一个 .catch 处理函数,这样防护代码自身出错时会拒绝这次调用,而不是导致崩溃或让调用悄悄溜过去。事件参考文档列出了每个事件可以返回的内容。
每个安全插件都会显示 拦截工具调用 标记,这正是它的用途所在。请看看它还显示了什么。命令防护插件除了用于弹出提示的 修改界面 之外,基本不需要别的权限。读取你的提示词 对密钥过滤插件来说在意料之中,对命令防护插件来说则不应出现。安全插件如果带有 网络访问,就值得仔细读一读源码。
再读一读规则列表。好的防护插件会记录每一条匹配模式并说明其用途,还会为误报提供允许列表,以及只报告不拦截的警告模式。
模式匹配防护不是沙箱。命令完全可以被构造得让任何正则表达式都认不出来,而且插件以你的用户权限运行。请把安全插件当作防范日常意外的保护措施;对于任何你自己不会运行的操作,都保持权限确认开启;当你需要一个关闭所有插件的会话时,使用 claude --safe-mode。