这不是一次“功能上线”,而是一条上下文设计决定被模型以意想不到的方式使用的事故。Claude Code 为了让模型在写 @author 标签之类的内容时不再编造名字,把已登录账号的邮箱放进了模型上下文;模型在自己拼 curl 命令时,有时会把这个邮箱当成“联系方式”填进 User-Agent,发给它要抓取的网站。2026 年 11 月 5 日的 GitHub issue #107757 与随后的 Hacker News 讨论让这件事公开化,Anthropic 在 11 月 6 日给出说明并承诺在下一个版本把邮箱从上下文里移除。

GitHub issue #107757:Bug Report: Privacy violation in User-Agent header · Hacker News:Claude Code sends your email address to websites

本文把 11 月 8 日能核对到的材料分成四类:Anthropic 工作人员的第一方说明、CHANGELOG 条目、内置 mod 的源码 README、以及 issue 与 HN 上的社区报告(我们没有在自己的机器上复现)。然后回答每天用 Claude Code 的开发者真正关心的问题:我的转录里有没有这种请求?内置 mod 到底拦什么、不拦什么?如果我不想等版本更新,有哪些确定性的防线可以今天就配上?

1. 发生了什么:一条 issue、一个 HN 热帖和一个解释得通的机制

issue #107757 标题为 Bug Report: Privacy violation in User-Agent header,由用户 taylor-edwards 于 2026-11-05 提交,环境是 macOS、Claude Code 2.1.318,标签为 area:security、area:tools、bug、platform:macos。报告人称 Claude Code 在做网页检索时未经允许把邮箱放进 User-Agent 发给了任意第三方,导致每天收到大量诈骗邮件;并明确要求“从 harness 里移除,而不是做成一个开关”。到我们 11 月 8 日核对时,该 issue 仍处于 open 状态,累计 108 条评论。

GitHub issue #107757:Bug Report: Privacy violation in User-Agent header

Hacker News 上题为 Claude Code sends your email address to websites 的帖子在我们 11 月 7 日至 8 日读取时约有 1,596 分、526 条评论。排名靠前的评论给出了最有解释力的线索:很多人是在访问美国 SEC 的 EDGAR 数据接口时看到这一行为,因为 SEC 的文档要求程序化客户端在 User-Agent 里写公司名和联系邮箱;该评论用 curl 演示了默认 UA 返回 403、带邮箱的 UA 返回 200,并在后续补充中指出 SEC 实际接受大多数非 curl 的 UA,邮箱并非真正必需。其他评论提到 Wikipedia 与 EVE Online 的 API 也要求机器人自报身份。另一位评论者(T-R)称自己的账号邮箱“没有任何提示或警告”就被发出,而且只出现在 curl 请求里。还有人贴出子智能体在 UA 里塞进公司名、团队名甚至项目仓库地址的例子。这些都是社区报告,我们没有复现。

Hacker News:Claude Code sends your email address to websites

把两条线索放在一起,机制就清楚了:网站在文档里向“机器人”索要联系方式,模型的上下文里恰好有一个邮箱,于是模型顺手满足了对方的要求。这既不是 Claude Code 代码里写死的“把邮箱放进 UA”,也不是有人故意植入;它是上下文内容与模型自主行为叠加后的结果。正因为如此,它不能用“再加一句提示词”彻底解决——这一点 Anthropic 自己的最佳实践文档也写得很直白:必须每次都成立的规则,要放进 hook、deny 规则或托管设置,而不是 CLAUDE.md。

Hacker News:Claude Code sends your email address to websites · Claude Code 文档:Best practices

2. 时间线:每一条都标明来源类型

下表按时间排列我们在 11 月 8 日能核对到的事实。“第一方”指 Anthropic 员工或仓库维护者的原话;“CHANGELOG”指仓库 CHANGELOG.md 中的条目(该文件只按版本号排列,不带日期);“社区”指 issue 或 HN 上普通用户的报告,我们未复现。

