Claude Code Analytics API

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 schließt die Lücke zwischen dem einfachen Analytics-Dashboard und der komplexen 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 Sessions, hinzugefügte/entfernte Codezeilen, Commits und Pull Requests, die mit Claude Code erstellt wurden
• Tool-Nutzungsmetriken: Überwache Akzeptanz- 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
• Benutzerdefinierte Berichte: 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 begründen und auszuweiten

Schnellstart

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

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

User-Agent: YourApp/1.0.0 (https://yourapp.com)

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.

Zentrale 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 Sessions, 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 unter Verwendung von opaken Cursors
• Datenaktualität: Metriken sind mit einer Verzögerung von bis zu 1 Stunde verfügbar, um Konsistenz zu gewährleisten

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

Grundlegende Beispiele

Analysen für einen bestimmten Tag abrufen

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

Analysen mit Paginierung abrufen

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

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

Anfrageparameter

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: Organisations-UUID
• 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 (z. B. vscode, iTerm.app, tmux)

Kernmetriken

• num_sessions: Anzahl der unterschiedlichen Claude Code-Sessions, die von diesem Akteur initiiert wurden
• lines_of_code.added: Gesamtzahl der Codezeilen, die von Claude Code über alle Dateien hinweg hinzugefügt wurden
• lines_of_code.removed: Gesamtzahl der Codezeilen, die von Claude Code über alle Dateien hinweg entfernt wurden
• 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

Tool-Aktionsmetriken

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

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

Modellaufschlüsselung

Für jedes verwendete Claude-Modell:

• model: Claude-Modellbezeichner (z. B. claude-opus-4-8)
• 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": "[email protected]"
      },
      "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-4-8",
          "tokens": {
            "input": 100000,
            "output": 35000,
            "cache_read": 10000,
            "cache_creation": 5000
          },
          "estimated_cost": {
            "currency": "USD",
            "amount": 1025
          }
        }
      ]
    }
  ],
  "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 optionalem limit-Parameter
2. Wenn has_more in der Antwort true ist, verwende den next_page-Wert 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 duplizierst.

Häufige Anwendungsfälle

• Executive-Dashboards: Erstelle übergeordnete Berichte, die den Einfluss von Claude Code auf die Entwicklungsgeschwindigkeit zeigen
• KI-Tool-Vergleich: 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
• Adoptionsüberwachung: 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 begründen 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 Echtzeitmetriken erhalten?

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

Wie werden Nutzer in den Daten identifiziert?

Nutzer werden über das actor-Feld 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 lange werden die Daten aufbewahrt?

Historische Claude Code-Analysedaten werden aufbewahrt und sind über die API zugänglich. Es gibt keinen festgelegten Löschzeitraum 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 Platform auf AWS, Claude in Microsoft Foundry, Claude in Amazon Bedrock oder Claude auf Vertex AI 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-Akzeptanzraten?

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

Welche Zeitzone wird für den Datumsparameter verwendet?

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

Siehe auch

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

• Admin API
• Admin API-Referenz
• Claude Code Analytics-Dashboard
• Usage and Cost API – Verfolge die API-Nutzung über alle Anthropic-Dienste hinweg
• Compliance API – Rufe Audit- und Aktivitätsdaten ab
• Identitäts- und Zugriffsverwaltung
• Nutzungsüberwachung mit OpenTelemetry für benutzerdefinierte Metriken und Benachrichtigungen