Monitorowanie zużycia i kosztów

CLAUDE_CODE_ENABLE_TELEMETRY włącza zbieranie telemetrii i jest wymagane do uruchomienia tego eksportu. Ustaw tę zmienną w środowisku przed uruchomieniem claude. Następnie wybierz eksportery metryk lub logów — oba są opcjonalne, więc konfiguruj tylko te sygnały, których potrzebujesz.

Najpierw ustaw CLAUDE_CODE_ENABLE_TELEMETRY=1, a potem wybierz OTEL_METRICS_EXPORTER i ewentualnie OTEL_LOGS_EXPORTER. Dla eksportera OTLP skonfiguruj protokół i adres kolektora, a w razie potrzeby także nagłówek uwierzytelniający. Claude Code nie ma domyślnego protokołu OTLP, dlatego ustaw protokół ogólny albo właściwy dla każdego włączonego eksportera OTLP.

Po rozpoczęciu sesji sprawdź w backendzie metrykę claude_code.session.count, którą Claude Code emituje przy starcie sesji. Jeśli konfigurujesz tylko logi, wyślij prompt i sprawdź, czy pojawiło się zdarzenie claude_code.user_prompt. Gdy dane nie docierają, uruchom Claude Code z claude --debug-file <path> i sprawdź zapisany tam log.

Ustawienia eksporterów OpenTelemetry w repozytoryjnych plikach .claude/settings.json i .claude/settings.local.json są ignorowane, więc repozytorium nie włączy telemetrii ani nie wybierze jej odbiorcy. Ustaw te zmienne w ustawieniach zarządzanych albo w powłoce dewelopera; można też użyć ~/.claude/settings.json. Administratorzy mogą skonfigurować ustawienia OpenTelemetry dla wszystkich użytkowników w pliku ustawień zarządzanych.

export CLAUDE_CODE_ENABLE_TELEMETRY=1
export OTEL_METRICS_EXPORTER=console

export CLAUDE_CODE_ENABLE_TELEMETRY=1
export OTEL_METRICS_EXPORTER=otlp
export OTEL_EXPORTER_OTLP_PROTOCOL=grpc
export OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4317

export CLAUDE_CODE_ENABLE_TELEMETRY=1
export OTEL_METRICS_EXPORTER=prometheus