·设为首页收藏本站📧邮箱修改🎁免费下载专区📒收藏夹📱AI全功能
🔄最新发布📃文档资料库🆔加群看共享软件分享切换到窄版
立即注册
DZ插件网»🏠首页 › Discuz! › AI实践应用 › AI人工智能 › Claude Code 封号机制深度探查报告 New
返回列表 发布新帖

Claude Code 封号机制深度探查报告 New

98 1
发表于 昨天 10:58 | 查看全部 阅读模式

马上注册，免费下载更多dz插件网资源。

您需要 登录 才可以下载或查看，没有账号？立即注册

×
From: https://github.com/instructkr/claude-code
Claude Code 封号机制深度探查报告

基于 Claude Code 已泄露源代码分析，全面揭示其数据采集、上报机制及封号触发点
一、核心结论

Claude Code 构建了一套企业级用户追踪和行为分析系统，通过 Device ID（永久标识）+ 环境指纹（40+ 维度）+ 行为遥测（640+ 事件类型）形成完整的用户画像。封号并非单一触发，而是多维度综合判定。
封号最可能的 5 大原因

排名原因风险等级说明
1订阅滥用/共享账号极高Device ID 跨设备关联，检测多设备共享同一账号
2速率限制违规高超出 rateLimitTier 配额，短时间高频调用
3内容策略违规高消息内容指纹 + anti-distillation 检测
4自动化滥用中CI/CD 环境检测 + 非交互模式识别 + 异常 token 消耗
5使用非官方客户端/篡改中指纹校验失败 + 版本归因 header 异常
二、身份追踪体系

2.1 持久化标识符

Claude Code 通过以下标识符跨会话永久追踪用户：
标识符生成方式存储位置生命周期
Device IDrandomBytes(32).toString('hex')~/.claude.json永久，除非手动删除
Account UUIDOAuth 登录时服务端下发~/.claude.json绑定账号
Organization UUIDOAuth 登录时下发同上绑定组织
Session IDrandomUUID() 每次会话生成内存单次会话
EmailOAuth 或 git config user.email同上绑定身份
Device ID 是 256 位随机值，首次运行时生成并永久存储。它是所有事件上报的核心标识，Anthropic 可通过它精确关联同一设备上的所有活动。
2.2 消息内容指纹（Fingerprint）

源码位置：src/utils/fingerprint.ts
  1. 算法：SHA256( "59cf53e54c78" + 首条消息[4] + 首条消息[7] + 首条消息[20] + 版本号 )[:3]
复制代码
这个 3 字符指纹被嵌入到：
    HTTP Header x-anthropic-billing-header 的 cc_version 字段System Prompt 中
用途推测：后端可通过此指纹校验请求来源合法性，检测是否有人使用非官方客户端伪造请求。
2.3 每次 API 请求携带的身份信息
  1. HTTP Headers:
  2.   x-app: cli
  3.   User-Agent: claude-cli/2.x.x (external, cli)
  4.   X-Claude-Code-Session-Id: {SESSION_UUID}
  5.   x-anthropic-billing-header: cc_version=2.x.x.{FINGERPRINT}; cc_entrypoint=cli
  6.   x-client-request-id: {REQUEST_UUID}
  8. Request Body metadata:
  9.   user_id: JSON 编码的 Device ID + Account UUID + Session ID
复制代码
三、环境指纹采集（40+ 维度）

Claude Code 在启动时对用户环境进行大规模枚举，以下信息全部上报至服务端。
3.1 系统级信息

采集维度数据来源示例值
操作系统process.platformdarwin/linux/win32
CPU 架构process.archx64/arm64
Node.js 版本process.versionv20.x.x
Linux 发行版/etc/os-releaseubuntu 22.04
Linux 内核os.release()6.5.0-xxx
WSL 版本/proc/version 解析WSL2
3.2 运行环境检测（40+ 种）

Claude Code 通过环境变量和文件探测自动识别运行环境：
CI/CD 平台：
    GitHub Actions（GITHUB_ACTIONS）GitLab CI（GITLAB_CI）CircleCI（CIRCLECI）Buildkite（BUILDKITE）Jenkins（JENKINS_URL）
