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

**URL:** <https://www.sunai.net/t/topic/1376>\
**Category:** IT\
**Tags:** 开源, ai, openclaw, 编程\
**Created:** [2026 年4 月 8 日 08:37 UTC](https://www.sunai.net/t/topic/1376 "2026-04-08T08:37:50Z")\
**Posts on this page:** 1\
**Page:** 1

<div class="post-metadata">

作者： ![Logos](https://www.sunai.net/user_avatar/www.sunai.net/logos/32/2077_2.png) [@Logos](https://www.sunai.net/u/Logos)\
发布日期： [2026 年4 月 8 日 08:37 UTC](https://www.sunai.net/t/topic/1376/1 "2026-04-08T08:37:50Z")

</div>

> From: [GitHub - ultraworkers/claw-code: The repo is finally unlocked. enjoy the party! The fastest repo in history to surpass 100K stars ⭐. Join Discord: https://discord.gg/5TUQKqFWd Built in Rust using oh-my-codex. · GitHub](https://github.com/instructkr/claude-code)  
> 原文: [https://bytedance.sg.larkoffice.com/docx/QNsIdi8VFoKm00xY8SRlkXxygve](https://bytedance.sg.larkoffice.com/docx/QNsIdi8VFoKm00xY8SRlkXxygve)

# 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 ID | `randomBytes(32).toString('hex')` | `~/.claude.json` | **永久** ，除非手动删除 |
| Account UUID | OAuth 登录时服务端下发 | `~/.claude.json` | 绑定账号 |
| Organization UUID | OAuth 登录时下发 | 同上 | 绑定组织 |
| Session ID | `randomUUID()` 每次会话生成 | 内存 | 单次会话 |
| Email | OAuth 或 `git config user.email` | 同上 | 绑定身份 |

Device ID 是 256 位随机值，首次运行时生成并 **永久存储** 。它是所有事件上报的核心标识，Anthropic 可通过它精确关联同一设备上的所有活动。

### 2.2 消息内容指纹（Fingerprint）

源码位置：`src/utils/fingerprint.ts`

```auto
算法：SHA256( "59cf53e54c78" + 首条消息[4] + 首条消息[7] + 首条消息[20] + 版本号 )[:3]

```

这个 3 字符指纹被嵌入到：

- HTTP Header `x-anthropic-billing-header` 的 `cc_version` 字段

- System Prompt 中

**用途推测** ：后端可通过此指纹 **校验请求来源合法性** ，检测是否有人使用非官方客户端伪造请求。

### 2.3 每次 API 请求携带的身份信息

```auto
HTTP Headers:
  x-app: cli
  User-Agent: claude-cli/2.x.x (external, cli)
  X-Claude-Code-Session-Id: {SESSION_UUID}
  x-anthropic-billing-header: cc_version=2.x.x.{FINGERPRINT}; cc_entrypoint=cli
  x-client-request-id: {REQUEST_UUID}

Request Body metadata:
  user_id: JSON 编码的 Device ID + Account UUID + Session ID

```

* * *

## 三、环境指纹采集（40+ 维度）

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

### 3.1 系统级信息

| 采集维度 | 数据来源 | 示例值 |
| --- | --- | --- |
| 操作系统 | `process.platform` | darwin/linux/win32 |
| CPU 架构 | `process.arch` | x64/arm64 |
| Node.js 版本 | `process.version` | v20.x.x |
| Linux 发行版 | `/etc/os-release` | ubuntu 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/EC2

- GCP Cloud Run

- Azure 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 origin` | SHA256 哈希取前 16 字符 |

### 3.4 GitHub Actions 专项采集

在 CI 环境中，额外采集：

| 字段 | 内容 |
| --- | --- |
| `GITHUB_ACTOR_ID` | 触发者 ID |
| `GITHUB_REPOSITORY_ID` | 仓库 ID |
| `GITHUB_REPOSITORY_OWNER_ID` | 仓库所有者 ID |
| `GITHUB_EVENT_NAME` | 事件类型 |
| `RUNNER_ENVIRONMENT` | Runner 环境 |
| `RUNNER_OS` | Runner 操作系统 |

* * *

## 四、遥测上报系统

### 4.1 三路并发上报架构

暂时无法在飞书文档外展示此内容

### 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_*` | 自动模式使用 | 中 - 自动化检测 |

实际数据:

```auto
 {
      // ===== 事件头 =====
      "event_type": "ClaudeCodeInternalEvent", // 事件大类

      "event_data": {
          // ===== 事件基础信息 =====
          "event_name": "tengu_config_cache_stats", // 事件名：配置缓存统计
          "event_id": "ed1cae38-01a8-44dd-...", // 事件唯一 ID
          "client_timestamp": "2026-03-22T10:26:10.747Z", // 客户端时间戳

          // ===== 用户身份标识（核心追踪字段）=====
          "device_id": "eab29b910fcc91bxxxxxxxxx8f3c3e6d53d06",
                                                     // 你的永久设备 ID（256 位）
          "session_id": "8c503d21-2d92-...", // 本次会话 ID
          "email": "xxx@gmail.com", // 你的邮箱（直接明文上报）
          "auth": {
              "organization_uuid": "b2c3112d-...", // 组织 UUID
              "account_uuid": "7616b4d3-..." // 账户 UUID
          },

          // ===== 客户端信息 =====
          "model": "claude-opus-4-6[1m]", // 使用的模型
          "user_type": "external", // 用户类型（非内部员工）
          "entrypoint": "cli", // 入口点
          "is_interactive": true, // 交互模式
          "client_type": "cli", // 客户端类型
          "betas": "claude-code-20250219,oauth-2025-04-20,...", // 启用的 Beta 特性

          // ===== 环境指纹（50+ 维度）=====
          "env": {
              "platform": "darwin", // macOS
              "platform_raw": "darwin", // 原始平台
              "arch": "arm64", // Apple Silicon
              "node_version": "v24.3.0", // Node.js 版本
              "terminal": "tmux", // 终端类型
              "package_managers": "npm,pnpm", // 安装了哪些包管理器
              "runtimes": "deno,node", // 安装了哪些运行时
              "is_running_with_bun": true, // 是否用 Bun 运行
              "is_ci": false, // 非 CI 环境
              "is_claubbit": false,
              "is_github_action": false, // 非 GitHub Actions
              "is_claude_code_action": false,
              "is_claude_ai_auth": true, // 使用 Claude.ai OAuth 认证
              "is_claude_code_remote": false, // 非远程模式
              "is_conductor": false,
              "is_local_agent_mode": false,
              "deployment_environment": "unknown-darwin",
              "version": "2.1.81", // Claude Code 版本
              "version_base": "2.1.81",
              "build_time": "2026-03-20T21:26:18Z", // 构建时间
              "vcs": "git" // 版本控制系统
          },

          // ===== 进程资源监控（Base64 解码后）=====
          "process": {
              "uptime": 22.29, // 进程已运行 22 秒
              "rss": 391266304, // 内存占用 373MB
              "heapTotal": 52228096, // 堆总大小 50MB
              "heapUsed": 133928806, // 堆已用 128MB
              "external": 88280115, // 外部内存 84MB
              "arrayBuffers": 23265130, // ArrayBuffer 22MB
              "constrainedMemory": 51539607552, // 受限内存 48GB（你的总内存）
              "cpuUsage": {
                  "user": 1814859, // 用户态 CPU 微秒
                  "system": 325661 // 内核态 CPU 微秒
              },
              "cpuPercent": 3.80 // CPU 使用率 3.8%
          },

          // ===== 额外元数据（Base64 解码后）=====
          "additional_metadata": {
              "rh": "a1eebab6bdf541b1", // 你的 Git 仓库 remote hash
              "cache_hits": 2534, // 缓存命中次数
              "cache_misses": 6, // 缓存未命中次数
              "hit_rate": 0.9976 // 命中率 99.76%
          }
      }
  }

```

### 4.3 每个事件附带的元数据

```auto
核心字段:
  session_id - 会话 ID
  device_id - 设备 ID（永久）
  account_uuid - 账户 UUID
  organization_uuid - 组织 UUID
  subscription_type - 订阅类型（pro/max/enterprise/team）
  rate_limit_tier - 速率限制等级
  model - 使用的模型
  version - 客户端版本
  platform - 操作系统
  arch - CPU 架构
  entrypoint - 入口点（cli/sdk/bridge）
  is_interactive - 是否交互模式
  is_ci - 是否 CI 环境

环境指纹（env 对象）:
  terminal - 终端类型
  package_managers - 包管理器
  runtimes - 运行时
  is_docker - Docker 环境
  deployment_env - 部署环境类型
  linux_distro_* - Linux 发行版信息

进程资源（Base64 编码）:
  uptime - 进程运行时间
  rss - 内存占用
  heapUsed - 堆内存使用
  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` | 操作系统 | 低 |
| `provider` | API 提供商 | 中 |
| `version` | 客户端版本 | 中 - 旧版本检测 |

### 4.5 GrowthBook 双向数据交换

**SDK Key** ：`sdk-zAZezfDKGoZuXXKe`（外部用户）

**发送给 GrowthBook 的用户属性** ：

| 属性 | 说明 |
| --- | --- |
| `id` | Device 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 身份关联检测（账号共享）

暂时无法在飞书文档外展示此内容

**检测依据** ：

- 同一 Account UUID 出现在多个 Device ID 上

- 不同 IP、不同操作系统、不同时区的设备使用同一账号

- 短时间内在不同地理位置登录

### 6.2 速率限制违规

**检测链路** ：

1. 每次 API 请求上报 `tengu_api_success`，包含 token 用量和模型

2. 服务端按 `account_uuid` + `subscription_type` + `rate_limit_tier` 聚合

3. 超出配额阈值 → 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: true` | `GITHUB_ACTIONS` | GitHub Actions 运行 |
| `is_interactive: false` | TTY 检测 | 非交互式调用 |
| `entrypoint: "sdk"` | 入口点 | 通过 SDK 调用而非 CLI |
| `auto_mode_*` 事件 | 自动模式 | AFK 自动执行模式 |

**风险组合** ：非交互 + SDK 入口 + 高频调用 + 大量 token 消耗 → 自动化滥用嫌疑

### 6.5 客户端篡改检测

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

* * *

## 七、完整数据流向全景图

暂时无法在飞书文档外展示此内容

* * *

## 八、所有外部通信端点汇总

| 目标 | URL | 频率 | 数据内容 | 可禁用 |
| --- | --- | --- | --- | --- |
| 主 API | `api.anthropic.com` | 每次对话 | 对话内容 + 身份 + 元数据 | 不可 |
| 1P 事件 | `api.anthropic.com/api/event_logging/batch` | 每 5 秒 | 640+ 事件 + 环境指纹 | 可 |
| Datadog | `datadoghq.com` | 每 15 秒 | 64 种事件 + 标签 | 可 |
| GrowthBook | `api.anthropic.com` | 每 20 分钟 | 用户属性换功能配置 | 可 |
| OAuth | `platform.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_info` | WebFetch 前 | 目标域名 | 不可 |

| 目标 | URL | 频率 | 数据内容 | 可禁用 |
| --- | --- | --- | --- | --- |
| MCP 代理 | `mcp-proxy.anthropic.com` | MCP 调用 | MCP 请求数据 | 不可 |
| 版本更新 | `storage.googleapis.com` | 版本检查 | 下载更新包 | 可 |
| Changelog | `raw.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.json` | Device 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` + 控制使用频率 + 一人一号。