Claude Code usage tracking by LangWatch

LangWatch：全方位 Claude Code 使用追踪与 AI 成本优化平台

在现代 AI 辅助开发的流程中，了解 AI 代理（Agent）的运行成本、性能表现以及 Token 消耗细节至关重要。LangWatch 作为一个专为 AI 团队打造的工程平台，提供了卓越的解决方案，帮助用户精准地追踪 Claude Code 使用情况。无论是个人开发者还是企业级团队，LangWatch 都能将复杂的 AI 交互过程转化为透明、可分析的数据洞察。

什么是 LangWatch Claude Code 使用情况追踪？

LangWatch 是一款领先的 LLM 工程平台，旨在协助开发团队将 AI 成功推向生产环境。通过集成强大的 OpenTelemetry 导出功能，LangWatch 能够无缝对接 Claude Code 的原生数据流。用户只需执行简单的初始化命令，即可开始记录每一个会话（Session）的详细路径，包括模型转弯（Turns）、工具调用、按类别区分的 Token 消耗以及理论成本。

除了 Claude Code，LangWatch 同样支持 Codex、OpenCode、GitHub Copilot、Cursor 以及 Pi。所有的 AI 代理都通过相同的 OTLP 端点导出数据，这意味着用户可以在统一的界面中管理所有的 Token、成本和追踪处理流程。

LangWatch 的核心功能 (Features)

1. 精准的 Token 核算与缓存命中追踪

LangWatch 在 Token 计费方面达到了极高的精度。它能够识别每一条 Span（跨度）中的 Token 类别，并将缓存读取（Cache Reads）与缓存写入（Cache Writes）作为独立的类别进行处理。特别是在长期的 AI 代理会话中，缓存读取通常占据了大部分容量，LangWatch 的细分追踪（包括 5 分钟和 1 小时 TTL 写入拆分）能确保成本计算不被误导。

2. 理论成本与计费分析

对于使用 Claude 订阅计划（如 Pro、Max 或 Team 计划）的用户，通常没有每 Token 的实际发票。LangWatch 为此引入了“Bundled”标签，并根据 API 列表价格计算理论总成本。这让用户能够清晰地看到：如果不在订阅计划内，这些使用量在 API 上会花费多少钱。

3. 工具、技能与 MCP 深度追踪

每一条 Bash 命令、文件编辑、技能调用以及 **MCP（Model Context Protocol）**调用都会被记录为一个带有持续时间的 Span。LangWatch 不仅记录执行时长，还记录完整的输入与输出细节，方便用户复盘 AI 的每一个决策过程。

4. LangWatch MCP：让 Claude 自我优化

通过内置的 MCP 服务器，LangWatch 将追踪数据暴露给 AI 代理本身。Claude Code 可以查询上周的运行记录，分析 Token 的流向，发现流程中的摩擦点，从而主动编辑和改进自己的工作流。

5. 动态图表与可视化分析

用户可以将追踪过程中的任何指标转化为图表。无论是并行运行的会话数、每个会话的成本，还是 AI 等待用户回复的空闲时间，LangWatch 都能通过可视化手段展示性能瓶颈。

6. 隐私保护与 PII 脱敏

LangWatch 高度重视数据安全。在追踪过程中，API 密钥会自动被重定向且永不存储。同时，平台具备 PII（个人可识别信息）检测与脱敏功能，确保敏感信息不会出现在追踪历史中。对于更高要求的企业，还提供本地部署（Self-hosted）选项。

如何使用 LangWatch (How to Use)

开始使用 LangWatch 追踪 Claude Code 极其简单，只需以下几个步骤：

1. 启动追踪：在您的终端执行以下命令：

   npx langwatch claude

2. 自动配置：该命令会配置 Claude Code 的原生 OpenTelemetry 导出功能至 LangWatch 平台。
3. 查看数据：一旦运行，每个会话都会作为 Trace 记录在 LangWatch UI 中。您可以实时查看：
   • Trace 摘要：包括模型（如 claude-opus-4-8）、时长、Tokens 数量及成本。
   • 瀑布流与火焰图：详细分析每个步骤的耗时。
   • 输入输出详情：检查每一行代码改动或 Bash 执行结果。

应用场景 (Use Case)

• 成本审计：团队管理者可以通过 LangWatch 监控整个开发团队在 Claude Code 上的虚拟支出，从而进行预算评估。
• 调试与复盘：当 AI 代理出现错误（如 Migration 顺序错误）时，开发者可以查看完整的 Trace 历史，追踪具体是哪一步工具调用导致了失败。
• 性能优化：通过分析缓存命中率和 Token 分布，优化提示词结构，减少不必要的 Token 消耗。
• 合规性监控：通过内置的 Presidio PII 检测，确保开发过程中没有泄露敏感的客户数据。

常见问题 (FAQ)

Q: 如何追踪我的 Claude Code 使用情况？ A: 运行 npx langwatch claude。它会利用 OpenTelemetry 技术将您的本地会话数据发送至 LangWatch 平台，无论您更换到哪台机器，数据都能持久保存并跨设备同步。

Q: 它是否支持 Cursor 或 Copilot？ A: 是的。Codex、OpenCode、Copilot、Cursor 和 Pi 都可以通过相同的 OTLP 端点进行追踪，并在 LangWatch 中以统一的格式呈现。

Q: “Bundled”成本标签是什么意思？ A: 这是一个理论成本指标。由于 Claude 订阅用户不按 Token 付费，LangWatch 使用 API 列表价计算出这些会话的等值成本，帮助您衡量其价值。

Q: 缓存的 Token 会被计算吗？ A: 会。LangWatch 将缓存读取和写入作为独立类别计费。这对于准确评估长会话成本至关重要，因为简单的输入统计往往会忽略缓存带来的显著成本差异。

Q: 如果我不小心在会话中输入了密钥怎么办？ A: LangWatch 拥有自动红线过滤机制。API 密钥和个人隐私信息（PII）会被自动识别并脱敏，确保数据存储的安全性。企业用户还可以选择更严格的治理策略或自托管方案。