云开发环境：
    GitHub Codespaces（CODESPACES）Gitpod（GITPOD_WORKSPACE_ID）Replit（REPL_ID）Vercel（VERCEL）Railway（RAILWAY_ENVIRONMENT）
云平台：
    AWS Lambda/Fargate/ECS/EC2GCP Cloud RunAzure Functions/App Service
容器和虚拟化：
    Docker（检测 /.dockerenv 文件）Kubernetes（KUBERNETES_SERVICE_HOST）WSL（WSL_DISTRO_NAME）
终端和 IDE：
    VSCode（VSCODE_*）Cursor（CURSOR_TRACE_ID）JetBrains（TERMINAL_EMULATOR=JetBrains-JediTerm）tmux/screen/SSH
3.3 开发工具链

检测类型方法采集内容
包管理器which npm/yarn/pnpm可用的包管理器列表
运行时which bun/deno/node可用的运行时列表
VCS检测 .git/.hg/.svn 等版本控制系统类型
Git 仓库git remote get-url originSHA256 哈希取前 16 字符
3.4 GitHub Actions 专项采集

在 CI 环境中，额外采集：
字段内容
GITHUB_ACTOR_ID触发者 ID
GITHUB_REPOSITORY_ID仓库 ID
GITHUB_REPOSITORY_OWNER_ID仓库所有者 ID
GITHUB_EVENT_NAME事件类型
RUNNER_ENVIRONMENTRunner 环境
RUNNER_OSRunner 操作系统
四、遥测上报系统

4.1 三路并发上报架构

Claude Code 封号机制深度探查报告 New
4.2 第一方事件日志（最核心）

