首页/文章/Claude Code 2.1.307 新事件 safety_event:哪条规则、哪个 hook 拦了 agent,现在能统计了

Claude Code 2.1.307 新事件 safety_event:哪条规则、哪个 hook 拦了 agent,现在能统计了

· Zumac.Ai

新增了什么

@ClaudeCodeLog 整理的 2.1.307 更新日志里有一条和安全直接相关:新增 claude_code.safety_event OpenTelemetry 事件。官方 CHANGELOG 原文是:权限规则、auto mode、安全检查、hook 或沙箱每拦下、提示或退回一次工具调用,就记录一条。@claude_news 的问题很实在:你的 agent 一天被规则和 hook 挡了多少次?以前很难回答,现在可以统计了。

它能帮你看清什么

  1. 规则是不是写得太宽或太窄。 同一类操作天天触发提示,说明 allow/ask 规则该调整;从来没被拦过的 deny 规则,要想想是规则没用上,还是写法没匹配到。
  2. 无人值守时 agent 有没有在「试探」边界。 夜里跑的任务如果突然出现大量被沙箱或 hook 退回的调用,往往意味着任务走偏、或读到了带诱导的内容,值得第二天第一时间看。
  3. 团队层面的对比。 多台机器、多个成员一起用时,哪台机器、哪个仓库触发最多,一目了然。

同一版本还修了一个相关问题:/permissions 里的「Recently denied」之前不显示被拒的 shell 命令,现在会直接写出命令本身。

开启前要知道的几点

按官方 Monitoring 文档:

  • 遥测要用 CLAUDE_CODE_ENABLE_TELEMETRY=1 打开,并配置导出器和收集端地址。事件走 logs/events 通道,需要设置 OTEL_LOGS_EXPORTER。
  • 仓库里的 .claude/settings.json 不能打开遥测或指定发送目的地,只能在组织下发的 managed settings、你自己的 shell 或 ~/.claude/settings.json 里设置。这是为了防止别人的仓库把你的数据导走。
  • 提示词、工具参数、工具输出默认都是脱敏的;OTEL_LOG_TOOL_DETAILS、OTEL_LOG_RAW_API_BODIES 这类开关会把命令、文件内容甚至完整请求体写进日志。收集端越不受控,越不要开这些开关,否则日志本身就成了新的泄密点。
  • 收集端不要暴露在公网,访问要有认证。

小结

拦截本身只是第一步,知道「拦了什么、拦了几次」才能把规则调准。升级到 2.1.307 后,把 safety_event 接到你已有的日志面板里,每周看一次趋势就够了。

如果你想把 Claude Code 放在一台常开、整机独享的新加坡 Mac mini 上长期运行,可以了解 Zumac.Ai,咨询 Telegram @singatao。

来源

Zumac.Ai 新加坡 Mac mini M6,整机独享,¥999/月起,联系 Telegram @singatao。
查看方案与费用 · 帮助中心

返回首页 · 更多文章

Telegram 客服