结论先说
- 个人自查用
/cost和/status,团队汇总用官方内置的 OpenTelemetry(OTel)原生导出,不需要外挂抓包代理。 - 注意
/cost的适用范围:按 API 计费(Console / 云厂商网关)登录时,/cost会展示精确的本次会话折算花费、输入输出及缓存命中明细;使用 Pro 或 Max 订阅登录时,配额按滚动窗口结算,应在/status或网页端用量页查看进度比例。 - 默认必须显式打开
CLAUDE_CODE_ENABLE_TELEMETRY=1总开关才会外发监控数据,支持标准的otlp(gRPC 或 HTTP)协议直推内网 Collector。 - 隐私保护默认安全:即便开启了日志事件导出,官方默认也不记录用户的原始提示词文本(只记字符长度等元数据),避免敏感需求描述意外落入运维日志库。

图:本站根据 Claude Code 官方文档 Monitoring usage 整理的示意图
本文根据 Claude Code 官方文档《Monitoring usage》《Manage costs effectively》整理,核对日期 2026-11-18。配图为本站整理的示意图,不是界面截图。本站(bigolab.com)不是 Anthropic 官方网站。
适用于谁
- 搜「claude code 监控用量」「claude code opentelemetry」「claude code /cost 怎么看」的研发负责人与平台工程师;
- 给几十名研发分配了 API 密钥或团队席位后,想在公司自建的 Prometheus、Grafana 或 Datadog 里统计各模型消耗、代码采纳率与异常大额会话的管理员;
- 担心开启监控会把员工输入的业务源码和提示词明文传进日志系统的安全负责人。
如果你只关心在自己终端底部常驻显示当前上下文进度条,可以先看 /guides/claude-code-statusline-model-context-usage。
一、个人日常自查:看懂 /cost 里的缓存读写比例
单兵开发排错时,在交互会话里敲 /cost,除了总消耗数字外,最值得盯紧的是缓存创建(Cache write)与缓存读取(Cache read)的比例:
- 健康的同一模型长会话里,绝大多数输入 Token 应该落在折扣极高的「缓存读取」一栏;
- 如果你发现每一轮都在大量触发昂贵的「缓存写入」,往往说明你中途频繁切换模型,或者开了过多生命周期极短的独立子代理(控费优化见 /guides/multi-agent-token-cost-why-high-how-to-control)。
二、团队级监控:四步接入标准 OpenTelemetry 采集端
当团队超过五个人时,官方推荐通过 settings.json(层级与托管下发机制见 /guides/claude-code-settings-json 与 /guides/claude-code-team-collaboration-shared-config)统一配置环境变量,把遥测信号推往你们内网自己的 OpenTelemetry Collector。

图:本站根据 Claude Code 官方文档 Monitoring usage 整理的示意图
在用户级或组织级托管 settings.json 的 env 块中写入:
json
{
"env": {
"CLAUDE_CODE_ENABLE_TELEMETRY": "1",
"OTEL_METRICS_EXPORTER": "otlp",
"OTEL_LOGS_EXPORTER": "otlp",
"OTEL_EXPORTER_OTLP_PROTOCOL": "grpc",
"OTEL_EXPORTER_OTLP_ENDPOINT": "http://otel-collector.example.internal:4317",
"OTEL_RESOURCE_ATTRIBUTES": "department=backend,team=checkout"
}
}
如果只在本机终端验证数据结构,不用搭后端服务,直接把 OTEL_METRICS_EXPORTER 临时设成 "console",指标就会打印在终端标准输出里供你核对字段。
三、看板最该盯哪几项核心官方指标
连接成功后,Claude Code 会定时上报两类核心数据流——时序指标(Metrics)与结构化事件(Logs/Events):
- 成本与用量核心指标:
claude_code.token.usage:带type(input、output、cacheRead、cacheCreation)和model标签,一眼看出是不是全员连简单搜索都在烧顶级模型;claude_code.cost.usage:按模型统计预估 API 开销趋势;claude_code.session.count与活跃时长:评估团队真实使用频率,识别闲置账号;
- 产出与采纳指标:
claude_code.lines_of_code.count(区分新增与删除行数)、创建的提交与 Pull Request 数量,以及工具权限弹窗的批准/拒绝统计,帮助工程效能团队量化真实提效情况。
对于没有自建运维监控基础设施的小团队或高频独立开发者,如果只是担心 API 按量计费波动不可控,直接采用固定周期限额的个人订阅(如 /chongzhi/claude-max 或 Pro 方案)在预算封顶上会更直观省事。
常见问题
Q:开启 OTEL_LOGS_EXPORTER=otlp 后,员工在对话框里贴的代码片段会被发进日志系统吗?
按官方隐私说明,默认状态下用户输入的提示词正文(Prompt content)是脱敏屏蔽的,事件里只保留提示词长度等统计字段;只有当企业出于严格合规留痕需求,由管理员显式额外设置 OTEL_LOG_USER_PROMPTS=1 时才会记录原文。
Q:配好了环境变量,为什么在 Grafana 里要等一分多钟才看到点?
OpenTelemetry SDK 默认的指标批量上报间隔较长(常见默认为 60 秒)以减少网络请求开销。在测试联调阶段想立刻看到数据,可以临时加上 "OTEL_METRIC_EXPORT_INTERVAL": "10000"(10 秒导出一次),上线后再改回默认周期。
Q:怎么防止员工在自己电脑上手动改设置把团队遥测开关关掉?
企业管理员可将上述环境变量写入系统级受控目录的托管设置文件(Managed settings.json),托管层级的优先级高于个人用户目录与项目目录配置,普通会话无法覆盖关闭。
相关教程
- /guides/claude-code-settings-json:
settings.json各层级优先级与托管下发配置 - /guides/claude-code-team-collaboration-shared-config:Claude Code 团队协作统一配置指南
- /guides/multi-agent-token-cost-why-high-how-to-control:多代理 Token 膨胀排查与缓存省钱技巧
- /guides/claude-code-statusline-model-context-usage:在状态栏实时显示模型与上下文占用
参考资料
- Claude Code 官方文档:Monitoring usage (OpenTelemetry) — https://code.claude.com/docs/en/monitoring-usage
- Claude Code 官方文档:Manage costs effectively — https://code.claude.com/docs/en/costs
0 条评论
还没有评论,来抢沙发~