一句话结论:先把 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 侧的解释大致是:
- 为了减少
@author一类幻觉,会话上下文里会放进账号邮箱; - 有些站点(Wikipedia、SEC EDGAR 等)要求脚本客户端在 UA 里留联系方式;
- 模型写
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 里带上我的登录邮箱」。钩子生效时应被拦下。
额外硬化清单(建议一次做完)
- git 用 noreply:
git config --global user.email "<id>+<user>@users.noreply.github.com",并在 GitHub 打开 “Block command line pushes that expose my email”。 - 扫一遍 CLAUDE.md / 记忆文件:别把私人邮箱写进项目说明。
- 问一句模型能不能看到邮箱:
claude -p "What email address do you see for this account?"(只在你自己的机器上测)。若它答得出,说明上下文里仍有邮箱,钩子更必要。 - MCP 出站:matcher 可再加
mcp__.*;或对高风险 MCP 单独拆一层代理。 - 不要关
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)。文中钩子为通用模板,请用你自己的邮箱环境变量验证;未声称扫描任何读者本机日志。
COMMENTS
读者评论