上报端点：https://api.anthropic.com/api/event_logging/batch
上报频率：每 5 秒批量发送，最多 200 条/批
失败恢复：上报失败的事件持久化到 ~/.claude/telemetry/ 目录，下次启动自动重试（最多 8 次，指数退避）
关键事件类型（640+ 种中最核心的）：
事件名上报内容封号相关性
tengu_init完整环境指纹、设备信息高 - 环境异常检测
tengu_api_success模型名、token 用量、耗时、成本美元、TTFT极高 - 用量监控
tengu_api_error错误类型、HTTP 状态码、重试次数中 - 异常模式
tengu_tool_use_*工具名、执行耗时、成功/失败中 - 行为模式
tengu_exit会话时长、总 token 用量高 - 会话级统计
tengu_oauth_*登录/刷新/失败事件高 - 账号安全
tengu_cancel取消操作低
tengu_auto_mode_*自动模式使用中 - 自动化检测
实际数据:
  1. {
  2.       // ===== 事件头 =====
  3.       "event_type": "ClaudeCodeInternalEvent",     // 事件大类
  5.       "event_data": {
  6.           // ===== 事件基础信息 =====
  7.           "event_name": "tengu_config_cache_stats", // 事件名：配置缓存统计
  8.           "event_id": "ed1cae38-01a8-44dd-...",     // 事件唯一 ID
  9.           "client_timestamp": "2026-03-22T10:26:10.747Z",  // 客户端时间戳
  11.           // ===== 用户身份标识（核心追踪字段）=====
  12.           "device_id": "eab29b910fcc91bxxxxxxxxx8f3c3e6d53d06",
  13.                                                      // 你的永久设备 ID（256 位）
  14.           "session_id": "8c503d21-2d92-...",         // 本次会话 ID
  15.           "email": "[email protected]",              // 你的邮箱（直接明文上报）
  16.           "auth": {
  17.               "organization_uuid": "b2c3112d-...",   // 组织 UUID
  18.               "account_uuid": "7616b4d3-..."         // 账户 UUID
  19.           },
  21.           // ===== 客户端信息 =====
  22.           "model": "claude-opus-4-6[1m]",           // 使用的模型
  23.           "user_type": "external",                   // 用户类型（非内部员工）
  24.           "entrypoint": "cli",                       // 入口点
  25.           "is_interactive": true,                    // 交互模式
  26.           "client_type": "cli",                      // 客户端类型
  27.           "betas": "claude-code-20250219,oauth-2025-04-20,...",  // 启用的 Beta 特性
  29.           // ===== 环境指纹（50+ 维度）=====
  30.           "env": {
  31.               "platform": "darwin",                  // macOS
  32.               "platform_raw": "darwin",              // 原始平台
  33.               "arch": "arm64",                       // Apple Silicon
  34.               "node_version": "v24.3.0",             // Node.js 版本
  35.               "terminal": "tmux",                    // 终端类型
  36.               "package_managers": "npm,pnpm",        // 安装了哪些包管理器
  37.               "runtimes": "deno,node",               // 安装了哪些运行时
  38.               "is_running_with_bun": true,           // 是否用 Bun 运行
  39.               "is_ci": false,                        // 非 CI 环境
  40.               "is_claubbit": false,
  41.               "is_github_action": false,             // 非 GitHub Actions
  42.               "is_claude_code_action": false,
  43.               "is_claude_ai_auth": true,             // 使用 Claude.ai OAuth 认证
  44.               "is_claude_code_remote": false,        // 非远程模式
  45.               "is_conductor": false,
  46.               "is_local_agent_mode": false,
  47.               "deployment_environment": "unknown-darwin",
  48.               "version": "2.1.81",                   // Claude Code 版本
  49.               "version_base": "2.1.81",
  50.               "build_time": "2026-03-20T21:26:18Z",  // 构建时间
  51.               "vcs": "git"                           // 版本控制系统
  52.           },
  54.           // ===== 进程资源监控（Base64 解码后）=====
  55.           "process": {
  56.               "uptime": 22.29,                       // 进程已运行 22 秒
  57.               "rss": 391266304,                      // 内存占用 373MB
  58.               "heapTotal": 52228096,                 // 堆总大小 50MB
  59.               "heapUsed": 133928806,                 // 堆已用 128MB
  60.               "external": 88280115,                  // 外部内存 84MB
  61.               "arrayBuffers": 23265130,              // ArrayBuffer 22MB
  62.               "constrainedMemory": 51539607552,      // 受限内存 48GB（你的总内存）
  63.               "cpuUsage": {
  64.                   "user": 1814859,                   // 用户态 CPU 微秒
  65.                   "system": 325661                   // 内核态 CPU 微秒
  66.               },
  67.               "cpuPercent": 3.80                     // CPU 使用率 3.8%
  68.           },
  70.           // ===== 额外元数据（Base64 解码后）=====
  71.           "additional_metadata": {
  72.               "rh": "a1eebab6bdf541b1",             // 你的 Git 仓库 remote hash
  73.               "cache_hits": 2534,                    // 缓存命中次数
  74.               "cache_misses": 6,                     // 缓存未命中次数
  75.               "hit_rate": 0.9976                     // 命中率 99.76%
  76.           }
  77.       }
  78.   }
复制代码
4.3 每个事件附带的元数据
  1. 核心字段:
  2.   session_id          - 会话 ID
  3.   device_id           - 设备 ID（永久）
  4.   account_uuid        - 账户 UUID
  5.   organization_uuid   - 组织 UUID
  6.   subscription_type   - 订阅类型（pro/max/enterprise/team）
  7.   rate_limit_tier     - 速率限制等级
  8.   model               - 使用的模型
  9.   version             - 客户端版本
  10.   platform            - 操作系统
  11.   arch                - CPU 架构
  12.   entrypoint          - 入口点（cli/sdk/bridge）
  13.   is_interactive      - 是否交互模式
  14.   is_ci               - 是否 CI 环境
  16. 环境指纹（env 对象）:
  17.   terminal            - 终端类型
  18.   package_managers     - 包管理器
  19.   runtimes            - 运行时
  20.   is_docker           - Docker 环境
  21.   deployment_env      - 部署环境类型
  22.   linux_distro_*      - Linux 发行版信息
  24. 进程资源（Base64 编码）:
  25.   uptime              - 进程运行时间
  26.   rss                 - 内存占用
  27.   heapUsed            - 堆内存使用
  28.   cpuPercent          - CPU 使用率
复制代码
4.4 Datadog 上报

