The Admin API is unavailable for individual accounts. To collaborate with teammates and add members, set up your organization in Console → Settings → Organization.
Die Claude Code Analytics Admin API bietet programmatischen Zugriff auf täglich aggregierte Nutzungsmetriken für Claude Code-Benutzer und ermöglicht es Organisationen, die Entwicklerproduktivität zu analysieren und benutzerdefinierte Dashboards zu erstellen. Diese API schließt die Lücke zwischen unserem grundlegenden Analytics-Dashboard und der komplexen OpenTelemetry-Integration. Diese API ermöglicht es Ihnen, Ihre Claude Code-Einführung besser zu überwachen, zu analysieren und zu optimieren:
  • Entwicklerproduktivitätsanalyse: Verfolgen Sie Sitzungen, hinzugefügte/entfernte Codezeilen, Commits und Pull Requests, die mit Claude Code erstellt wurden
  • Tool-Nutzungsmetriken: Überwachen Sie Akzeptanz- und Ablehnungsraten für verschiedene Claude Code-Tools (Edit, MultiEdit, Write, NotebookEdit)
  • Kostenanalyse: Zeigen Sie geschätzte Kosten und Token-Nutzung aufgeschlüsselt nach Claude-Modell an
  • Benutzerdefinierte Berichterstattung: Exportieren Sie Daten, um Executive Dashboards und Berichte für Managementteams zu erstellen
  • Nutzungsrechtfertigung: Stellen Sie Metriken bereit, um die Claude Code-Einführung intern zu rechtfertigen und zu erweitern
Admin API-Schlüssel erforderlichDiese API ist Teil der Admin API. Diese Endpunkte erfordern einen Admin API-Schlüssel (beginnend mit sk-ant-admin...), der sich von Standard-API-Schlüsseln unterscheidet. Nur Organisationsmitglieder mit der Admin-Rolle können Admin API-Schlüssel über die Anthropic Console bereitstellen.

​
Schnellstart