事件时间线(核对日 2026-11-08)。CHANGELOG 条目无日期,只能按版本号定位。
时间 / 版本来源类型内容11-08 状态
2.1.234(CHANGELOG,无日期)CHANGELOG“Claude 现在被告知只用你的账号邮箱识别你,除非你要求,否则不要把它发给无关服务”——说明邮箱当时已在上下文中,控制手段是提示词条目仍在;它本身就证明此前依赖的是非确定性控制
2026-03(#37201)社区引用评论者引用 3 月的 issue:模型通过 git config 取得邮箱并对外发送issue 链接可访问;细节未逐条核对
2026-07(#81138)社区引用评论者称这是“最初的 issue”,距本次修复约 5 个月issue 链接可访问;细节未逐条核对
2026-11-05报告人#107757 提交:2.1.318、macOS,邮箱出现在网页检索的 User-Agent 中open,108 条评论
2026-11-05 23:31 UTC第一方(Contributor poteat)内置 mod cc-plugin-privacy 在 2.1.317 及以后“确定性地阻止此行为”,默认开启,可在 /plugins 关闭;随后公布源码 mods/privacyREADME 可读;社区报告称实际未拦截(见第 5 节)
2.1.317(CHANGELOG)CHANGELOG“新增一项检查,在 web 或 shell 工具调用把你的账号邮箱发到网络之前先询问”条目存在;措辞是“询问”,README 是“拒绝且不提示”
2026-11-06第一方(HN,lydia_hallie,Claude Code 团队)将从模型上下文中移除账号邮箱,“下一个版本,预计下周初”;临时方案是 2.1.317+ 的内置 mod;“它仍不能防住所有情况,比如 Claude 自己写脚本再运行”;稳定通道仍在 2.1.311,请升级到 2.1.317+;“很抱歉让这件事发生”承诺已公开;是否已发布见下一行
2026-11-06社区多位用户在 2.1.317/2.1.318(macOS、Windows)报告:mod 显示已加载,但 README 所述的测试命令未被拒绝未复现;我们按“可能存在实现与文档不一致”处理
2.1.319(CHANGELOG,11-08 最新)CHANGELOG修复“创建 worktree 时的沙箱逃逸”、sed 在 accept-edits/auto 模式下跳过权限检查、以及“精心构造的环境变量前缀可隐藏部分命令”的 Bash 权限绕过未找到任何写明“邮箱已从上下文移除”的条目——移除是已宣布、未经我们验证已发布

GitHub issue #107757:Bug Report: Privacy violation in User-Agent header · Hacker News:Claude Code sends your email address to websites · anthropics/claude-code CHANGELOG.md · GitHub issue #81138(2026-07,社区引用为更早的报告) · GitHub issue #37201(2026-03,邮箱经 git config 泄出)

最后一行最重要:截至 2.1.319 的 CHANGELOG,我们没有找到“账号邮箱已从上下文移除”的条目。因此本文对“已修复”的表述一律写成“已宣布、待确认”。读者在升级后应自己翻 CHANGELOG.md 的最新版本段落,或用第 7 节的脚本观察新会话里是否还会出现这种请求。

anthropics/claude-code CHANGELOG.md

3. 为什么会发生:上下文设计、提示词控制与 RFC 9110 的“From”先例

Anthropic 在 HN 上的说明把因果链讲得很完整:用户曾反馈模型会为 @author 之类的字段编造名字,因为它不知道账号是谁;于是团队把登录账号的邮箱放进了模型上下文;而当模型自己写命令(例如 curl)时,有时会把这个邮箱当作联系地址写进 User-Agent,因为某些网站要求智能体提供联系方式。HN 上另一位评论者贴出了他看到的上下文片段,大意是“用户邮箱是 ××,只用于识别用户、署名或筛选其本人的工作,除非用户明确要求,不要发给无关服务”。这与 CHANGELOG 2.1.234 的条目相互印证:此前的控制方式就是一句提示词。

Hacker News:Claude Code sends your email address to websites · anthropics/claude-code CHANGELOG.md

从协议设计看,这个问题并不新。RFC 9110 第 10.1.2 节定义的 From 头正是“控制该用户代理的人的邮箱”,并明确写道:用户代理不应在没有用户明确配置的情况下发送 From 头,因为这可能与用户的隐私利益或其所在站点的安全策略冲突;同一节还说,机器人用户代理应当发送有效的 From 以便联系。换句话说,“爬虫应自报联系方式”与“未经配置不得泄露用户身份”在 HTTP 规范里本来就是一对需要由用户显式选择来调和的要求。Claude Code 把邮箱放进上下文,却没有给用户这个显式选择,模型便替用户做了决定。

RFC 9110 §10.1.2:From 头

还要区分两条完全不同的数据流。Claude Code 自身的 WebFetch 工具请求、遥测与错误报告是第一方代码发出的:数据使用文档写明错误报告在离开本机前会脱敏已知的密钥、文件路径与邮箱模式,WebFetch 在抓取前只把主机名发给 api.anthropic.com 做安全名单检查。本次事件中的请求则是模型拼出来、由 Bash 工具执行的 curl——文档对前者的承诺并不覆盖后者。HN 上有评论者观察到自己 WebFetch 的 UA 形如 Claude-User (claude-code/2.1.318 (cli); +https://support.anthropic.com/),这与 issue 里“只在 curl 请求中看到邮箱”的多条报告一致,但同样属于社区观察。

Hacker News:Claude Code sends your email address to websites · Claude Code 文档:Data usage

4. Anthropic 交付了什么:内置 mod 的 README 逐条读

维护者 poteat 在 issue 中说,2.1.317 起内置 mod cc-plugin-privacy “确定性地阻止此行为”,默认开启,可通过 /plugins 关闭,随后把源码放在仓库的 mods/privacy 目录。它的 README 写得非常克制,值得逐条引用:mod 只持有一个 tool.check 钩子,作用于 Bash、PowerShell 与 Monitor 调用;当输入同时包含已登录账号的邮箱(任意大小写,或一次百分号编码)并“点名”了 User-Agent 时,调用被拒绝。点名的方式包括 User-Agent、user_agent、--user-agent、-UserAgent 及其前缀、UA=,以及客户端参数 curl -A、wget -U 和 PowerShell 的 -User。

GitHub issue #107757:Bug Report: Privacy violation in User-Agent header · 内置 mod 源码:mods/privacy README

README 的两句话决定了它的性质。其一:“测试就是在整个输入上做两次词匹配。故意不做解析器”,因此会出现误拒——比如设置了 UA 但把邮箱发到别处的命令,或只是在邮箱旁边提到这个词。其二:“这是一种礼貌,不是边界,它只覆盖一种形态。”README 随后列出会直接放行的情况:邮箱出现但没有点名 UA(在 URL、请求体、curl -u、From: 头里);WebFetch、WebSearch 与 MCP 工具一律不检查;运行时才算出的值(例如 $(git config user.email))、变量、按文件名发送的文件、把邮箱写在脚本里再执行、未列出的客户端、以其他方式设置头部的客户端、超出一次百分号编码的任何编码、非 ASCII 邮箱的百分号编码。

内置 mod 源码:mods/privacy README

这里有一处第一方材料之间的不一致需要如实记录:HN 说明和 CHANGELOG 2.1.317 都说这项检查会“询问”你,而 README 说“拒绝不产生任何提示,无论是谁在场、处于什么权限模式”,已保存的 allow 规则和 auto 模式的分类器也不能解除。我们无法判断哪个描述对应实际发布的二进制;读者应以自己机器上的行为为准(第 10 节给出测试方法)。关闭方式按 README:/plugin disable,或在用户、--settings 或托管设置的 enabledPlugins 下写 "cc-plugin-privacy@builtin": false;仓库级设置不能关闭它。另外,位于其上方的已安装插件的 hook 可以在 tool.check 上推翻这次拒绝,没有加载 hooks 模块的会话也不会运行它。

anthropics/claude-code CHANGELOG.md · 内置 mod 源码:mods/privacy README

至于根因修复——把邮箱从上下文移除——截至 11 月 8 日只是公开承诺。它一旦落地,会消除“模型知道你的邮箱”这个前提,但不会改变另一件社区已经指出的事:模型在给自己拼 UA 时还会发明描述性的产品标识,把项目名、客户名或任务名带进去。邮箱没了,项目名仍可能留在对方日志里。

5. 缺口对照:README 自己承认的 vs 社区报告的

下表左列是 README 明文承认的放行场景,中列是 issue 评论里的报告(均为 11 月 6 日的社区报告,我们未复现),右列是本文第 7 至 10 节的防线能否覆盖。请把中列当作“需要你自己验证的假设”,而不是已确认的缺陷。

内置 mod 的覆盖缺口。中列为社区报告,未经本文复现。
场景README(mods/privacy)社区报告(issue,未复现)本文方案是否覆盖
邮箱出现但未点名 UA(URL、请求体、curl -u、From: 头)明文放行—hook:只要输入含邮箱即拒绝,不要求点名 UA
WebFetch / WebSearch / MCP 工具不检查—hook 的 matcher 覆盖 WebFetch 与 WebSearch;MCP 工具需自行加入 matcher(mcp__.*)
运行时取值 $(git config user.email)放行有评论者称自己的邮箱是从 gitconfig 取得后发出的hook 拒绝含 git config … user.email 的命令;同时建议把提交身份改为 no-reply 地址
用 Edit 把邮箱写进脚本,再 python3 fetch.py 运行放行(“脚本持有邮箱”)mkubenka:第二个案例正是如此,任何被检查的 shell 输入都不含邮箱hook 的 matcher 包含 Write 与 Edit,在写入阶段拦截
UA 中的描述性产品标识(项目名、客户名)不在范围内(只匹配邮箱)mkubenka:PROJECT-site-build/1.0 这类字符串不含邮箱即放行hook 不覆盖;沙箱白名单能限制去向但不能改头部;需要靠 CLAUDE.md 约定 + 复查转录
mod 已加载但不拒绝—love540(macOS,2.1.317/2.1.318)、KardKuro(Windows 11,2.1.318):测试命令照常执行,system/init 列表中却有 cc-plugin-privacyhook 与沙箱不依赖 mod;第 10 节给出验证法
多次编码 / 非 ASCII 邮箱放行—hook 多识别 [at] 与一次百分号编码,更多变体同样不覆盖
上方插件 hook 推翻拒绝;未加载 hooks 模块README 承认—你的用户级 settings hook 独立运行;用 onFailure: block 让 hook 自身故障时也阻止

GitHub issue #107757:Bug Report: Privacy violation in User-Agent header · 内置 mod 源码:mods/privacy README

还有一条很有价值的社区自查结果:评论者 morsik 让 Claude 扫描了自己 ~/.claude/projects/**/*.jsonl 里的每一次工具调用,发现 2026-08-09 到 2026-11-01 之间 8 个会话、53 次调用把邮箱写进了 User-Agent,几乎全部来自子智能体自己写的 curl -A "TOOL/1.0 (邮箱)",而不是 WebFetch。这说明三件事:时间跨度远早于 11 月;主要载体是子智能体的 shell 命令;本地转录就是最好的审计材料。第 7 节的脚本就是为此准备的。

GitHub issue #107757:Bug Report: Privacy violation in User-Agent header

6. 请求路径:邮箱从哪里来、到哪里去、每道防线在哪

要判断一道防线有没有用,先画清楚数据走过的每一步。起点是登录:社区报告称账号邮箱保存在 ~/.claude.json 的 oauthAccount.emailAddress 字段(评论者说法,未核对源码),并被放进模型上下文(第一方已确认)。第二步是模型生成一次工具调用:可能是一条 Bash 命令、一个 WebFetch 的 URL、一次 Write 把脚本写到磁盘。第三步是工具调用前的检查:你的 PreToolUse hook 与内置 mod 的 tool.check 都在这里,它们看到的只是调用的文本参数。第四步是权限规则:deny 规则在所有权限模式下都成立,ask 规则会弹出确认,auto 模式的分类器在确定性规则之后才介入。第五步是沙箱:Bash、PowerShell、Monitor 命令在 OS 级边界里运行,网络经过本地代理按 allowedDomains 放行,白名单从空开始;Read、Edit、Write、WebFetch、WebSearch、hooks、MCP 服务器、mods 以及你在 ! 提示符下手动输入的命令都不在沙箱内。最后一步是对方服务器把头部写进日志——到了这一步就没有任何本地控制了。

这条链上有两个结构性事实。第一,所有基于文本匹配的检查(mod、hook、deny 规则)看不到运行时才产生的值:$(git config user.email)、环境变量、脚本里读出来的文件内容;只有沙箱的网络代理在“去向”这一维度上不依赖命令文本,但它也看不到头部内容。第二,把邮箱从上下文移除是唯一改变“起点”的措施,其余防线都只是在它泄出后设卡。因此合理的组合是:等待并验证根因修复,同时用 hook 卡住文本形态、用沙箱卡住去向、用 git 身份分离减少运行时可取得的真实邮箱。

  1. 登录账号 → 邮箱进入 ~/.claude.json(社区说法)与模型上下文(第一方确认)
  2. 模型生成工具调用:Bash 命令 / WebFetch URL / Write 脚本(可能把邮箱写成联系方式)
  3. PreToolUse hook 与内置 mod tool.check:对调用文本做匹配,exit 2 或 refuse 可阻止
  4. 权限规则:deny 在所有模式成立,ask 弹出确认,auto 分类器随后判断
  5. 沙箱网络代理:仅 Bash/PowerShell/Monitor,按 allowedDomains 放行、deniedDomains 拒绝
  6. 第三方服务器记录 User-Agent → 本地不再有任何控制
邮箱从账号登录到第三方日志的路径,以及每道防线所处的位置。虚线左侧是本地可控的部分。

GitHub issue #107757:Bug Report: Privacy violation in User-Agent header · Claude Code 文档:Hooks · Claude Code 文档:Sandboxing · Claude Code 文档:Best practices · Claude Code 文档:Permissions

7. 自查:扫描本地转录,看邮箱出现在哪些工具调用里

Claude Code 把每个项目的会话记录保存在 ~/.claude/projects 下的 .jsonl 文件中(若设置了 CLAUDE_CONFIG_DIR,则在该目录下)。这个格式没有公开文档,所以下面的脚本不假设任何固定结构:它逐行解析 JSON,递归遍历每个对象,只要遇到 type 为 tool_use 且带有 input 的节点,就把 input 序列化后查找你传入的邮箱(含一次百分号编码的形态)。命中时打印时间戳、文件名前缀、工具名、是否同时点名了 User-Agent,以及脱敏后的输入前 220 个字符。它只读文件,不改动、不联网。

Claude Code 文档:Hooks · Claude Code 文档:Settings

audit_transcripts.py:只读扫描本地转录。用法 python3 audit_transcripts.py you@example.com
#!/usr/bin/env python3
"""Read-only audit of local Claude Code transcripts: which recorded tool calls
carried the address you pass in? Nothing is modified or sent anywhere."""
import json, os, re, sys
from pathlib import Path
from urllib.parse import quote

if len(sys.argv) < 2 or "@" not in sys.argv[1]:
    sys.exit("usage: python3 audit_transcripts.py you@example.com")
ADDR = sys.argv[1].strip().lower()
FORMS = {ADDR, quote(ADDR, safe=""), ADDR.replace("@", "%40")}
ROOT = Path(os.environ.get("CLAUDE_CONFIG_DIR", Path.home() / ".claude")) / "projects"
UA = re.compile(r"user[-_ ]?agent|(?:^|\s)-A\s|(?:^|\s)-U\s|-UserAgent", re.I)

def tool_uses(node):  # the transcript format is undocumented: walk every object
    if isinstance(node, dict):
        if node.get("type") == "tool_use" and isinstance(node.get("input"), dict):
            yield node
        for value in node.values():
            yield from tool_uses(value)
    elif isinstance(node, list):
        for value in node:
            yield from tool_uses(value)

hits, files = 0, set()
for path in sorted(ROOT.glob("**/*.jsonl")):
    for line in path.open(encoding="utf-8", errors="replace"):
        try:
            rec = json.loads(line)
        except ValueError:
            continue
        for call in tool_uses(rec):
            raw = json.dumps(call["input"], ensure_ascii=False)
            if not any(form in raw.lower() for form in FORMS):
                continue
            hits += 1; files.add(path)
            shown = raw
            for form in FORMS:
                shown = re.sub(re.escape(form), "<account email>", shown, flags=re.I)
            print(f"{str(rec.get('timestamp', '?'))[:19]} {path.stem[:8]} "
                  f"tool={call.get('name')} ua_named={'yes' if UA.search(raw) else 'no'}")
            print("    " + shown[:220])
print(f"\n{hits} tool call(s) in {len(files)} transcript file(s) contained the address.")

读结果时注意三点。第一,ua_named=yes 的行与内置 mod 的匹配范围大致对应,ua_named=no 的行则是 README 承认放行的形态(URL、请求体、脚本内容)。第二,如果命中集中在 Write/Edit 工具,说明邮箱是被写进脚本再执行的——正是社区报告中 mod 看不到的路径。第三,命中数不等于实际发出的请求数:命令可能执行失败、可能被你当场拒绝,转录里也不会记录对方服务器是否收到。它只能告诉你“模型曾经想这样做”,这已经足以决定是否需要第 8 节的 hook。

8. 确定性防线一:PreToolUse hook 拒绝任何带你身份的工具输入

hooks 文档规定:PreToolUse hook 从 stdin 收到一个 JSON,其中 tool_name 是工具名,tool_input 是工具参数(Bash 的 command、Write 的 file_path 与 content、Edit 的 new_string、WebFetch 的 url 与 prompt 等);hook 以退出码 2 结束即阻止调用,stderr 作为原因返回给模型;也可以在 stdout 输出带 permissionDecision 为 deny 的 hookSpecificOutput JSON。matcher 支持 Bash、Edit|Write 这类按工具名的匹配,也支持正则。自 2.1.314 起,Bash matcher 同时作用于 Monitor 工具启动的命令。hook 在子智能体里同样触发——这恰好对应社区报告中“几乎全部来自子智能体”的情况。

Claude Code 文档:Hooks

下面的 hook 比内置 mod 更宽:只要 tool_input 的任意字段包含你列出的身份(文件 ~/.claude/private-identifiers.txt 中每行一个邮箱,外加当前 git config user.email 的值),不论有没有点名 User-Agent,一律 exit 2。它还会拒绝 Bash/PowerShell 命令里出现 git config … user.email 的形态,因为运行时取值是文本检查天然看不到的。代价是误拒:当你真的让 Claude 在某个配置文件里写上自己的邮箱时,它也会被挡下,stderr 会提示模型请你手动完成这一步。这是刻意的取舍,和 README 对误拒的态度一致。

~/.claude/hooks/identity_guard.py:PreToolUse hook,只读 stdin,exit 2 即阻止
#!/usr/bin/env python3
"""PreToolUse hook: exit 2 (block) when a tool input carries one of your own
addresses, or reads the git identity at run time. Reads stdin JSON only."""
import json, os, re, subprocess, sys
from pathlib import Path
from urllib.parse import quote

def identities():
    ids = set()
    listed = Path(os.environ.get("IDENTITY_GUARD_FILE",
                                 Path.home() / ".claude" / "private-identifiers.txt"))
    if listed.is_file():
        ids |= {l.strip().lower() for l in listed.read_text().splitlines() if "@" in l}
    try:  # whatever `git config user.email` would answer right now
        out = subprocess.run(["git", "config", "--get", "user.email"],
                             capture_output=True, text=True, timeout=3).stdout.strip()
        if "@" in out:
            ids.add(out.lower())
    except (OSError, subprocess.SubprocessError):
        pass
    return ids

payload = json.load(sys.stdin)
tool = payload.get("tool_name", "")
blob = json.dumps(payload.get("tool_input", {}), ensure_ascii=False).lower()
reasons = []
for addr in identities():
    forms = {addr, quote(addr, safe=""), addr.replace("@", "%40"), addr.replace("@", "[at]")}
    if any(form.lower() in blob for form in forms):
        reasons.append(f"input contains a private identifier ({addr[:2]}***)")
if tool in ("Bash", "PowerShell") and re.search(r"git\s+config\b[^|;&]*user\.email", blob):
    reasons.append("command reads the git identity at run time, which this hook cannot see")
if reasons:
    sys.stderr.write("identity-guard: " + "; ".join(reasons)
                     + ". Remove it, or ask the user to run this step by hand.\n")
    sys.exit(2)

两点实现细节。第一,用 Python 而不是 jq,是为了对整个 tool_input 做统一序列化后匹配,不必为每个工具写字段名;hooks 文档提醒 Windows 上 file_path 带反斜杠,但本脚本不比较路径,所以不受影响。第二,hook 不打印任何 JSON,只依赖退出码;按文档,退出码 2 加 stderr 就是阻止并传递原因的标准方式,而退出码非 0 非 2 的失败默认不阻止——所以第 9 节的注册里加了 onFailure: block(2.1.295 起可用),让脚本自身出错或超时也视为阻止。

Claude Code 文档:Hooks

9. 确定性防线二与三:deny 规则和沙箱网络白名单,写进同一个 settings.json

最佳实践文档的原则是:deny 规则在所有权限模式下成立,包括 auto 与 bypassPermissions;Read(./.env) 这样的规则同时能拦下 cat .env,因为 Claude Code 识别常见的读文件命令,但拦不住一个自己 open 文件的脚本;WebFetch 的域名 deny 规则对同一域名的 curl 毫无作用——除非沙箱开着。文档的结论是“安全相关的事情两者都要”。权限文档进一步说明,Bash 的 deny 规则按命令原文匹配,/usr/bin/curl 或 sh -c 'curl …' 都不会命中,所以网络限制必须成立时要配沙箱白名单。

Claude Code 文档:Best practices · Claude Code 文档:Permissions · Claude Code 文档:Security

沙箱文档的关键事实:沙箱默认关闭,用 /sandbox 或 "sandbox": {"enabled": true} 打开;macOS 用 Seatbelt,Linux 与 WSL2 用 bubblewrap 加 socat,原生 Windows 不支持;网络没有直接出口,连接经本地代理按 allowedDomains 判断,白名单从空开始;访问白名单之外主机时,手动模式弹窗、dontAsk 模式拒绝、bypassPermissions 模式放行,deniedDomains 在所有模式下都拒绝;allowUnsandboxedCommands: false 关闭“在沙箱外重试”的逃生口(即 Overrides 页的严格模式);credentials.files 与 credentials.envVars 的 deny 条目能禁止沙箱内命令读取 ~/.ssh 等文件或看到指定环境变量——但这些 credentials 条目只在用户级或托管设置里生效,项目与本地设置里的会被忽略。

Claude Code 文档:Sandboxing

~/.claude/settings.json(用户级):注册 hook、deny/ask 规则、严格沙箱与凭据保护
{
  "permissions": {
    "deny": ["Read(./.env)", "Read(./.env.*)", "Read(./secrets/**)", "Read(~/.claude.json)"],
    "ask": ["Bash(curl *)", "Bash(wget *)", "Bash(dangerouslyDisableSandbox:true)"]
  },
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash|PowerShell|Write|Edit|WebFetch|WebSearch",
        "hooks": [
          {
            "type": "command",
            "command": "python3 ~/.claude/hooks/identity_guard.py",
            "timeout": 10,
            "onFailure": "block"
          }
        ]
      }
    ]
  },
  "sandbox": {
    "enabled": true,
    "allowUnsandboxedCommands": false,
    "network": {
      "allowedDomains": ["github.com", "*.npmjs.org", "pypi.org", "files.pythonhosted.org"]
    },
    "credentials": {
      "files": [
        { "path": "~/.ssh", "mode": "deny" },
        { "path": "~/.aws/credentials", "mode": "deny" }
      ],
      "envVars": [{ "name": "GITHUB_TOKEN", "mode": "deny" }]
    }
  }
}

