Что такое Claude Code Monitor?

Теперь Claude Code может экспортировать подробные телеметрические данные из коробки через OpenTelemetry — официальный, независимый от поставщиков способ мониторинга всего, что генерируется в ходе сеансов программирования агентов.

• Использование токенов (ввод, вывод, создание кэша, чтение из кэша)
• Сметы расходов (в режиме реального времени и с прогнозированием)
• Активность инструмента (редактирование файлов, выполнение команд, операции Git, использование браузера)
• Фоновые задачи и постоянные сессии (/задачи(агентства, действующие длительное время)
• Показатели производительности (количество принятых строк кода, процент принятия предложений)

В отличие от более ранних локальных панелей мониторинга на основе JSONL, официальная поддержка OTel обеспечивает мониторинг корпоративного уровня без написания пользовательского кода. Агенты Claude Code теперь работают автономно в течение нескольких часов или дней — без мониторинга вы рискуете получить неожиданные счета, потерять прогресс или столкнуться с превышением лимитов трафика.

// Поток данных OpenTelemetry Collector — основа официальной архитектуры мониторинга Клода Кода.

// Монитор сеансов 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 секунд для отображения в реальном времени

Перезапустите терминал и выполните команду Клод — Теперь телеметрия будет передаваться автоматически.

Создайте папку проекта и вот это. 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 depends_on: - prometheus prometheus: образ: prom/prometheus:latest порты: - "9090:9090" тома: - ./prometheus.yml:/etc/prometheus/prometheus.yml grafana: образ: grafana/grafana:latest порты: - "3000:3000" среда: - GF_SECURITY_ADMIN_PASSWORD=admin depends_on: - прометей

otel-config.yaml (минимально, но эффективно):

receivers: otlp: protocols: grpc: http: processors: batch: exporters: prometheus: endpoint: "0.0.0.0:9464" logging: service: pipelines: metrics: receivers: [otlp] processors: [batch] exporters: [prometheus] logs: receivers: [otlp] processors: [batch] exporters: [logging]

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. Импортируйте или создайте панель мониторинга, используя ключевые запросы, указанные ниже.

Вы мгновенно увидите красивые графики расходования токенов, кривые затрат и состояние здоровья агентов.

// Полный конвейер мониторинга: Claude Code → OTel Collector → Prometheus → Grafana

Ключевые показатели, которые вы можете отслеживать уже сегодня.

• Потребление токенов в режиме реального времени с коэффициентом попадания в кэш
• Прогнозирование затрат — часов до достижения предела
• Статус фонового агента (/задачи (просмотр + продолжительность)
• Окупаемость инвестиций в повышение производительности (количество принятых строк кода против сэкономленного времени)
• Предупреждения об аномалиях (Внезапные всплески количества токенов = потенциальный фактор, способный выйти из-под контроля)

Расширенные возможности: Оптимизация затрат + Многомодельная стратегия

Как только вы точно увидите, куда уходят ваши средства, потраченные по коду Клода, следующим шагом станет интеллектуальная маршрутизация.

Совет: Используйте единую платформу OneAPI в качестве интеллектуального бэкэнда. Маршрутизация сложных логических вычислений → код Клода (мониторинг через OTel). Маршрутизация больших объемов или повторяющихся задач → более дешевые модели (Gemma 4, MAI, Hermes и др.).

• Встроенная система регистрации использования и панели мониторинга затрат.
• Автоматическое переключение на резервный режим и балансировка нагрузки
• Параметры конфиденциальности с нулевым сроком хранения

Результат: снижение затрат на 30–60% при сохранении полной прозрачности.

Часто задаваемые вопросы и устранение неполадок