Empfohlener Blog

Claude Code Monitor 2026 Tutorial: Offizielle OpenTelemetry-Einrichtung für Echtzeit-Token-, Kosten- und Hintergrundaufgabenverfolgung

10.04.2026
Offizielles Tutorial · 2026
Claude Code Monitor · OpenTelemetry-Einrichtung
Letzte Aktualisierung: 10. April 2026
Quelle: Offizielle Dokumente der Anthropokultur

Claude Code Monitor:
OpenTelemetry

Anthropic hat Claude Code mit nativen Funktionen deutlich produktionsreifer gemacht. OpenTelemetry (OTel) Unterstützung für die Überwachung. Egal ob Sie langlaufende autonome Agenten, Hintergrundaufgaben im Automatikmodus oder Codierungs-Workflows im Unternehmensmaßstab ausführen, die neuen offiziellen Überwachungsfunktionen ermöglichen es Ihnen, Token-Verbrauch, geschätzte Kosten, Tool-Aktivität und Sitzungsstatus in Echtzeit zu verfolgen – ohne auf verstreute Community-Tools angewiesen zu sein.

// Voraussetzungen
Claude Code CLI v2.x+
Docker (für den Compose-Stack)
Grundkenntnisse über Umgebungsvariablen
Optional: Grafana Cloud (kostenlose Version)

Was ist der Claude Code Monitor?