Holen Sie sich die Claude Code-Analysen Ihrer Organisation für einen bestimmten Tag: 
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"
Setzen Sie einen User-Agent-Header für IntegrationenWenn Sie eine Integration erstellen, setzen Sie Ihren User-Agent-Header, um uns zu helfen, Nutzungsmuster zu verstehen:
User-Agent: YourApp/1.0.0 (https://yourapp.com)

​
Claude Code Analytics API

Verfolgen Sie Claude Code-Nutzung, Produktivitätsmetriken und Entwickleraktivitäten in Ihrer Organisation mit dem /v1/organizations/usage_report/claude_code-Endpunkt.

​
Schlüsselkonzepte

  • Tägliche Aggregation: Gibt Metriken für einen einzelnen Tag zurück, der durch den starting_at-Parameter angegeben wird
  • Daten auf Benutzerebene: Jeder Datensatz repräsentiert die Aktivität eines Benutzers für den angegebenen Tag
  • Produktivitätsmetriken: Verfolgen Sie Sitzungen, Codezeilen, Commits, Pull Requests und Tool-Nutzung
  • Token- und Kostendaten: Überwachen Sie Nutzung und geschätzte Kosten aufgeschlüsselt nach Claude-Modell
  • Cursor-basierte Paginierung: Handhaben Sie große Datensätze mit stabiler Paginierung unter Verwendung undurchsichtiger Cursor
  • Datenfrische: Metriken sind mit bis zu 1 Stunde Verzögerung für Konsistenz verfügbar
Für vollständige Parameterdetails und Antwortschemas siehe die 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

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

​
Verfügbare Metriken

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

​
Dimensionen

  • date: Datum im RFC 3339-Format (UTC-Zeitstempel)
  • actor: Der Benutzer oder API-Schlüssel, der die Claude Code-Aktionen durchgefü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 verschiedenen Claude Code-Sitzungen, die von diesem Akteur initiiert wurden
  • lines_of_code.added: Gesamtanzahl der Codezeilen, die über alle Dateien hinweg von Claude Code hinzugefügt wurden
  • lines_of_code.removed: Gesamtanzahl der Codezeilen, die über alle Dateien hinweg von Claude Code entfernt wurden
  • commits_by_claude_code: Anzahl der Git-Commits, die über Claude Codes Commit-Funktionalität erstellt wurden
  • pull_requests_by_claude_code: Anzahl der Pull Requests, die über Claude Codes PR-Funktionalität erstellt wurden

​
Tool-Aktionsmetriken

Aufschlüsselung der Tool-Aktions-Akzeptanz- und Ablehnungsraten nach Tool-Typ:
  • edit_tool.accepted/rejected: Anzahl der Edit-Tool-Vorschläge, die der Benutzer akzeptiert/abgelehnt hat
  • multi_edit_tool.accepted/rejected: Anzahl der MultiEdit-Tool-Vorschläge, die der Benutzer akzeptiert/abgelehnt hat
  • write_tool.accepted/rejected: Anzahl der Write-Tool-Vorschläge, die der Benutzer akzeptiert/abgelehnt hat
  • notebook_edit_tool.accepted/rejected: Anzahl der NotebookEdit-Tool-Vorschläge, die der Benutzer akzeptiert/abgelehnt hat

​
Modellaufschlüsselung

Für jedes verwendete Claude-Modell:
  • model: Claude-Modellidentifikator (z.B. claude-3-5-sonnet-20241022)
  • tokens.input/output: Input- und Output-Token-Anzahl für dieses Modell
  • tokens.cache_read/cache_creation: Cache-bezogene Token-Nutzung für dieses Modell
  • estimated_cost.amount: Geschätzte Kosten in Cent USD 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-01T00: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-3-5-sonnet-20241022",
          "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 Benutzern:
  1. Stellen Sie Ihre erste Anfrage mit optionalem limit-Parameter
  2. Wenn has_more in der Antwort true ist, verwenden Sie den next_page-Wert in Ihrer nächsten Anfrage
  3. Fahren Sie fort, bis has_more false ist
Der Cursor kodiert die Position des letzten Datensatzes und gewährleistet stabile Paginierung, auch wenn neue Daten eintreffen. Jede Paginierungssitzung behält eine konsistente Datengrenze bei, um sicherzustellen, dass Sie keine Datensätze verpassen oder duplizieren.

​
Häufige Anwendungsfälle

  • Executive Dashboards: Erstellen Sie hochrangige Berichte, die den Einfluss von Claude Code auf die Entwicklungsgeschwindigkeit zeigen
  • AI-Tool-Vergleich: Exportieren Sie Metriken, um Claude Code mit anderen AI-Coding-Tools wie Copilot und Cursor zu vergleichen
  • Entwicklerproduktivitätsanalyse: Verfolgen Sie individuelle und Team-Produktivitätsmetriken über die Zeit
  • Kostenverfolgung und -zuordnung: Überwachen Sie Ausgabenmuster und ordnen Sie Kosten nach Team oder Projekt zu
  • Einführungsüberwachung: Identifizieren Sie, welche Teams und Benutzer den größten Nutzen aus Claude Code ziehen
  • ROI-Rechtfertigung: Stellen Sie konkrete Metriken bereit, um die Claude Code-Einführung intern zu rechtfertigen und zu erweitern

​
Häufig gestellte Fragen

​
Wie aktuell sind die Analysedaten?

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

​
Kann ich Echtzeitmetriken erhalten?

Nein, diese API stellt nur täglich aggregierte Metriken bereit. Für Echtzeitüberwachung erwägen Sie die Verwendung der OpenTelemetry-Integration.

​
Wie werden Benutzer in den Daten identifiziert?

Benutzer werden über das actor-Feld auf zwei Arten identifiziert:
  • user_actor: Enthält email_address für Benutzer, die sich über OAuth authentifizieren (am häufigsten)
  • api_actor: Enthält api_key_name für Benutzer, die sich über API-Schlüssel authentifizieren
Das customer_type-Feld gibt an, ob die Nutzung von api-Kunden (API PAYG) oder subscription-Kunden (Pro/Team-Pläne) stammt.

​
Wie lange ist die Datenaufbewahrungszeit?

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

​
Welche Claude Code-Bereitstellungen werden unterstützt?

Diese API verfolgt nur die Claude Code-Nutzung auf der Anthropic API (1st Party). Die Nutzung auf Amazon Bedrock, Google Vertex AI oder anderen Drittanbieter-Plattformen ist nicht enthalten.

​
Was kostet die Nutzung dieser API?

Die Claude Code Analytics API ist kostenlos für alle Organisationen mit Zugang zur Admin API.

​
Wie berechne ich Tool-Akzeptanzraten?

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

​
Welche Zeitzone wird für den Datumsparameter verwendet?

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

​
Siehe auch

Die Claude Code Analytics API hilft Ihnen, den Entwicklungsworkflow Ihres Teams zu verstehen und zu optimieren. Erfahren Sie mehr über verwandte Funktionen: