user data

Claude Code 收集特定的用户数据以提供功能和改进服务。本文档详细说明收集的数据类型和用途。

收集的数据类型

1. 系统信息

操作系统信息

interface SystemInfo {
  platform: string;        // 'darwin' | 'linux' | 'win32'
  arch: string;            // 'x64' | 'arm64'
  osVersion: string;      // 操作系统版本
  nodeVersion: string;    // Node.js 版本
  shell: string;          // 'bash' | 'zsh' | 'fish' | 'powershell'
}

// 收集方式
const systemInfo = {
  platform: process.platform,
  arch: process.arch,
  osVersion: os.release(),
  nodeVersion: process.version,
  shell: process.env.SHELL || 'unknown',
};

用途:

• 平台特定功能适配

• Bug 报告和诊断

• 性能优化

是否发送到服务器: 否（仅本地使用）

工作目录信息

interface WorkspaceInfo {
  cwd: string;              // 当前工作目录
  gitRoot?: string;         // Git 仓库根目录
  hasGit: boolean;          // 是否是 Git 仓库
  projectType?: string;     // 'node' | 'python' | 'rust' 等
}

用途:

• 提供上下文相关的建议

• 工具执行的工作目录

是否发送到服务器: 否（路径信息不发送）

2. 使用数据

命令执行历史

interface CommandHistory {
  command: string;          // 执行的命令
  timestamp: number;        // 时间戳
  success: boolean;         // 是否成功
  duration: number;         // 执行时间（毫秒）
}

// 存储位置
const historyPath = path.join(
  os.homedir(),
  '.claude-code',
  'history',
  'commands.json'
);

用途:

• 命令补全和建议

• 使用模式分析

• 性能优化

是否发送到服务器: 否（仅本地存储）

工具调用统计

interface ToolUsageStats {
  toolName: string;         // 工具名称
  callCount: number;        // 调用次数
  successCount: number;     // 成功次数
  failureCount: number;     // 失败次数
  avgDuration: number;      // 平均执行时间
  lastUsed: number;         // 最后使用时间
}

用途:

• 性能监控

• 功能使用分析

• 优化工具优先级

是否发送到服务器: 是（匿名统计数据）

错误日志

interface ErrorLog {
  timestamp: number;
  errorType: string;        // 错误类型
  errorMessage: string;     // 错误消息（已脱敏）
  stackTrace?: string;      // 堆栈跟踪（已脱敏）
  context: {
    tool?: string;          // 相关工具
    command?: string;       // 相关命令（已脱敏）
  };
}

用途:

• Bug 修复

• 稳定性改进

• 用户支持

是否发送到服务器: 是（可选，需用户同意）

3. 会话数据

对话历史

interface ConversationHistory {
  sessionId: string;
  messages: Message[];      // 对话消息
  createdAt: number;
  updatedAt: number;
}

// 存储位置
const sessionPath = path.join(
  os.homedir(),
  '.claude-code',
  'sessions',
  `${sessionId}.json`
);

用途:

• 会话恢复

• 上下文保持

• 历史搜索

是否发送到服务器: 部分（仅发送当前会话到 Anthropic API）

文件访问记录

interface FileAccessLog {
  path: string;             // 文件路径（已脱敏）
  operation: string;        // 'read' | 'write' | 'delete'
  timestamp: number;
  success: boolean;
}

用途:

• 审计日志

• 安全监控

• 撤销功能

是否发送到服务器: 否（仅本地存储）

4. 配置数据

用户配置

interface UserConfig {
  model: string;            // 使用的模型
  temperature: number;      // 温度参数
  maxTokens: number;        // 最大 token 数
  permissionMode: string;   // 权限模式
  autoCompact: boolean;     // 自动压缩
  theme: string;            // 主题
}

用途:

• 个性化体验

• 功能配置

• 偏好设置

是否发送到服务器: 否（仅本地存储）

扩展配置

interface ExtensionConfig {
  skills: string[];         // 启用的 Skills
  plugins: string[];        // 启用的 Plugins
  mcpServers: MCPServerConfig[];
  hooks: Hook[];
}

用途:

• 扩展管理

• 功能定制

是否发送到服务器: 否（仅本地存储）

5. 性能指标

性能数据

interface PerformanceMetrics {
  startupTime: number;      // 启动时间
  firstResponseTime: number; // 首次响应时间
  toolExecutionTimes: Map<string, number[]>;
  tokenCounts: number[];
  cacheHitRate: number;
  memoryUsage: {
    heapUsed: number;
    heapTotal: number;
  };
}

用途:

• 性能优化

• 问题诊断

• 用户体验改进

是否发送到服务器: 是（匿名统计数据）

数据脱敏

敏感信息过滤