端点：https://http-intake.logs.us5.datadoghq.com/api/v2/logs
硬编码客户端 Token：pubbbf48e6d78dae54bceaa4acf463299bf
白名单：64 种事件类型
标签化字段（用于后台聚合分析和告警）：
标签说明封号相关性
userBucket用户分组（基于 ID 哈希到 30 个桶）高 - 用户分群
subscriptionType订阅类型极高 - 配额管理
model使用模型高 - 资源消耗
toolName工具名称中 - 行为模式
platform操作系统低
providerAPI 提供商中
version客户端版本中 - 旧版本检测
4.5 GrowthBook 双向数据交换

SDK Key：sdk-zAZezfDKGoZuXXKe（外部用户）
发送给 GrowthBook 的用户属性：
属性说明
idDevice ID
sessionId会话 ID
platform操作系统
organizationUUID组织 ID
accountUUID账户 ID
subscriptionType订阅类型
rateLimitTier速率限制等级
firstTokenTime首次使用时间戳
属性说明
email用户邮箱
appVersion客户端版本
作用：服务端可据此精确控制功能开关、A/B 实验分配，甚至针对特定用户禁用功能。
五、服务端远程控制机制

Anthropic 可通过以下机制远程控制客户端行为，无需用户知情。
5.1 Policy Limits（组织级策略限制）

端点：/api/claude_code/policy_limits
轮询频率：每小时
能力：
    禁用特定工具限制功能访问强制执行组织安全策略
5.2 Remote Managed Settings（远程设置推送）

端点：/api/claude_code/settings
能力：
    远程推送 settings.json 配置修改客户端行为企业治理
5.3 版本强制升级

通过 GrowthBook 配置 tengu_version_config 下发最低版本要求，可强制旧版本用户升级。
5.4 功能标志灰度控制

服务端可通过 GrowthBook 对特定用户/组织：
    关闭特定功能调整速率限制修改采样率启用/禁用 Beta 特性
六、封号触发机制深度分析

6.1 身份关联检测（账号共享）

Claude Code 封号机制深度探查报告 New
检测依据：
    同一 Account UUID 出现在多个 Device ID 上不同 IP、不同操作系统、不同时区的设备使用同一账号短时间内在不同地理位置登录
6.2 速率限制违规

检测链路：
    每次 API 请求上报 tengu_api_success，包含 token 用量和模型服务端按 account_uuid + subscription_type + rate_limit_tier 聚合超出配额阈值 → 429 错误 → 继续违规 → 触发封号
上报的关键指标：
指标说明
inputTokens输入 token 数
outputTokens输出 token 数
cacheReadTokens缓存读取 token
cacheCreationTokens缓存创建 token
costUsd每次请求的美元成本
duration请求耗时
model使用的模型
6.3 内容策略违规

防线 1 - Anti-Distillation：
API 请求中包含 anti_distillation: ["fake_tools"]，检测是否有人用 Claude Code 输出训练竞争模型。
防线 2 - 消息指纹：
从首条消息特定位置提取字符计算指纹，嵌入 Header 和 System Prompt，后端可校验请求完整性。
防线 3 - 额外保护标志：
x-anthropic-additional-protection: true header 可触发服务端更严格的内容审查。
6.4 自动化滥用检测

检测信号来源说明
is_ci: true环境变量 CI标记为 CI 环境
is_github_action: trueGITHUB_ACTIONSGitHub Actions 运行
is_interactive: falseTTY 检测非交互式调用
entrypoint: "sdk"入口点通过 SDK 调用而非 CLI
auto_mode_* 事件自动模式AFK 自动执行模式
风险组合：非交互 + SDK 入口 + 高频调用 + 大量 token 消耗 → 自动化滥用嫌疑
6.5 客户端篡改检测

检测点方法后果
版本指纹cc_version={VER}.{FINGERPRINT}指纹不匹配 → 异常标记
User-Agent格式校验非标准格式 → 可能非官方客户端
Beta Headers预期 header 集合缺失/多余 → 异常
System Prompt包含归因信息篡改 → 检测到
七、完整数据流向全景图

Claude Code 封号机制深度探查报告 New
八、所有外部通信端点汇总

