据 GitHub anthropics/claude-code#107757 与用户反馈,Claude Code 在联网检索或 shell 工具调用时,有时会把已登录账号邮箱写进请求的 User-Agent。报告者 taylor-edwards(macOS,约 2.1.318)称因此收到大量钓鱼/诈骗邮件。Hacker News 讨论中,Claude Code 工程师说明:邮箱是为减少 @author 等幻觉写进模型上下文的;模型写 curl 时偶尔把它当作联系地址发出去。
先说结论:
- 立刻升到 2.1.317 或更新:据 HN 官方回复,stable 渠道当时仍可能停在更旧版本(例如 2.1.311),没有内置隐私 mod。
- 确认
cc-plugin-privacy已启用:据 GitHub 贡献者说明,该内置 mod 默认开启,可在/plugins关闭。 - 据官方 README:mod 只拦「Bash / PowerShell / Monitor 输入里同时出现账号邮箱 + User-Agent 相关词」这一种形态;不查 WebFetch、WebSearch、MCP;无 UA 词的 URL/body/
From:/curl -u等也会放过。 - 自查日志:在会话转录 / 代理日志里搜自己的邮箱与
User-Agent/curl -A/wget -U。 - 若已暴露:轮换相关凭据、关注邮箱异常邮件,并给 agent 一个可公开的角色邮箱(不要用私人邮箱当联系地址)。
- Codex、Cursor 等其他客户端同样要避免把个人邮箱写进可外发上下文;本文以 Claude Code 升级与自查为主,不单推某一家。
发生了什么(据公开反馈)
| 来源 | 要点 |
|---|---|
| GitHub #107757 | 用户反馈:web 搜索相关请求把邮箱放进 User-Agent,随后收到大量诈骗邮件 |
| Hacker News | 工程师:将从模型上下文移除账号邮箱;在此之前请用 2.1.317+ 内置 mod |
| 官方 mods/privacy README | cc-plugin-privacy:courtesy,不是边界;覆盖一种 shell 形态 |
| DEV 整理文 | 第三方整理:stable 可能仍低于带 guard 的版本,需主动升级 |
据 HN:部分站点(如 Wikimedia、SEC EDGAR)要求脚本客户端在 User-Agent 里带联系方式;模型上下文里只有你的账号邮箱时,就可能把它填进去。这不是「故意外泄功能」,但效果一样——第三方站点会收到你的邮箱。
相关排查也可对照:Claude Code Auto Mode Gateway 403/422、Postman 插件自查、VS Code 扩展后门自查。
升级到 2.1.317+
先看本机版本:
claude --version
# 需要 >= 2.1.317;低于该版本请升级
本机核对耗时约 1 秒(输出示例:2.1.316 (Claude Code)——低于门槛,必须升级)。
常见升级路径(按你的安装渠道选一条):
# latest 渠道:拉最新
claude update
# 原生安装指定版本(示例)
curl -fsSL https://claude.ai/install.sh | bash -s 2.1.317
# Homebrew:官方 claude-code cask 常跟 stable;需带 guard 时可改 latest cask
brew uninstall --cask claude-code
brew install --cask claude-code@latest
据 HN / 第三方整理:claude update 对 Homebrew 安装不一定生效;apt/dnf/apk 若钉在 stable 仓库,也可能停在旧版。可在 settings.json 设最低版本地板(据文档,auto-update / claude update 不会装低于该值的版本):
{
"autoUpdatesChannel": "stable",
"minimumVersion": "2.1.317"
}
升完再跑一次 claude --version,确认 ≥ 2.1.317。
确认隐私插件 cc-plugin-privacy
据 GitHub 贡献者:2.1.317+ 内置 mod 名 cc-plugin-privacy,默认开启,可用 /plugins 开关。
在 Claude Code 会话里:
- 打开
/plugins - 在 Installed / builtin 列表里找到
cc-plugin-privacy - 确认是启用状态(不要误关)
据官方 README,下列方式会关掉或绕过它:
/plugin disable,或在用户 /--settings/ managed settings 的enabledPlugins里写"cc-plugin-privacy@builtin": false(仓库 settings 不能关)- 服务端开关(每会话读一次)
- 其他已装插件的
tool.checkhook 排在上面、否决拒绝 - hooks 模块未加载 /
hooks/register.ts未跑的会话
据官方 README:它拦什么、不拦什么
官方用一句话概括:这是 courtesy,不是 boundary,只覆盖一种形态。
会拒绝(无提示):Bash、PowerShell 或 Monitor 调用的输入里,同时包含会话账号邮箱,且出现 User-Agent 相关命名。命名包括 USER_AGENT_WORD(如 User-Agent、user_agent、--user-agent、-UserAgent、UA=)以及 CLIENT_FLAGS(如 curl -A、wget -U,以及 PowerShell 相关 -User)。拒绝不会弹确认;保存的 allow 规则和 auto mode 分类器也清不掉。
会放过(据官方 README):
- 邮箱出现但没有命名 User-Agent:例如 URL、请求体、
curl -u、From:头 - WebFetch、WebSearch、MCP 工具一律不查
- 运行时拼出来的邮箱(如 运行时拼出的 git 邮箱(如 git config user.email))、变量、按文件名发送的脚本、未点名的客户端、其他编码方式等
因此:升级 + 开着插件是止损,不是「外发邮箱绝迹」。根本方向据 HN 工程师:后续版本会把账号邮箱从模型上下文拿掉。
日志 / 自查怎么做
- 版本:
claude --version≥ 2.1.317 - 插件:
/plugins确认cc-plugin-privacy启用 - 转录:在
~/.claude/projects/**/*.jsonl(路径以本机为准)里搜你的邮箱、User-Agent、curl -A、wget -U - 代理 / 抓包:若你有本地 HTTPS 代理或公司 egress 日志,按同样关键词过滤近期 Claude Code 相关请求
- 已暴露:轮换可能被滥用的令牌/会话;邮箱侧开启更严过滤;在项目说明里给 agent 一个可公开的角色联系邮箱,避免私人地址进入可外发上下文
据用户反馈:即使显示插件已加载,个别环境上「文档应拒绝」的本地 echo 测试仍可能放过——以官方 README 边界为准,并持续关注 GitHub 讨论;不要只依赖一次 UI 勾选。
和其他客户端怎么并列看
隐私问题跟「上下文里有什么」绑定,不绑定某一品牌:
- Claude Code:按本文升到 2.1.317+、确认
cc-plugin-privacy、自查日志 - Codex / Cursor:同样避免把个人邮箱、密钥写进可触发联网工具的说明;用角色邮箱或脱敏联系方式
需要第三方 Key 跑多客户端时,可在本站注册后按各客户端文档配置(Claude Code / Codex / Cursor 均可对接)。
常见问题
stable 渠道升了还是旧版本?
据 HN:stable 可能滞后约一周。改走 latest、指定安装脚本版本,或设 minimumVersion,再核对 claude --version。
changelog 说「asks」、README 说直接拒绝?
据官方 README 源码描述:匹配到的 shell 调用是直接拒绝、不弹窗。changelog 措辞与 README 不完全一致时,以公开 README / 源码为准。
只关插件行不行?
不建议。关掉 cc-plugin-privacy 等于去掉这一层确定性拦截。正确做法是升级,并等待官方把邮箱移出上下文的后续版本。
WebSearch 还会不会带邮箱?
据官方 README:WebFetch / WebSearch / MCP 不在该 mod 检查范围内。所以不能假设「升了就绝对不会外发」;自查日志 + 减少上下文里的私人邮箱仍然必要。
小结
据 GitHub、HN 与官方 privacy README:Claude Code 曾把登录邮箱放进模型上下文,模型有时写进 User-Agent。立刻升级到 2.1.317+,在 /plugins 确认 cc-plugin-privacy,按 README 理解覆盖边界,并在转录/代理日志里自查邮箱外发。本机 claude --version 核对约 1 秒。若邮箱已出现在第三方请求里,及时轮换凭据并改用可公开联系地址。
相关阅读:Claude Code Auto Mode 403/422 · Postman 插件自查 · VS Code 扩展后门自查



