Claude Code Monitor 2026 Tutorial: Offizielle OpenTelemetry-Einrichtung für Echtzeit-Token-, Kosten- und Hintergrundaufgabenverfolgung
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.
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 – das Rückgrat der offiziellen Überwachungsarchitektur von Claude Code

// Echtzeit-Sitzungsmonitor für Claude Code (Terminal + Mehrsitzungsansicht)
Schritt-für-Schritt-Einrichtungsanleitung
Schritt 01 – Telemetrie im Claude-Code aktivierenStarten Sie Claude Code mit diesen Umgebungsvariablen. Fügen Sie sie Ihrer Konfiguration hinzu. ~/.zshrc oder ~/.bashrc für die Dauerhaftigkeit:
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.
Erstellen Sie einen Projektordner und dies 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):
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:
scrape_configs: - job_name: 'otel-collector' static_configs: - targets: ['otel-collector:9464']
docker compose up -d
- Offen http://localhost:3000 → Anmelden (admin/admin)
- Prometheus-Datenquelle hinzufügen (URL: http://prometheus:9090)
- 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: 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 (
/tasksAufrufe + 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
Ja – Telemetriedaten sind in allen Tarifen verfügbar, die Kosteninformationen sind jedoch in den kostenpflichtigen Tarifen detaillierter.
Absolut. /tasks Mit dem Befehl + OTel erhalten Sie den Live-Status jedes im Hintergrund laufenden autonomen Agenten.
Alle Daten verbleiben in Ihrem Datensammler – es werden keine weiteren Daten an Anthropic gesendet, als die, die Sie bereits zur Auswertung senden.
Im offiziellen Monitoring-Leitfaden-Repository von Anthropic finden Sie vorgefertigte Docker Compose- und Grafana-Vorlagen.
Ü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.ccLetzte Aktualisierung: 10. April 2026 · Quellen: Offizielle Anthropic Claude Code-Dokumentation & claude-code-monitoring-guide


Einloggen













