Claude Platform Docs
AdminMonitoring

Claude Code Analytics API

Greife mit der Claude Code Analytics Admin API programmatisch auf die Claude Code-Nutzungsanalysen und Produktivitätsmetriken deiner Organisation zu.

Die Claude Code Analytics Admin API bietet programmatischen Zugriff auf täglich aggregierte Nutzungsmetriken für Claude Code-Nutzer und ermöglicht es Organisationen, die Entwicklerproduktivität zu analysieren und benutzerdefinierte Dashboards zu erstellen. Diese API liefert mehr Details als das grundlegende Analytics-Dashboard, ohne die Komplexität der OpenTelemetry-Integration.

Diese API ermöglicht es dir, deine Claude Code-Einführung besser zu überwachen, zu analysieren und zu optimieren:

  • Analyse der Entwicklerproduktivität: Verfolge Sitzungen, hinzugefügte/entfernte Codezeilen, Commits und Pull Requests, die mit Claude Code erstellt wurden
  • Metriken zur Tool-Nutzung: Überwache Annahme- und Ablehnungsraten für verschiedene Claude Code-Tools (Edit, MultiEdit, Write, NotebookEdit)
  • Kostenanalyse: Sieh dir geschätzte Kosten und Token-Nutzung aufgeschlüsselt nach Claude-Modell an
  • Benutzerdefiniertes Reporting: Exportiere Daten, um Executive-Dashboards und Berichte für Management-Teams zu erstellen
  • Nutzungsbegründung: Stelle Metriken bereit, um die Einführung von Claude Code intern zu rechtfertigen und auszuweiten

Schnellstart

Rufe die Claude Code-Analysen deiner Organisation für einen bestimmten Tag ab:

cURL
curl "https://api.anthropic.com/v1/organizations/usage_report/claude_code?\
starting_at=2025-09-08&\
limit=20" \
  -H "anthropic-version: 2023-06-01" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY"

Claude Code Analytics API

Verfolge Claude Code-Nutzung, Produktivitätsmetriken und Entwickleraktivität in deiner gesamten Organisation mit dem Endpunkt /v1/organizations/usage_report/claude_code.

Wichtige Konzepte

  • Tägliche Aggregation: Gibt Metriken für einen einzelnen Tag zurück, der durch den Parameter starting_at angegeben wird
  • Daten auf Nutzerebene: Jeder Datensatz repräsentiert die Aktivität eines Nutzers für den angegebenen Tag
  • Produktivitätsmetriken: Verfolge Sitzungen, Codezeilen, Commits, Pull Requests und Tool-Nutzung
  • Token- und Kostendaten: Überwache Nutzung und geschätzte Kosten aufgeschlüsselt nach Claude-Modell
  • Cursor-basierte Paginierung: Verarbeite große Datensätze mit stabiler Paginierung mithilfe opaker Cursor
  • Datenaktualität: Metriken sind aus Konsistenzgründen mit einer Verzögerung von bis zu 1 Stunde verfügbar

Vollständige Parameterdetails und Antwortschemata findest du in der Claude Code Analytics API-Referenz.

Grundlegende Beispiele

Analysen für einen bestimmten Tag abrufen

cURL
curl "https://api.anthropic.com/v1/organizations/usage_report/claude_code?\
starting_at=2025-09-08" \
  -H "anthropic-version: 2023-06-01" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY"

Analysen mit Paginierung abrufen

cURL
# Erste Anfrage
curl "https://api.anthropic.com/v1/organizations/usage_report/claude_code?\
starting_at=2025-09-08&\
limit=20" \
  -H "anthropic-version: 2023-06-01" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY"

# Nachfolgende Anfrage mit dem Cursor aus der Antwort
curl "https://api.anthropic.com/v1/organizations/usage_report/claude_code?\
starting_at=2025-09-08&\
page=page_MjAyNS0wNS0xNFQwMDowMDowMFo=" \
  -H "anthropic-version: 2023-06-01" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY"

Anfrageparameter

ParameterTypErforderlichBeschreibung
starting_atstringJaUTC-Datum im Format YYYY-MM-DD; gibt nur Metriken für diesen einzelnen Tag zurück
limitintegerNeinAnzahl der Datensätze pro Seite (Standard: 20, max.: 1000)
pagestringNeinOpakes Cursor-Token aus dem Feld next_page der vorherigen Antwort