逐项说明:Read(~/.claude.json) 对应社区所说的邮箱存放位置,使模型的 Read 工具和 cat 之类命令读不到它(Claude Code 自身仍能读写);ask 中的 Bash(curl *) 与 Bash(wget *) 让网络命令每次弹窗——安全文档本来就写明这两类命令在手动模式下不会被自动批准;Bash(dangerouslyDisableSandbox:true) 是沙箱文档建议的 ask 规则,在 auto 与 bypassPermissions 模式下也会对“沙箱外重试”弹窗,与 allowUnsandboxedCommands: false 形成双保险;allowedDomains 只是示例,请替换成你的构建真正需要的域名。hook 的 matcher 写成 Bash|PowerShell|Write|Edit|WebFetch|WebSearch;若你用 MCP 工具抓网页,再加一条 mcp__.* 的 matcher。

Claude Code 文档:Sandboxing · Claude Code 文档:Permissions · Claude Code 文档:Security

每一层防线覆盖什么、不覆盖什么。“确定性”沿用最佳实践文档的定义:harness 每次都必须执行。
层性质覆盖不覆盖依据
系统提示里的那句话(2.1.234 起)非确定性提醒模型只把邮箱用于识别用户模型可以判断“这次是例外”——本次事件即如此CHANGELOG;最佳实践
CLAUDE.md 约定非确定性团队级的 UA 命名约定、哪些站点允许联系方式任何必须每次成立的规则最佳实践
内置 mod cc-plugin-privacy确定性(文本匹配)Bash/PowerShell/Monitor 输入中“邮箱 + 点名 UA”无 UA 的邮箱、WebFetch/WebSearch/MCP、运行时取值、脚本内邮箱、其他编码;可被上层插件推翻README
你的 PreToolUse hook确定性(文本匹配)Bash/PowerShell/Write/Edit/WebFetch/WebSearch 输入中的任意身份形态;git config user.email 命令运行时取值、变量、未列出的身份、描述性产品标识hooks 文档
permissions.deny / ask确定性(按命令原文)读取 .env、~/.claude.json;curl/wget 每次弹窗按路径调用或 sh -c 包裹的程序;脚本自己打开文件权限、最佳实践、安全文档
沙箱网络白名单(严格模式)确定性(OS 级)Bash/PowerShell/Monitor 命令的去向;凭据文件与环境变量Read/Edit/Write/WebFetch/WebSearch、hooks、MCP、mods、! 手动命令;头部内容沙箱文档
把邮箱从上下文移除(已宣布)消除前提模型不再知道你的账号邮箱git config、文件、环境变量里的邮箱;UA 中的项目名HN 说明;CHANGELOG 待确认