Claude Code exportiert jetzt standardmäßig umfangreiche Telemetriedaten über OpenTelemetry – die offizielle, herstellerneutrale Methode, um alles zu überwachen, was Ihre agentenbasierten Codierungssitzungen erzeugen.

  • Token-Nutzung (Eingabe, Ausgabe, Cache-Erstellung, Cache-Lesevorgang)
  • Kostenvoranschläge (Echtzeit und vorausschauend)
  • Werkzeugaktivität (Dateibearbeitung, Befehlsausführung, Git-Operationen, Browsernutzung)
  • Hintergrundaufgaben und persistente Sitzungen (/tasks(langjährige Agenten)
  • Produktivitätskennzahlen (akzeptierte Codezeilen, Annahmequote für Vorschläge)

Im Gegensatz zu früheren lokalen, JSONL-basierten Community-Dashboards bietet Ihnen der offizielle OTel-Support Transparenz auf Unternehmensebene – ganz ohne benutzerdefinierten Code. Claude Code-Agenten laufen jetzt stunden- oder tagelang autonom. Ohne Überwachung riskieren Sie unerwartete Kosten, Projektverluste oder Probleme mit der Ratenbegrenzung.

OpenTelemetry Collector-Datenfluss-Dashboard – Rückgrat der offiziellen Überwachungsarchitektur von Claude Code

// OpenTelemetry Collector-Datenfluss – das Rückgrat der offiziellen Überwachungsarchitektur von Claude Code

Echtzeit-Sitzungsüberwachung für Claude Code – Terminal- und Mehrsitzungsansicht mit QR-Code-Zugriff

// Echtzeit-Sitzungsmonitor für Claude Code (Terminal + Mehrsitzungsansicht)

Schritt-für-Schritt-Einrichtungsanleitung

Schritt 01 – Telemetrie im Claude-Code aktivieren

Starten Sie Claude Code mit diesen Umgebungsvariablen. Fügen Sie sie Ihrer Konfiguration hinzu. ~/.zshrc oder ~/.bashrc für die Dauerhaftigkeit:

bash · env config
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 # Verweis auf Ihren Collector export OTEL_EXPORTER_OTLP_PROTOCOL=grpc export OTEL_METRIC_EXPORT_INTERVAL=10000 # 10 Sekunden für Echtzeit-Erlebnis

Starten Sie Ihr Terminal neu und führen Sie Folgendes aus: Claude — Die Telemetriedaten werden nun automatisch übertragen.

Schritt 02 – Bereitstellung von OTel Collector + Prometheus + Grafana

Erstellen Sie einen Projektordner und dies docker-compose.yml:

yaml · docker-compose.yml
Version: '3.8' Dienste: otel-collector: Image: otel/opentelemetry-collector-contrib:latest Befehl: ["--config", "/etc/otel/config.yaml"] Volumes: - ./otel-config.yaml:/etc/otel/config.yaml Ports: - "4317:4317" # gRPC - "4318:4318" # HTTP Abhängigkeiten: - prometheus prometheus: Image: prom/prometheus:latest Ports: - "9090:9090" Volumes: - ./prometheus.yml:/etc/prometheus/prometheus.yml grafana: Image: grafana/grafana:latest Ports: - "3000:3000" Umgebung: - GF_SECURITY_ADMIN_PASSWORD=admin Abhängigkeiten: - prometheus

otel-config.yaml (minimalistisch, aber wirkungsvoll):

yaml · otel-config.yaml
Empfänger: otlp: Protokolle: gRPC: http: Prozessoren: Batch: Exporteure: Prometheus: Endpunkt: "0.0.0.0:9464" Protokollierung: Dienst: Pipelines: Metriken: Empfänger: [otlp] Prozessoren: [Batch] Exporteure: [Prometheus] Protokolle: Empfänger: [otlp] Prozessoren: [Batch] Exporteure: [Protokollierung]

prometheus.yml:

yaml · prometheus.yml
scrape_configs: - job_name: 'otel-collector' static_configs: - targets: ['otel-collector:9464']
bash · launch
docker compose up -d
Schritt 03 – Erstellen Sie Ihr erstes Grafana-Dashboard
  1. Offen http://localhost:3000 → Anmelden (admin/admin)
  2. Prometheus-Datenquelle hinzufügen (URL: http://prometheus:9090)
  3. Importieren oder erstellen Sie ein Dashboard mit den folgenden Schlüsselabfragen:
Metrisch Prometheus-Abfrage Was es zeigt
Token-Nutzung sum by(model) (claude_code_tokens_total) Aufschlüsselung von Eingabe/Ausgabe/Cache
Geschätzte Kosten sum by(model) (claude_code_estimated_cost_usd) Echtzeit-Dollarverbrauchsrate
Aktive Sitzungen claude_code_active_sessions Hintergrundaufgaben zählen
Werkzeugaufrufe claude_code_tool_calls_total Dateibearbeitungen, Befehle usw.
Kosten pro Stunde increase(claude_code_estimated_cost_usd[1h]) Vorausschauende Warnmeldungen

Sie sehen sofort übersichtliche Grafiken zum Tokenverbrauch, zu Kostenkurven und zum Agentenstatus.

Vollständige Observability-Pipeline – von Claude Code über OTel Collector und Prometheus bis hin zu Grafana

// Vollständige Observability-Pipeline: Claude Code → OTel Collector → Prometheus → Grafana

Wichtige Kennzahlen, die Sie heute verfolgen können

  • Tokenverbrauch in Echtzeit mit Cache-Trefferrate
  • Kostenprognose — Stunden, bis du dein Limit erreichst
  • Hintergrundagentenstatus (/tasks Aufrufe + Dauer)
  • Produktivitäts-ROI (Akzeptierte Codezeilen vs. Zeitersparnis)
  • Anomaliewarnungen (plötzliche Token-Spitzen = potenziell außer Kontrolle geratener Agent)

Fortgeschritten: Kostenoptimierung + Multi-Modell-Strategie

Sobald Sie genau sehen, wohin Ihre Ausgaben für Claude Code fließen, ist der nächste Schritt das intelligente Routing.

Als Tipp: Nutzen Sie eine einheitliche OneAPI-Plattform als intelligentes Backend. Komplexe Berechnungen werden an Claude Code (überwacht über OTel) weitergeleitet. Aufgaben mit hohem Volumen oder wiederkehrende Aufgaben werden an kostengünstigere Modelle (Gemma 4, MAI, Hermes usw.) ausgelagert.

  • Integrierte Nutzungsprotokollierung und Kostenübersicht
  • Automatisches Fallback und Lastverteilung
  • Datenschutzoptionen ohne Datenspeicherung

Ergebnis: 30–60 % niedrigere Kosten bei gleichzeitig voller Transparenz.

Häufig gestellte Fragen & Fehlerbehebung

Funktioniert das auch für Nutzer der kostenlosen Version?

Ja – Telemetriedaten sind in allen Tarifen verfügbar, die Kosteninformationen sind jedoch in den kostenpflichtigen Tarifen detaillierter.

Kann ich Hintergrundprozesse überwachen?

Absolut. /tasks Mit dem Befehl + OTel erhalten Sie den Live-Status jedes im Hintergrund laufenden autonomen Agenten.

Bedenken hinsichtlich des Datenschutzes?

Alle Daten verbleiben in Ihrem Datensammler – es werden keine weiteren Daten an Anthropic gesendet, als die, die Sie bereits zur Auswertung senden.

Sie wünschen sich Dashboards für Unternehmen?

Im offiziellen Monitoring-Leitfaden-Repository von Anthropic finden Sie vorgefertigte Docker Compose- und Grafana-Vorlagen.

// Lass dich nie wieder von einer Claude-Rechnung überraschen

Übernehmen Sie die Kontrolle über Ihre Claude-Code-Nutzung

Claude Code Monitor, basierend auf der offiziellen OpenTelemetry-Plattform, verwandelt Ihre agentenbasierten Codierungssitzungen von einer Blackbox in ein vollständig transparentes und kostenkontrolliertes System. Kombinieren Sie es mit OneAPI – über 300 innovative und Open-Source-Modelle, integrierte Überwachung, intelligentes Routing und übersichtliche Nutzungs-Dashboards.

Testen Sie OneAPI kostenlos unter www.ai.cc

Letzte Aktualisierung: 10. April 2026 · Quellen: Offizielle Anthropic Claude Code-Dokumentation & claude-code-monitoring-guide

Mehr als 300 KI-Modelle für
OpenClaw & KI-Agenten

Sparen Sie 20 % der Kosten