Claude Code 把账号邮箱塞进 User-Agent?2.1.317+ 隐私补丁怎么升级、怎么自查、日志怎么看

据 GitHub #107757 与 HN 反馈,Claude Code 会话上下文里的登录邮箱,有时会被写进 curl 等请求的 User-Agent。2.1.317+ 内置 cc-plugin-privacy;本文讲清升级、确认插件、自查日志与覆盖边界,并给出本机版本核对耗时。

5 分钟阅读
Claude Code 把账号邮箱塞进 User-Agent?2.1.317+ 隐私补丁怎么升级、怎么自查、日志怎么看

据 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 升级与自查为主,不单推某一家。

Create API Key →

发生了什么(据公开反馈)

来源要点
GitHub #107757用户反馈:web 搜索相关请求把邮箱放进 User-Agent,随后收到大量诈骗邮件
Hacker News工程师:将从模型上下文移除账号邮箱;在此之前请用 2.1.317+ 内置 mod
官方 mods/privacy READMEcc-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+

先看本机版本:

bash
claude --version
# 需要 >= 2.1.317;低于该版本请升级

本机核对耗时约 1 秒(输出示例:2.1.316 (Claude Code)——低于门槛,必须升级)。

常见升级路径(按你的安装渠道选一条):

bash
# 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 不会装低于该值的版本):

json
{
  "autoUpdatesChannel": "stable",
  "minimumVersion": "2.1.317"
}

升完再跑一次 claude --version,确认 ≥ 2.1.317。

Create API Key →

确认隐私插件 cc-plugin-privacy

据 GitHub 贡献者:2.1.317+ 内置 mod 名 cc-plugin-privacy,默认开启,可用 /plugins 开关。

在 Claude Code 会话里:

  1. 打开 /plugins
  2. 在 Installed / builtin 列表里找到 cc-plugin-privacy
  3. 确认是启用状态(不要误关)

据官方 README,下列方式会关掉或绕过它:

  • /plugin disable,或在用户 / --settings / managed settings 的 enabledPlugins 里写 "cc-plugin-privacy@builtin": false(仓库 settings 不能关)
  • 服务端开关(每会话读一次)
  • 其他已装插件的 tool.check hook 排在上面、否决拒绝
  • 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 工程师:后续版本会把账号邮箱从模型上下文拿掉。

日志 / 自查怎么做

  1. 版本:claude --version ≥ 2.1.317
  2. 插件:/plugins 确认 cc-plugin-privacy 启用
  3. 转录:在 ~/.claude/projects/**/*.jsonl(路径以本机为准)里搜你的邮箱、User-Agent、curl -A、wget -U
  4. 代理 / 抓包:若你有本地 HTTPS 代理或公司 egress 日志,按同样关键词过滤近期 Claude Code 相关请求
  5. 已暴露:轮换可能被滥用的令牌/会话;邮箱侧开启更严过滤;在项目说明里给 agent 一个可公开的角色联系邮箱,避免私人地址进入可外发上下文

据用户反馈:即使显示插件已加载,个别环境上「文档应拒绝」的本地 echo 测试仍可能放过——以官方 README 边界为准,并持续关注 GitHub 讨论;不要只依赖一次 UI 勾选。

和其他客户端怎么并列看

隐私问题跟「上下文里有什么」绑定,不绑定某一品牌:

  • Claude Code:按本文升到 2.1.317+、确认 cc-plugin-privacy、自查日志
  • Codex / Cursor:同样避免把个人邮箱、密钥写进可触发联网工具的说明;用角色邮箱或脱敏联系方式

需要第三方 Key 跑多客户端时,可在本站注册后按各客户端文档配置(Claude Code / Codex / Cursor 均可对接)。

Create API Key →

常见问题

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 秒。若邮箱已出现在第三方请求里,及时轮换凭据并改用可公开联系地址。

Create API Key →

相关阅读:Claude Code Auto Mode 403/422 · Postman 插件自查 · VS Code 扩展后门自查

相关文章

UI SDK 是什么、怎么用?Vercel + shadcn 给 Agent 的行为库,在 Claude Code / Codex / Cursor 里安装与实测(0.1.0-beta.1)

UI SDK 是什么、怎么用?Vercel + shadcn 给 Agent 的行为库,在 Claude Code / Codex / Cursor 里安装与实测(0.1.0-beta.1)

UI SDK 是 Vercel 在 2026 年 11 月 12 日发布的、给 Agent 用的行为(behaviors)库,版本 0.1.0-beta.1。行为写在与框架无关的 @ui-sdk/core 里,再由 React、Vue、Svelte、Solid 和 Web Components 适配器渲染。本文按官方文档整理它是什么、怎么安装、怎么给 Claude Code / Codex / Cursor 装 skill,并记录我们在测试机上的真实命令、耗时和输出。

AWS Emulator 是什么、怎么装?让 Claude Code / Codex 在本地测 AWS 应用(1.0.322 实测)

AWS Emulator 是什么、怎么装?让 Claude Code / Codex 在本地测 AWS 应用(1.0.322 实测)

AWS Emulator 是 AWS 官方 2026 年 11 月 12 日(北京时间)正式发布的本地 AWS 模拟器,没有额外服务费、源码开放,不需要 AWS 账号,覆盖 200 多个服务。本文在 Debian 13 上实测 1.0.322:安装命令、AWS CLI 指向本地 endpoint 建 S3 桶和 DynamoDB 表、常见报错,以及让 Claude Code、Codex、Cursor 对着模拟器写代码跑测试的接法。

T3 Code 是什么、怎么装?接入 Claude Code 和 Codex、配置第三方 API Key 与常见报错(0.1.9 实测)

T3 Code 是什么、怎么装?接入 Claude Code 和 Codex、配置第三方 API Key 与常见报错(0.1.9 实测)

T3 Code 是 pingdotgg 开源的编码 Agent 控制台,本身不带模型,调用你机器上已装好的 Claude Code、Codex、Cursor 等 CLI。本文在 Linux 上实测 T3 Code 0.1.9:讲清安装命令,Claude Code 和 Codex 先各自接上 AICodeWith API Key、再由 T3 Code 调用的配置方法,用 t3 thread 命令行跑通两端的过程,以及我们实际遇到的报错和解法。