Verfügbare Metriken

Jeder Antwortdatensatz enthält die folgenden Metriken für einen einzelnen Nutzer an einem einzelnen Tag:

Dimensionen

  • date: Datum im RFC 3339-Format (UTC-Zeitstempel)
  • actor: Der Nutzer oder API-Key, der die Claude Code-Aktionen ausgeführt hat (entweder user_actor mit email_address oder api_actor mit api_key_name)
  • organization_id: UUID der Organisation
  • customer_type: Typ des Kundenkontos (api für API-Kunden, subscription für Pro/Team-Kunden)
  • terminal_type: Typ des Terminals oder der Umgebung, in der Claude Code verwendet wurde (zum Beispiel vscode, iTerm.app, tmux)

Kernmetriken

  • num_sessions: Anzahl der unterschiedlichen Claude Code-Sitzungen, die von diesem Akteur gestartet wurden
  • lines_of_code.added: Gesamtzahl der von Claude Code über alle Dateien hinweg hinzugefügten Codezeilen
  • lines_of_code.removed: Gesamtzahl der von Claude Code über alle Dateien hinweg entfernten Codezeilen
  • commits_by_claude_code: Anzahl der Git-Commits, die über die Commit-Funktionalität von Claude Code erstellt wurden
  • pull_requests_by_claude_code: Anzahl der Pull Requests, die über die PR-Funktionalität von Claude Code erstellt wurden

Metriken zu Tool-Aktionen

Aufschlüsselung der Annahme- und Ablehnungsraten von Tool-Aktionen nach Tool-Typ:

  • edit_tool.accepted/rejected: Anzahl der Edit-Tool-Vorschläge, die der Nutzer angenommen/abgelehnt hat
  • multi_edit_tool.accepted/rejected: Anzahl der MultiEdit-Tool-Vorschläge, die der Nutzer angenommen/abgelehnt hat
  • write_tool.accepted/rejected: Anzahl der Write-Tool-Vorschläge, die der Nutzer angenommen/abgelehnt hat
  • notebook_edit_tool.accepted/rejected: Anzahl der NotebookEdit-Tool-Vorschläge, die der Nutzer angenommen/abgelehnt hat

Aufschlüsselung nach Modell

Für jedes verwendete Claude-Modell:

  • model: Claude-Modellkennung (zum Beispiel claude-opus-5)
  • tokens.input/output: Anzahl der Input- und Output-Token für dieses Modell
  • tokens.cache_read/cache_creation: Cache-bezogene Token-Nutzung für dieses Modell
  • estimated_cost.amount: Geschätzte Kosten in US-Cent für dieses Modell
  • estimated_cost.currency: Währungscode für den Kostenbetrag (derzeit immer USD)

Antwortstruktur

Die API gibt Daten im folgenden Format zurück:

{
  "data": [
    {
      "date": "2025-09-08T00:00:00Z",
      "actor": {
        "type": "user_actor",
        "email_address": "developer@company.com"
      },
      "organization_id": "dc9f6c26-b22c-4831-8d01-0446bada88f1",
      "customer_type": "api",
      "terminal_type": "vscode",
      "core_metrics": {
        "num_sessions": 5,
        "lines_of_code": {
          "added": 1543,
          "removed": 892
        },
        "commits_by_claude_code": 12,
        "pull_requests_by_claude_code": 2
      },
      "tool_actions": {
        "edit_tool": {
          "accepted": 45,
          "rejected": 5
        },
        "multi_edit_tool": {
          "accepted": 12,
          "rejected": 2
        },
        "write_tool": {
          "accepted": 8,
          "rejected": 1
        },
        "notebook_edit_tool": {
          "accepted": 3,
          "rejected": 0
        }
      },
      "model_breakdown": [
        {
          "model": "claude-opus-5",
          "tokens": {
            "input": 100000,
            "output": 35000,
            "cache_read": 10000,
            "cache_creation": 5000
          },
          "estimated_cost": {
            "currency": "USD",
            "amount": 141
          }
        }
      ]
    }
  ],
  "has_more": false,
  "next_page": null
}

