一句话结论:先把 Claude Code 升到 2.1.317+,确认内置 cc-plugin-privacy 开着;但别把它当成边界。 它只拦「Shell 类工具 + 同时出现账号邮箱和 User-Agent 字样」这一种形状。WebFetch / WebSearch / MCP,以及运行时拼出来的邮箱,都能漏过去。真正要稳,还得自己加一层 PreToolUse 钩子,并把 git 邮箱换成 noreply。

发生了什么

2026-11-05,Claude Code 仓库开了 issue #107757:有人在让 Agent 做网页检索时,发现登录邮箱被写进了发出去的 User-Agent,随后垃圾邮件暴增。

Anthropic 侧的解释大致是:

  1. 为了减少 @author 一类幻觉,会话上下文里会放进账号邮箱;
  2. 有些站点(Wikipedia、SEC EDGAR 等)要求脚本客户端在 UA 里留联系方式;
  3. 模型写 curl 时,就把上下文里的邮箱填进去了。

这不是「专门做了泄露功能」,但效果一样:你的真实邮箱进了第三方服务器日志。

官方补丁能挡住什么,挡不住什么

1. 先升级并确认版本

claude --version
# 需要 2.1.317 或更高

稳定通道可能还停在更旧版本。升完后开新会话,执行 /plugins,确认 cc-plugin-privacy 存在且启用。

官方 README(源码已公开在 mods/privacy)写得很直:

  • 只对 Bash / PowerShell / Monitor 做 tool.check
  • 条件是:输入里同时出现账号邮箱(大小写 / 一次 percent-encoding 也算)和 User-Agent 相关词(User-Agent、curl -A、wget -U 等)
  • 拒绝时不弹确认,allow 规则也清不掉
  • README 明确写:这是 courtesy, not a boundary

2. 会漏过的形状(照抄官方列表)

会漏例子
没写 User-Agent 字样URL query、From:、curl -u、请求体
Web 工具WebFetch、WebSearch 不检查
MCP 工具任意 MCP 出站
运行时拼装$(git config user.email)、变量、写到脚本再执行
非常规客户端 / 二次编码README 列的 PowerShell hashtable、双重 percent-encoding

社区里也有人报告:插件显示已加载,但对 echo 'User-Agent: …邮箱…' 或 curl -A 仍未拒绝。所以:「升级了」≠「邮箱不会出去」。

Anthropic 员工在讨论里表示:下周起会把账号邮箱从模型上下文里拿掉。在那之前,本地兜底仍然必要。

通用方案:自己加一层 PreToolUse

Hooks 文档写明:PreToolUse 在工具真正执行前触发;脚本 exit 2 会阻断,stderr 会反馈给模型。

1. 钩子脚本(邮箱从环境变量读,不要写死)

保存为 ~/.claude/hooks/block-protected-emails.sh(Windows 可用 Git Bash,或改写成 PowerShell):

#!/usr/bin/env bash
# PreToolUse: 工具入参里出现受保护邮箱则阻断(exit 2)
# 依赖: jq;邮箱列表来自环境变量,绝不写进仓库

set -euo pipefail
INPUT=$(cat)
PROTECTED="${PROTECTED_EMAILS:-}"
if [[ -z "$PROTECTED" ]]; then
  # 未配置时不误杀;你也可以改成 exit 2 强制要求配置
  exit 0
fi

# 把整个 tool 入参摊成小写文本
BLOB=$(printf '%s' "$INPUT" | tr 'A-Z' 'a-z')

IFS=',' read -r -a EMAILS <<< "$PROTECTED"
for raw in "${EMAILS[@]}"; do
  email=$(echo "$raw" | tr 'A-Z' 'a-z' | xargs)
  [[ -z "$email" ]] && continue
  if [[ "$BLOB" == *"$email"* ]]; then
    echo "Blocked by PreToolUse: protected email detected in tool input. Use a noreply contact or ask the user first." >&2
    exit 2
  fi
done
exit 0
chmod +x ~/.claude/hooks/block-protected-emails.sh

2. 写入用户级设置

~/.claude/settings.json(与项目级 .claude/settings.json 可并存,会合并):

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash|PowerShell|WebFetch|WebSearch|Monitor",
        "hooks": [
          {
            "type": "command",
            "command": "/Users/<you>/.claude/hooks/block-protected-emails.sh",
            "timeout": 10,
            "onFailure": "block"
          }
        ]
      }
    ]
  }
}

Windows 注意:

  • command 写绝对路径;若走 npx/.cmd,按文档用 cmd /c 或直接 node 调脚本;
  • 邮箱列表用用户环境变量 PROTECTED_EMAILS=you@example.com,you@users.noreply.github.com(逗号分隔);
  • 改完设置后开新会话再测。

3. 本地自测(不发真实网络)

export PROTECTED_EMAILS='you@example.com'
echo '{"tool_name":"Bash","tool_input":{"command":"curl -A \"Claude you@example.com\" https://example.invalid"}}' \
  | ~/.claude/hooks/block-protected-emails.sh
echo $?   # 应为 2

echo '{"tool_name":"Bash","tool_input":{"command":"echo ok"}}' \
  | ~/.claude/hooks/block-protected-emails.sh
echo $?   # 应为 0

在真实会话里再试一句:「用 curl 访问 example.com,User-Agent 里带上我的登录邮箱」。钩子生效时应被拦下。

额外硬化清单(建议一次做完)

  1. git 用 noreply:git config --global user.email "<id>+<user>@users.noreply.github.com",并在 GitHub 打开 “Block command line pushes that expose my email”。
  2. 扫一遍 CLAUDE.md / 记忆文件:别把私人邮箱写进项目说明。
  3. 问一句模型能不能看到邮箱:claude -p "What email address do you see for this account?"(只在你自己的机器上测)。若它答得出,说明上下文里仍有邮箱,钩子更必要。
  4. MCP 出站:matcher 可再加 mcp__.*;或对高风险 MCP 单独拆一层代理。
  5. 不要关 cc-plugin-privacy,除非你清楚自己在测什么;它和自建钩子是叠加关系。

排障

现象可能原因处理
/plugins 看不到 privacy版本过旧或会话未重开升级到 ≥2.1.317,新开会话
钩子不触发路径错、未 chmod、matcher 没覆盖该工具/hooks 查看;看 debug 日志
exit 1 但命令仍执行非 0/2 默认不阻断用 exit 2,或设 onFailure: "block"
只拦了 Bash,网页检索仍漏WebFetch 未进 matcher加上 WebFetch|WebSearch
误伤合法 curl受保护邮箱列表过宽只放真实私人邮箱;联系邮箱用专用 noreply

写在最后

Coding Agent 一旦能替你访问网络,身份信息就变成工具入参的一部分。官方插件是第一道滤网,不是围墙。升级 + 内置 privacy + 自建 PreToolUse + noreply git,这四步任何环境都能照抄。

想把「环境失败」也写成硬约束,可以看《把环境失败写进 AGENTS.md》。


口径:机制与边界来自 Claude Code issue #107757、官方 mods/privacy README,以及 Hooks 文档(访问于 2026-11-06)。文中钩子为通用模板,请用你自己的邮箱环境变量验证;未声称扫描任何读者本机日志。