Tutorial de Claude Code Monitor 2026: Configuración oficial de OpenTelemetry para el seguimiento en tiempo real de tokens, costes y tareas en segundo plano.
Fuente: Documentos oficiales de Anthropic
Claude Code Monitor:
OpenTelemetría
Anthropic acaba de hacer que Claude Code esté mucho más listo para la producción con funciones nativas. OpenTelemetry (OTel) Compatibilidad con la monitorización. Tanto si ejecutas agentes autónomos de larga duración, tareas en segundo plano en modo automático o flujos de trabajo de codificación a escala empresarial, las nuevas funciones de monitorización oficiales te permiten realizar un seguimiento del consumo de tokens, los costes estimados, la actividad de las herramientas y el estado de la sesión en tiempo real, sin depender de herramientas comunitarias dispersas.
¿Qué es Claude Code Monitor?
Ahora, Claude Code exporta datos de telemetría detallados de forma predeterminada a través de OpenTelemetry, la forma oficial e independiente del proveedor para monitorear todo lo que producen tus sesiones de codificación con agentes.
- Uso del token (entrada, salida, creación de caché, lectura de caché)
- Estimaciones de costos (en tiempo real y predictivo)
- Actividad de la herramienta (edición de archivos, ejecución de comandos, operaciones con Git, uso del navegador)
- Tareas en segundo plano y sesiones persistentes (
/tareas(agentes de larga trayectoria) - Métricas de productividad (líneas de código aceptadas, tasa de aceptación de sugerencias)
A diferencia de los paneles de control comunitarios locales basados en JSONL anteriores, el soporte oficial de OTel ofrece una observabilidad de nivel empresarial sin necesidad de código personalizado. Los agentes de Claude Code ahora funcionan de forma autónoma durante horas o días; sin supervisión, se corre el riesgo de recibir facturas inesperadas, perder el progreso o superar los límites de velocidad.

// Flujo de datos del recopilador de OpenTelemetry: la columna vertebral de la arquitectura de monitorización oficial de Claude Code.

// Monitor de sesiones de Claude Code en tiempo real (terminal + vista de múltiples sesiones)
Guía de configuración paso a paso
Paso 01: Habilitar la telemetría en el código Claude.Inicie Claude Code con estas variables de entorno. Añada a su ~/.zshrc o ~/.bashrc para la permanencia:
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 # Apunta a tu Collector export OTEL_EXPORTER_OTLP_PROTOCOL=grpc export OTEL_METRIC_EXPORT_INTERVAL=10000 # 10 segundos para una sensación en tiempo real
Reinicia tu terminal y ejecuta Claude — La telemetría se transmitirá automáticamente.
Crea una carpeta de proyecto y esto docker-compose.yml:
versión: '3.8' servicios: otel-collector: imagen: otel/opentelemetry-collector-contrib:latest comando: ["--config", "/etc/otel/config.yaml"] volúmenes: - ./otel-config.yaml:/etc/otel/config.yaml puertos: - "4317:4317" # gRPC - "4318:4318" # HTTP depende_de: - prometheus prometheus: imagen: prom/prometheus:latest puertos: - "9090:9090" volúmenes: - ./prometheus.yml:/etc/prometheus/prometheus.yml grafana: imagen: grafana/grafana:latest puertos: - "3000:3000" entorno: - GF_SECURITY_ADMIN_PASSWORD=admin depende_de: - prometheus
otel-config.yaml (minimalista pero potente):
receptores: otlp: protocolos: grpc: http: procesadores: batch: exportadores: prometheus: endpoint: "0.0.0.0:9464" logging: servicio: pipelines: métricas: receptores: [otlp] procesadores: [batch] exportadores: [prometheus] registros: receptores: [otlp] procesadores: [batch] exportadores: [logging]
prometeo.yml:
scrape_configs: - job_name: 'otel-collector' static_configs: - targets: ['otel-collector:9464']
docker compose up -d
- Abierto http://localhost:3000 → Iniciar sesión (admin/admin)
- Agregar fuente de datos de Prometheus (URL: http://prometheus:9090)
- Importa o crea un panel de control con las siguientes consultas clave.
| Métrico | Consulta de Prometeo | Lo que muestra |
|---|---|---|
| Uso del token | suma por (modelo) (total de tokens de código de claude) | Desglose de entrada/salida/caché |
| Costo estimado | suma por (modelo) (claude_code_estimated_cost_usd) | Tasa de consumo de dólares en tiempo real |
| Sesiones activas | claude_code_sesiones_activas | recuento de tareas en segundo plano |
| Llamadas a herramientas | claude_code_tool_calls_total | Edición de archivos, comandos, etc. |
| Costo por hora | aumentar(claude_code_estimated_cost_usd[1h]) | Alertas predictivas |
Verás al instante gráficos muy claros sobre la quema de tokens, las curvas de costes y el estado de los agentes.

// Pipeline de observabilidad completo: Claude Code → OTel Collector → Prometheus → Grafana
Indicadores clave que puede monitorear hoy
- Consumo de tokens en tiempo real con tasa de aciertos de caché
- Previsión de costes — horas hasta que alcances tu límite
- Antecedentes Estado del agente (
/tareasvista + duración) - Retorno de la inversión en productividad (líneas de código aceptadas frente al tiempo ahorrado)
- Alertas de anomalías (Picos repentinos en el número de tokens = agente potencialmente descontrolado)
Avanzado: Optimización de costes + Estrategia multimodelos
Una vez que sepa exactamente a dónde va su gasto con Claude Code, el siguiente paso es el enrutamiento inteligente.
Para obtener un consejo: Utilice una plataforma unificada OneAPI como backend inteligente. Dirija el razonamiento complejo hacia Claude Code (supervisado mediante OTel). Dirija las tareas repetitivas o de alto volumen hacia modelos más económicos (Gemma 4, MAI, Hermes, etc.).
- Registro de uso y paneles de control de costes integrados.
- Conmutación automática y equilibrio de carga
- Opciones de privacidad sin retención
Resultado: Costes entre un 30 % y un 60 % más bajos manteniendo una visibilidad total.
Preguntas frecuentes y solución de problemas
Sí, la telemetría está disponible en todos los planes, aunque las métricas de costes son más detalladas en los planes de pago.
Absolutamente. El /tareas El comando + OTel te proporciona el estado en tiempo real de cada agente autónomo que se ejecuta en segundo plano.
Todos los datos permanecen en tu recopilador; no se envía nada a Anthropic más allá de lo que ya envías para la inferencia.
Consulta el repositorio de la guía de monitorización oficial de Anthropic para obtener plantillas listas para usar de Docker Compose y Grafana.
Toma el control del uso de tu código Claude.
Claude Code Monitor, a través de OpenTelemetry, transforma tus sesiones de codificación con agentes, de una caja negra a un sistema totalmente observable y con control de costes. Combínalo con OneAPI: más de 300 modelos de vanguardia y de código abierto, monitorización integrada, enrutamiento inteligente y paneles de control de uso transparentes.
Pruebe OneAPI gratis en www.ai.ccÚltima actualización: 10 de abril de 2026 · Fuentes: Documentación oficial del Código Claude de Anthropic y guía de monitorización del código claude


Acceso