function sanitizeData(data: any): any {
  // 移除 PII
  data = removePII(data);
  
  // 移除路径信息
  data = removePathInfo(data);
  
  // 移除 API 密钥
  data = removeAPIKeys(data);
  
  return data;
}

function removePII(text: string): string {
  return text
    .replace(/\b\d{3}-\d{2}-\d{4}\b/g, '[SSN]')
    .replace(/\b[\w.-]+@[\w.-]+\.\w+\b/g, '[EMAIL]')
    .replace(/\b\d{16}\b/g, '[CREDIT_CARD]')
    .replace(/sk-[a-zA-Z0-9]{48}/g, '[API_KEY]');
}

function removePathInfo(text: string): string {
  return text
    .replace(/\/Users\/[^\/]+/g, '/Users/[USER]')
    .replace(/C:\\Users\\[^\\]+/g, 'C:\\Users\\[USER]')
    .replace(/\/home\/[^\/]+/g, '/home/[USER]');
}

路径哈希

function hashPath(path: string): string {
  // 使用哈希而非原始路径
  return crypto
    .createHash('sha256')
    .update(path)
    .digest('hex')
    .substring(0, 16);
}

数据存储

本地存储位置

~/.claude-code/
├── config.json           # 用户配置
├── sessions/             # 会话历史
│   ├── session-1.json
│   └── session-2.json
├── history/              # 命令历史
│   └── commands.json
├── cache/                # 缓存数据
│   ├── prompts/
│   └── tools/
└── logs/                 # 日志文件
    ├── error.log
    └── usage.log

数据加密

// 敏感数据加密存储
import { encrypt, decrypt } from './crypto';

async function saveSecureData(key: string, data: any): Promise<void> {
  const encrypted = encrypt(JSON.stringify(data), SECRET_KEY);
  await fs.writeFile(getSecurePath(key), encrypted);
}

async function loadSecureData(key: string): Promise<any> {
  const encrypted = await fs.readFile(getSecurePath(key));
  const decrypted = decrypt(encrypted, SECRET_KEY);
  return JSON.parse(decrypted);
}

数据发送

发送到 Anthropic API

// 发送到 Anthropic 的数据
interface APIRequest {
  model: string;
  messages: Message[];      // 当前会话消息
  system: string;           // System Prompt
  tools: ToolDefinition[];  // 工具定义
}

// 不发送的数据
// - 完整文件路径
// - 用户个人信息
// - API 密钥
// - 本地配置

遥测数据（可选）

interface TelemetryData {
  // 匿名使用统计
  toolUsage: {
    [toolName: string]: number;
  };
  
  // 性能指标
  performance: {
    avgStartupTime: number;
    avgResponseTime: number;
  };
  
  // 错误统计
  errors: {
    [errorType: string]: number;
  };
  
  // 不包含任何个人信息
  userId: string;  // 匿名 ID（哈希）
}

用户控制

数据收集级别

{
  "telemetry": {
    "level": "full",  // 'none' | 'minimal' | 'full'
    "errorReporting": true,
    "usageStats": true,
    "performanceMetrics": true
  }
}

禁用数据收集

# 完全禁用遥测
claude-code config set telemetry.level none

# 只禁用错误报告
claude-code config set telemetry.errorReporting false

查看收集的数据

# 查看本地存储的数据
claude-code data show

# 导出数据
claude-code data export --output data.json

# 删除所有数据
claude-code data clear

数据保留

保留期限

• 会话历史: 30 天（可配置）

• 命令历史: 90 天

• 错误日志: 7 天

• 缓存数据: 24 小时

自动清理

async function cleanupOldData(): Promise<void> {
  const now = Date.now();
  const retentionPeriods = {
    sessions: 30 * 24 * 60 * 60 * 1000,  // 30 天
    commands: 90 * 24 * 60 * 60 * 1000,  // 90 天
    errors: 7 * 24 * 60 * 60 * 1000,     // 7 天
    cache: 24 * 60 * 60 * 1000,          // 24 小时
  };
  
  // 清理过期数据
  await cleanupSessions(now - retentionPeriods.sessions);
  await cleanupCommands(now - retentionPeriods.commands);
  await cleanupErrors(now - retentionPeriods.errors);
  await cleanupCache(now - retentionPeriods.cache);
}

隐私保护

GDPR 合规

• ✅ 数据最小化原则

• ✅ 用户同意机制

• ✅ 数据访问权

• ✅ 数据删除权

• ✅ 数据可移植性

数据请求

# 请求数据副本
claude-code privacy export

# 删除所有数据
claude-code privacy delete

# 查看隐私政策
claude-code privacy policy

下一步

• 查看 隐私与安全 的详细措施

• 了解 Anthropic API 的数据传输

• 探索 工具 API 的数据访问