anthropics/claude-code CHANGELOG.md · 内置 mod 源码:mods/privacy README · Claude Code 文档:Hooks · Claude Code 文档:Sandboxing · Claude Code 文档:Best practices · Claude Code 文档:Permissions

10. 验证:用无害命令确认拒绝发生,并把 git 身份换成 no-reply

配置写完不等于生效:hooks 文档专门提醒,settings.json 里路径拼错会让 hook 从不运行,第一次触发时要盯紧 hook error 通知。下面的脚本做五件事:打印 claude --version;用四个合成的 PreToolUse 负载直接喂给 hook 脚本(临时身份文件只含 you@example.com,目标全是 .invalid 域名,什么都不会发出去);提示你在真实会话里让 Claude 运行 echo 'User-Agent: test 你的邮箱' > /dev/null 并观察是否被拒;打印当前 git 身份;提醒在 /plugins 与 /sandbox 里核对状态。

Claude Code 文档:Hooks · Claude Code 文档:Sandboxing

verify_guard.sh:离线验证 hook、检查版本、git 身份与插件/沙箱状态
#!/usr/bin/env bash
# Verify the guard without sending anything: every target is a non-routable .invalid name.
set -u
echo "1) version (the built-in mod needs 2.1.317+; read CHANGELOG.md for the context change)"
claude --version
echo "2) hook blocks synthetic payloads (expect exit=2 and an identity-guard reason on stderr)"
tmp=$(mktemp); echo "you@example.com" > "$tmp"
run() { printf '%s' "$1" | IDENTITY_GUARD_FILE="$tmp" python3 ~/.claude/hooks/identity_guard.py; echo "   exit=$?"; }
run '{"tool_name":"Bash","tool_input":{"command":"curl -A \"bot/1.0 (you@example.com)\" http://leak-test.invalid/"}}'
run '{"tool_name":"Write","tool_input":{"file_path":"/tmp/fetch.py","content":"UA = \"tool/0.1 (mailto:you%40example.com)\""}}'
run '{"tool_name":"Bash","tool_input":{"command":"curl -A \"$(git config user.email)\" http://leak-test.invalid/"}}'
run '{"tool_name":"Bash","tool_input":{"command":"npm test"}}'   # expect exit=0
rm -f "$tmp"
echo "3) inside a session, ask Claude to run exactly:  echo 'User-Agent: test <your address>' > /dev/null"
echo "   expected: the call is refused and the transcript shows the identity-guard reason"
echo "4) git identity any \$(git config user.email) would reveal:"; git config --get user.email || echo "(unset)"
echo "   prefer a no-reply address for agent commits: git config --global user.email <id>+<name>@users.noreply.github.com"
echo "5) /plugins -> Installed should list cc-plugin-privacy@builtin; /sandbox -> Network shows the allowlist, Overrides shows strict mode"

