你的AI助手在悄悄上报什么?leaked-claude-code遥测系统代码级隐私安全审查

原创2026-10-25 19:11:391,927 阅读

你的AI助手在悄悄上报什么?leaked-claude-code遥测系统代码级隐私安全审查

Claude Code 是当下最流行的终端 AI 编程助手之一,而 leaked-claude-code 项目意外泄露了它的完整 TypeScript 源码,让我们第一次可以从代码级审视:这个 AI 助手到底在向你、以及向服务端上报哪些数据?本文基于真实源码,带你完成一次完整的遥测系统隐私安全审查。

leaked-claude-code 遥测系统隐私审查源码下载

leaked-claude-code 是什么?为什么值得做隐私审查

2026 年 3 月 31 日,Anthropic 发布到 npm 的 Claude Code 包里暴露了一个 .map 文件,顺藤摸瓜即可下载约 51.2 万行未混淆的 TypeScript 源码。本仓库 README.md 记录了这次泄露的全过程,并重建了构建系统,让这份快照可以真正编译运行。

对关心隐私的用户来说,这份源码的价值恰恰在于:官方从未完整公开过遥测(telemetry)细节,而现在每一个 POST、每一次心跳、每一条埋点,都写在明面上。

想自己动手翻源码?

git clone https://gitcode.com/gh_mirrors/le/leaked-claude-code

Claude Code 上报了哪些数据?四条通道看懂

通读代码后,可以把数据外发归纳为 4 条通道,各自的"敏感度"差别很大:

通道 上报内容 敏感度 源码位置
分析埋点 logEvent 功能使用事件(命令、插件、会话跳过原因等) 中 services/analytics/(见架构表)
会话事件通道 会话状态、worker 事件、对话转录 高 cli/transports/ccrClient.ts
心跳与轮询 存活状态、轮询/心跳间隔配置 低 bridge/pollConfig.ts
设备注册 设备名、主机名、平台 中 bridge/trustedDevice.ts

通道一:分析埋点 logEvent

所有产品行为埋点统一走 logEvent(),其元数据参数带有强制类型约束,例如 bridge/debugUtils.ts 导入的 AnalyticsMetadata_I_VERIFIED_THIS_IS_NOT_CODE_OR_FILEPATHS——类型名本身就是承诺:这个字段"我保证不是代码或文件路径"。在 cli/handlers/plugins.ts 中,插件名走的是另一类 PII_TAGGED 类型,会被路由到专门的 PII 标记字段。

这种"用类型系统防止敏感字段混入埋点"的设计,值得所有做埋点的前端同学借鉴。

通道二:CCR 会话事件通道(重点)

cli/transports/ccrClient.ts 的 CCRClient 是与云端会话服务(CCR v2)通信的核心:

  • 对话转录会上传:writeInternalEvent() 的注释明确写着,内部事件存储"transcript messages"(转录消息、压缩标记),用于会话恢复——也就是你在 Web/移动端能看到续聊,靠的就是本地把对话内容 POST 到 /worker/internal-events;
  • 批量上报:所有上传共用 SerialBatchEventUploader,单批最多 100 条、单包最大 10 MB,失败指数退避无限重试;
  • 投递回执:每收到一条指令,都会通过 reportDelivery() 上报 received/processing/processed 状态。

⚠️ 关键结论:当你使用远程桥接(bridge / 云端会话)功能时,对话内容本身会被上传。仅本地终端使用时,数据主要留在本机,但分析埋点仍在发生。

通道三:心跳与轮询

心跳默认 20 秒一次(服务端 TTL 60 秒,留 3 倍余量),见 bridge/envLessBridgeConfig.ts。轮询间隔则由远端配置中心 GrowthBook 统一下发(bridge/pollConfig.ts),配置用 Zod 严格校验、带"至少 100ms"的防呆下限——运维手滑填错单位也不会把服务端打爆。

这属于典型的"设备存活"数据,本身不含内容,但能反映你的使用时长与活跃时段。

通道四:可信设备注册

bridge/trustedDevice.ts 在 /login 后会向 POST /auth/trusted_devices 注册设备,上报 主机名 · 操作系统平台 作为设备显示名,拿到 90 天滚动有效的设备令牌存入系统密钥链(keychain),后续每次桥接请求都携带 X-Trusted-Device-Token 头。

值得注意的隐私细节:主机名会被上报。如果习惯用个人姓名命名电脑,这里存在"设备名 = 个人标识"的泄露可能。

代码里的"防泄漏"设计:隐私保护机制盘点

审查不能只看"报了什么",还要看"怎么防止报多"。这份源码里有不少扎实的防护设计 👇

无 PII 诊断日志

全仓库大量使用 logForDiagnosticsNoPII(见 cli/transports/ccrClient.ts),函数名直接声明"日志内容不含个人身份信息",与允许携带 PII 的普通日志物理隔离。

调试日志自动脱敏

bridge/debugUtils.ts 内置 redactSecrets():凡是 session_ingress_token、access_token、secret 等字段,一律替换为 [REDACTED] 或"前 8 位 + 后 4 位"的打码形式,调试消息还会强制截断到 2000 字符,避免把整个请求体(可能含代码)灌进日志。

Essential traffic only 模式

bridge/trustedDevice.ts 中出现 isEssentialTrafficOnly() 检查:当用户选择仅必要流量的隐私级别时,设备注册这类非必需的上报会被跳过。这是源码中最接近"隐私开关"的机制,说明产品在隐私分级上有真实投入。

OTel 导出器被整体打桩

README 中还提到本 fork 把 10 个 OpenTelemetry OTLP exporter 全部 stub 化——即开源研究版中,可观测性数据导出通道默认是关闭状态。

普通用户隐私自查清单

基于以上代码级审查,给普通用户一份可执行的自查清单:

  1. 📌 分清使用场景:纯本地终端对话 vs 云端桥接会话(bridge),后者的转录内容会上报到服务端;
  2. 📌 改设备名:桥接功能会把主机名注册为设备名,避免用姓名、工号命名电脑;
  3. 📌 检查隐私级别:确认是否已启用"仅必要流量"(essential traffic only)模式,它会跳过非必需上报;
  4. 📌 管好令牌:trusted device token 存于系统密钥链,卸载或换账号时留意清理旧账号凭证;
  5. 📌 企业场景:企业可通过 CLAUDE_TRUSTED_DEVICE_TOKEN 环境变量接管设备令牌(见 trustedDevice.ts),统一管控遥测行为。

结语

这次源码泄露给了所有 AI 工具用户一堂生动的"透明化"课:Claude Code 的遥测系统架构上相当规范——类型系统防 PII、日志脱敏、隐私分级开关、远端配置防呆一应俱全;但"会话转录用于恢复"与"20 秒心跳"也提醒我们,云会话功能与本地使用的数据边界截然不同。看懂它上报什么,才能安心使用它。

⚠️ 免责说明:本仓库是面向安全研究的实验性快照,请仅在合法合规的前提下阅读源码,切勿将其用于绕过付费限制等违规行为。

登录后查看全文
leaked-claude-code