什么是 Claude 代码监视器？

Claude Code 现在可以通过 OpenTelemetry 开箱即用地导出丰富的遥测数据——这是官方的、与供应商无关的方式，可以监控您的代理编码会话产生的所有内容。

• Tokens使用 （输入、输出、缓存创建、缓存读取）
• 成本估算 （实时和预测）
• 工具活动 （文件编辑、命令执行、git 操作、浏览器使用）
• 后台任务和持久会话 （/任务（长期代理人）
• 生产力指标 （已接受的代码行数，建议采纳率）

与之前基于 JSONL 的本地社区仪表盘不同，官方 OTel 支持无需任何自定义代码即可提供企业级可观测性。Claude Code 代理现在可以自主运行数小时甚至数天——如果没有监控，您可能会面临意外账单、进度丢失或速率限制等问题。

// OpenTelemetry Collector 数据流——Claude Code 官方监控架构的骨干

// 实时 Claude Code 会话监视器（终端 + 多会话视图）

分步设置指南

使用这些环境变量启动 Claude Code。添加到您的 ~/.zshrc 或者 ~/.bashrc 为了持久性：

export CLAUDE_CODE_ENABLE_TELEMETRY=1 export OTEL_METRICS_EXPORTER=otlp export OTEL_LOGS_EXPORTER=otlp export OTEL_TRACES_EXPORTER=otlp export OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4317 # 指向您的采集器 export OTEL_EXPORTER_OTLP_PROTOCOL=grpc export OTEL_METRIC_EXPORT_INTERVAL=10000 # 10 秒以获得实时感

重启终端并运行 Claude — 遥测数据现在将自动传输。

创建一个项目文件夹，然后这样做 docker-compose.yml：

版本：'3.8' 服务：otel-collector：镜像：otel/opentelemetry-collector-contrib:latest 命令：["--config", "/etc/otel/config.yaml"] 卷：- ./otel-config.yaml:/etc/otel/config.yaml 端口：- "4317:4317" # gRPC - "4318:4318" # HTTP 依赖：- prometheus prometheus：镜像：prom/prometheus:latest 端口：- "9090:9090" 卷：- ./prometheus.yml:/etc/prometheus/prometheus.yml grafana：镜像：grafana/grafana:latest 端口：- "3000:3000" 环境：- GF_SECURITY_ADMIN_PASSWORD=admin 依赖：- prometheus

otel-config.yaml （简洁而强大）：

接收器：otlp：协议：grpc：http：处理器：批处理：导出器：prometheus：端点：“0.0.0.0:9464”日志记录：服务：管道：指标：接收器：[otlp] 处理器：[批处理] 导出器：[prometheus] 日志：接收器：[otlp] 处理器：[批处理] 导出器：[日志记录]

prometheus.yml：

scrape_configs: - job_name: 'otel-collector' static_configs: - targets: ['otel-collector:9464']

docker compose up -d

1. 打开 http://localhost:3000 → 登录（admin/admin）
2. 添加 Prometheus 数据源（URL： http://prometheus:9090）
3. 导入或创建包含以下关键查询的仪表板

您将立即看到Tokens销毁、成本曲线和代理健康状况的精美图表。

// 完整的可观测性管道：Claude Code → OTel Collector → Prometheus → Grafana

今天你可以追踪的关键指标

• 实时Tokens消耗 缓存命中率
• 成本预测 距离达到极限还有几个小时
• 背景代理状态 （/任务 观看次数 + 持续时间）
• 生产力投资回报率 （可接受的代码行数与节省的时间）
• 异常警报 （Tokens数量突然激增 = 潜在的失控代理）

高级：成本优化 + 多模型策略

一旦您清楚地了解您的 Claude Code 消费都花在了哪里，下一步就是智能路由。

提示： 使用统一的 OneAPI 平台作为智能后端。将复杂的推理任务路由至 Claude Code（通过 OTel 监控）。将高容量或重复性任务路由至更经济的模型（Gemma 4、MAI、Hermes 等）。

• 内置使用情况日志和成本仪表盘
• 自动回退和负载均衡
• 零保留隐私选项

结果：成本降低 30-60%，同时保持完全透明。

常见问题及故障排除