Paginierung

Die API unterstützt Cursor-basierte Paginierung für Organisationen mit einer großen Anzahl von Nutzern:

  1. Stelle deine erste Anfrage mit dem optionalen Parameter limit.
  2. Wenn has_more in der Antwort true ist, verwende den Wert next_page in deiner nächsten Anfrage.
  3. Fahre fort, bis has_more false ist.

Der Cursor kodiert die Position des letzten Datensatzes und gewährleistet eine stabile Paginierung, auch wenn neue Daten eintreffen. Jede Paginierungssitzung behält eine konsistente Datengrenze bei, um sicherzustellen, dass du keine Datensätze verpasst oder doppelt erhältst.

Häufige Anwendungsfälle

  • Executive-Dashboards: Erstelle übergeordnete Berichte, die den Einfluss von Claude Code auf die Entwicklungsgeschwindigkeit zeigen
  • Vergleich von KI-Tools: Exportiere Metriken, um Claude Code mit anderen KI-Coding-Tools wie Copilot und Cursor zu vergleichen
  • Analyse der Entwicklerproduktivität: Verfolge individuelle und Team-Produktivitätsmetriken im Zeitverlauf
  • Kostenverfolgung und -zuordnung: Überwache Ausgabenmuster und ordne Kosten nach Team oder Projekt zu
  • Überwachung der Einführung: Identifiziere, welche Teams und Nutzer den größten Nutzen aus Claude Code ziehen
  • ROI-Begründung: Stelle konkrete Metriken bereit, um die Einführung von Claude Code intern zu rechtfertigen und auszuweiten

Häufig gestellte Fragen

Wie aktuell sind die Analysedaten?

Claude Code-Analysedaten erscheinen in der Regel innerhalb von 1 Stunde nach Abschluss der Nutzeraktivität. Um konsistente Paginierungsergebnisse zu gewährleisten, werden nur Daten, die älter als 1 Stunde sind, in die Antworten aufgenommen.

Kann ich Echtzeit-Metriken erhalten?

Nein, diese API stellt nur täglich aggregierte Metriken bereit. Für Echtzeit-Monitoring solltest du die OpenTelemetry-Integration in Betracht ziehen.

Wie werden Nutzer in den Daten identifiziert?

Nutzer werden über das Feld actor auf zwei Arten identifiziert:

  • user_actor: Enthält email_address für Nutzer, die sich über OAuth authentifizieren (am häufigsten)
  • api_actor: Enthält api_key_name für Nutzer, die sich mit einem API-Key authentifizieren

Das Feld customer_type gibt an, ob die Nutzung von api-Kunden (Pay-as-you-go-API) oder subscription-Kunden (Pro/Team-Pläne) stammt.

Wie lang ist die Aufbewahrungsfrist der Daten?

Historische Claude Code-Analysedaten werden aufbewahrt und sind über die API zugänglich. Es gibt keine festgelegte Löschfrist für diese Daten.

Welche Claude Code-Bereitstellungen werden unterstützt?

Diese API verfolgt nur die Claude Code-Nutzung über die Claude API. Die Nutzung über Claude in Amazon Bedrock, Claude in Microsoft Foundry, Claude auf Google Cloud oder Claude Platform on AWS ist nicht enthalten.

Was kostet die Nutzung dieser API?

Die Claude Code Analytics API ist für alle Organisationen mit Zugriff auf die Admin API kostenlos nutzbar.

Wie berechne ich Tool-Annahmeraten?

Tool-Annahmerate = accepted / (accepted + rejected) für jeden Tool-Typ. Wenn das Edit-Tool beispielsweise 45 angenommene und 5 abgelehnte Vorschläge zeigt, beträgt die Annahmerate 90 %.

Welche Zeitzone wird für den Datumsparameter verwendet?

Alle Datumsangaben sind in UTC. Der Parameter starting_at sollte im Format YYYY-MM-DD vorliegen und repräsentiert UTC-Mitternacht für diesen Tag.

Siehe auch

Die Claude Code Analytics API hilft dir, den Entwicklungs-Workflow deines Teams zu verstehen und zu optimieren. Erfahre mehr über verwandte Funktionen:

Was this page helpful?