Blog destacado

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.

10/04/2026
Tutorial oficial · 2026
Claude Code Monitor · Configuración de OpenTelemetry
Última actualización: 10 de abril de 2026
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.

// Requisitos previos
Claude Code CLI v2.x+
Docker (para la pila Compose)
Conocimientos básicos sobre variables de entorno
Opcional: Grafana Cloud (plan gratuito)

¿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.

Panel de control del flujo de datos de OpenTelemetry Collector: la columna vertebral de la arquitectura de monitorización oficial de Claude Code.

// 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: vista de terminal y multisesión con acceso mediante código QR.

// 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:

bash · configuración de entorno
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.

Paso 02 — Implementar OTel Collector + Prometheus + Grafana

Crea una carpeta de proyecto y esto docker-compose.yml:

yaml · 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):

yaml · otel-config.yaml
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:

yaml · prometheus.yml
scrape_configs: - job_name: 'otel-collector' static_configs: - targets: ['otel-collector:9464']
bash · lanzar
docker compose up -d
Paso 3: Crea tu primer panel de control de Grafana.
  1. Abierto http://localhost:3000 → Iniciar sesión (admin/admin)
  2. Agregar fuente de datos de Prometheus (URL: http://prometheus:9090)
  3. 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 a OTel Collector a Prometheus a Grafana

// 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 (/tareas vista + 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

¿Esto funciona para los usuarios del plan gratuito?

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.

¿Puedo supervisar las tareas en segundo plano?

Absolutamente. El /tareas El comando + OTel te proporciona el estado en tiempo real de cada agente autónomo que se ejecuta en segundo plano.

¿Preocupaciones sobre la privacidad?

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.

¿Necesitas paneles de control empresariales?

Consulta el repositorio de la guía de monitorización oficial de Anthropic para obtener plantillas listas para usar de Docker Compose y Grafana.

// Nunca más te sorprenderá una factura de Claude

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

Más de 300 modelos de IA para
OpenClaw y agentes de IA

Ahorre un 20% en costos