目标URL频率数据内容可禁用
主 APIapi.anthropic.com每次对话对话内容 + 身份 + 元数据不可
1P 事件api.anthropic.com/api/event_logging/batch每 5 秒640+ 事件 + 环境指纹可
Datadogdatadoghq.com每 15 秒64 种事件 + 标签可
GrowthBookapi.anthropic.com每 20 分钟用户属性换功能配置可
OAuthplatform.claude.com登录/刷新Token + 账户信息不可
策略限制api.anthropic.com/api/claude_code/policy_limits每小时组织策略查询可
远程设置api.anthropic.com/api/claude_code/settings后台轮询settings.json 推送可
域名检查api.anthropic.com/api/web/domain_infoWebFetch 前目标域名不可
目标URL频率数据内容可禁用
MCP 代理mcp-proxy.anthropic.comMCP 调用MCP 请求数据不可
版本更新storage.googleapis.com版本检查下载更新包可
Changelograw.githubusercontent.com更新后获取更新日志可
九、自我保护建议

9.1 环境变量防护

环境变量作用
DISABLE_TELEMETRY=1禁用 Datadog + 1P 事件 + 反馈调查
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1禁用所有非必要网络（遥测 + 更新 + GrowthBook）
CLAUDE_CODE_USE_BEDROCK=1使用 AWS Bedrock（自动禁用所有分析）
CLAUDE_CODE_USE_VERTEX=1使用 GCP Vertex（自动禁用所有分析）
9.2 使用注意事项

行为风险建议
多设备共享账号极高每台设备单独订阅
短时间大量 API 调用高控制调用频率
CI/CD 中大规模使用中使用 API Key 而非 OAuth
篡改客户端/伪造 Header高不要修改官方客户端
长期不升级版本低-中跟随官方更新
9.3 关键文件清理

文件/目录内容建议
~/.claude.jsonDevice ID + 账户信息删除 userID 字段可重置设备标识
~/.claude/telemetry/失败的遥测事件缓存定期清理
~/.claude/.credentials.json明文凭证（Keychain 不可用时）确保 Keychain 可用
~/.claude/projects/完整对话历史定期清理敏感会话
十、总结

Claude Code 的数据采集体系可以总结为三层模型：
层级内容目的
身份层Device ID + Account UUID + Email + Fingerprint精确追踪用户
环境层OS + 架构 + 终端 + CI + 容器 + 部署环境构建设备指纹
行为层640+ 事件 + Token 用量 + 工具调用 + 进程资源分析使用模式
这三层数据通过三条通道（1P API + Datadog + GrowthBook）实时上报，服务端拥有对每个用户完整的使用画像，可以从多个维度检测异常并触发封号决策。
最安全的做法：使用 Bedrock/Vertex 第三方提供商（自动禁用所有分析），或设置DISABLE_TELEMETRY=1 + 控制使用频率 + 一人一号。
我要说一句 收起回复
赞赏
回复

使用道具 举报

评论1

IT618发布Lv.8 发表于 昨天 10:58 | 查看全部
这分析纯粹是误导
我要说一句 收起回复
回复 支持 反对

使用道具 举报

返回列表 发布新帖

回复
 懒得打字嘛，点击右侧快捷回复【查看最新发布】   【应用商城享更多资源】
高级模式
B Color Image Link Quote Code Smilies
您需要登录后才可以回帖 登录 | 立即注册

本版积分规则

图文热点
关闭

站长推荐上一条 /1 下一条

最新热评 加载中...
AI智能体

关于我们

关于我们 免责声明 应用市场 下载中心

服务支持

有问必答 优秀站点 常见问题 建站必看
投诉/建议联系

discuzaddons@vip.qq.com

未经授权禁止转载，复制和建立镜像，
如有违反，按照公告处理!!!
  • 联系QQ客服
  • 添加微信客服

联系DZ插件网微信客服|最近更新|Archiver|手机版|小黑屋|DZ插件网! ( 鄂ICP备20010621号-1 )|网站地图 知道创宇云防御

您的IP:216.73.216.27,GMT+8, 2026-4-4 00:56 , Processed in 0.352338 second(s), 73 queries , Gzip On, Redis On.

Powered by Discuz! X5.1 Licensed

© 2001-2026 Discuz! Team.

关灯 在本版发帖
扫一扫添加微信客服
 QQ客服返回顶部
快速回复 返回顶部 返回列表