OpenAI - ChatGPT, Sora
Google - Gemini, Nano Banana
Antrópico - Claude
xAI - Grok
Busca profunda
Alibaba - Qwen
ByteDance - O Melhor da ByteDance
Todos os modelos
Planos Empresariais
Desenvolvimento de aplicações de IA
API de tradução de IA
Serviço de SEO/GEO com IA
Serviço de Relações Públicas Otimizado por Geolocalização
Serviço de Web Scraping
OpenClaw
Principais ferramentas de IA
Os melhores robôs de IA
Conecte-se
Tutorial do Claude Code Monitor 2026: Configuração oficial do OpenTelemetry para rastreamento em tempo real de tokens, custos e tarefas em segundo plano.
Fonte: Documentos Oficiais da Anthropic
Monitor de código Claude:
Telemetria aberta
A Anthropic acaba de tornar o Claude Code muito mais pronto para produção com recursos nativos. Telemetria Aberta (OTel) Suporte para monitoramento. Seja para executar agentes autônomos de longa duração, tarefas em segundo plano no Modo Automático ou fluxos de trabalho de codificação em escala empresarial, os novos recursos oficiais de monitoramento permitem acompanhar o consumo de tokens, custos estimados, atividade da ferramenta e integridade da sessão em tempo real — sem depender de ferramentas da comunidade dispersas.
O que é o Claude Code Monitor?
O Claude Code agora exporta dados de telemetria completos e prontos para uso através do OpenTelemetry — a maneira oficial e independente de fornecedores de monitorar tudo o que suas sessões de programação ágena produzem.
- Utilização de tokens (entrada, saída, criação de cache, leitura de cache)
- estimativas de custos (em tempo real e preditivo)
- Atividade com ferramentas (edições de arquivos, execução de comandos, operações git, uso do navegador)
- Tarefas em segundo plano e sessões persistentes (
/tarefas, agentes de longa duração) - Métricas de produtividade (linhas de código aceitas, taxa de aceitação de sugestões)
Ao contrário dos painéis comunitários locais anteriores baseados em JSONL, o suporte oficial da OTel oferece observabilidade de nível empresarial sem a necessidade de código personalizado. Os agentes do Claude Code agora funcionam de forma autônoma por horas ou dias — sem monitoramento, você corre o risco de surpresas desagradáveis na fatura, perda de progresso ou limites de taxa excedidos.
// Fluxo de dados do coletor OpenTelemetry — a espinha dorsal da arquitetura de monitoramento oficial de Claude Code
// Monitor de sessão do Claude Code em tempo real (terminal + visualização de múltiplas sessões)
Guia de Configuração Passo a Passo
Passo 01 — Habilitar a telemetria no código ClaudeInicie o Claude Code com estas variáveis de ambiente. Adicione-as ao seu ~/.zshrc ou ~/.bashrc para permanência:
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 # Aponte para o seu coletor export OTEL_EXPORTER_OTLP_PROTOCOL=grpc export OTEL_METRIC_EXPORT_INTERVAL=10000 # 10 segundos para uma sensação de tempo real
Reinicie o terminal e execute Claude — A telemetria agora será transmitida automaticamente.
Crie uma pasta de projeto e faça o seguinte: docker-compose.yml:
versão: '3.8' serviços: otel-collector: imagem: otel/opentelemetry-collector-contrib:latest comando: ["--config", "/etc/otel/config.yaml"] volumes: - ./otel-config.yaml:/etc/otel/config.yaml portas: - "4317:4317" # gRPC - "4318:4318" # HTTP depends_on: - prometheus prometheus: imagem: prom/prometheus:latest portas: - "9090:9090" volumes: - ./prometheus.yml:/etc/prometheus/prometheus.yml grafana: imagem: grafana/grafana:latest portas: - "3000:3000" environment: - GF_SECURITY_ADMIN_PASSWORD=admin depends_on: - prometheus
otel-config.yaml (minimalista, porém poderoso):
receptores: otlp: protocolos: grpc: http: processadores: batch: exportadores: prometheus: endpoint: "0.0.0.0:9464" registro: serviço: pipelines: métricas: receptores: [otlp] processadores: [batch] exportadores: [prometheus] logs: receptores: [otlp] processadores: [batch] exportadores: [logging]
prometheus.yml:
scrape_configs: - job_name: 'otel-collector' static_configs: - targets: ['otel-collector:9464']
docker compose up -d
- Abrir http://localhost:3000 → login (admin/admin)
- Adicionar fonte de dados Prometheus (URL: http://prometheus:9090)
- Importe ou crie um painel com as principais consultas abaixo.
| Métrica | Consulta Prometheus | O que isso mostra |
|---|---|---|
| Utilização de tokens | soma por (modelo) (total de tokens claude_code) | Detalhamento de entrada/saída/cache |
| Custo estimado | soma por (modelo) (claude_code_custo_estimado_usd) | Taxa de queima de dólares em tempo real |
| Sessões ativas | claude_code_active_sessions | Contagem de tarefas em segundo plano |
| Chamadas de ferramentas | claude_code_tool_calls_total | Edições de arquivos, comandos, etc. |
| Custo por hora | aumentar(claude_code_custo_estimado_usd[1h]) | Alertas preditivos |
Você verá instantaneamente gráficos impressionantes de queima de tokens, curvas de custo e saúde dos agentes.
// Pipeline de observabilidade completo: Claude Code → OTel Collector → Prometheus → Grafana
Principais métricas que você pode acompanhar hoje
- Consumo de tokens em tempo real com taxa de acerto de cache
- Previsão de custos — horas até atingir seu limite
- Status do agente de fundo (
/tarefasvisualização + duração) - Retorno sobre o investimento em produtividade (linhas de código aceitas vs. tempo economizado)
- Alertas de anomalia (picos repentinos de tokens = potencial agente descontrolado)
Avançado: Otimização de Custos + Estratégia Multimodelo
Depois de visualizar exatamente para onde estão indo seus gastos com o Claude Code, o próximo passo é o roteamento inteligente.
Uma dica: Utilize uma plataforma unificada OneAPI como um backend inteligente. Direcione raciocínios complexos para o Claude Code (monitorado via OTel). Direcione tarefas de alto volume ou repetitivas para modelos mais econômicos (Gemma 4, MAI, Hermes, etc.).
- Registro de uso e painéis de custos integrados
- Recurso de fallback automático e balanceamento de carga
- opções de privacidade sem retenção
Resultado: custos 30 a 60% menores, mantendo total visibilidade.
Perguntas frequentes e resolução de problemas
Sim, a telemetria está disponível em todos os planos, embora as métricas de custo sejam mais detalhadas nos planos pagos.
Com certeza. O /tarefas O comando + OTel fornece o status em tempo real de todos os agentes autônomos em execução em segundo plano.
Todos os dados permanecem no seu coletor — nada é enviado para a Anthropic além do que você já envia para inferência.
Consulte o repositório oficial do guia de monitoramento da Anthropic para obter modelos prontos do Docker Compose e do Grafana.
Assuma o controle do seu uso do código Claude
O Claude Code Monitor, através do OpenTelemetry oficial, transforma suas sessões de programação agentiva de uma caixa preta em um sistema totalmente observável e com custos controlados. Combine-o com o OneAPI — mais de 300 modelos de ponta e de código aberto, monitoramento integrado, roteamento inteligente e painéis de controle de uso transparentes.
Experimente o OneAPI gratuitamente em www.ai.ccÚltima atualização: 10 de abril de 2026 · Fontes: Documentação oficial do Código Claude Antrópico e guia de monitoramento do código Claude