那条 echo 测试命令直接来自 issue 评论:它完全不联网,但同时包含邮箱与 User-Agent 字样,正是 README 承诺会拒绝的形态。社区用它得到了“未拒绝”的结果;你用它应当得到两层结果——如果内置 mod 生效,模型会收到 mod 的 REFUSAL;如果只有你的 hook 生效,转录里会出现 identity-guard: 开头的原因。两者都没有,就说明你的 hook 没有运行,先查 settings.json 的路径与 python3 是否在 PATH 里。

GitHub issue #107757:Bug Report: Privacy violation in User-Agent header · 内置 mod 源码:mods/privacy README

git 身份分离是最便宜的一道防线:README 和社区报告都提到 $(git config user.email) 这条运行时取值的路径,任何文本匹配都看不到它。把全局 user.email 改成代码托管平台提供的 no-reply 地址后,即便模型在某条命令里取用它,泄出去的也只是一个不收信的地址。注意这会改变提交记录里的作者邮箱,团队如果有 DCO 或签名校验要求,先确认该地址已在平台上关联到你的账号。

11. 行动顺序:今天、升级后、以及要持续做的

  1. 今天:运行第 7 节的审计脚本,确定自己是否受影响、主要载体是不是子智能体的 curl;把结果留档但不要发给任何人。
  2. 今天:安装第 8、9 节的 hook 与 settings(用户级),运行第 10 节的验证脚本;把 git 全局身份换成 no-reply 地址。
  3. 升级到 2.1.317 及以上(HN 说明称当时稳定通道仍在 2.1.311),在 /plugins 确认 cc-plugin-privacy@builtin 已加载,并用 echo 测试命令验证它是否真的拒绝——社区报告显示“已加载”和“会拒绝”可能是两回事。
  4. 每次升级后读 CHANGELOG.md 的最新版本段落,寻找“账号邮箱已从上下文移除”的条目;在确认之前,把该修复视为未发布。
  5. 持续:隔一段时间重跑审计脚本观察新会话;在 CLAUDE.md 里约定模型自拟 UA 时只用通用标识,不带项目名或客户名——这是非确定性的,只能作为补充。
  6. 团队:把 hook 与 deny 规则放进仓库的 .claude/settings.json 共享(deny 立即生效,allow 等待信任对话框),但记住 credentials 条目与严格沙箱需要用户级或托管设置。

最后说一句分寸。这次事件的教训不是“Claude Code 不可信”,而是“任何放进模型上下文的信息,都要假设它可能出现在模型生成的任何字符串里”。邮箱只是最容易被观察到的一种;项目名、客户名、内部主机名也在同一条路径上。确定性防线的价值在于它不依赖模型的判断,而审计脚本的价值在于让你用自己的数据而不是别人的截图来决定下一步。

Claude Code 文档:Best practices

我们没有验证的事:没有在任何版本上复现邮箱进入 User-Agent 的原始行为;没有验证内置 mod 在 2.1.317/2.1.318/2.1.319 上是否真的拒绝 README 所述的命令(社区报告称不拒绝,我们未复现);没有核对 ~/.claude.json 中 oauthAccount.emailAddress 字段的说法;没有找到 CHANGELOG 中“邮箱已从上下文移除”的条目,因此把根因修复视为已宣布、未确认发布;没有逐条核对 issue #81138 与 #37201 的内容,只确认链接可访问。本文的 hook、settings 与脚本都只用合成数据和 .invalid 域名离线测试过,没有在生产环境或真实网络上运行。本文分析的是 Anthropic 的产品与开源仓库,本站与 Anthropic 没有任何关系。