AdminÜberwachung

Analytics-APIs

Copy page



Verstehe, welche Analytics API und welchen API-Key deine Organisation benötigt, und richte dann den Zugriff auf Claude Code-Produktivitätsmetriken oder Claude Enterprise-Engagement- und Adoptionsdaten ein.

Anthropic stellt zwei Produkt-Analytics-APIs bereit, und welche du verwendest, hängt davon ab, welches Claude-Produkt deine Organisation verwaltet:

• Die Claude Code Analytics API liefert tägliche Claude Code-Produktivitätsmetriken für Organisationen, die die Claude Platform nutzen. Sie ist Teil der Admin API und verwendet einen Admin API-Key.
• Die Claude Enterprise Analytics API liefert organisationsweite Engagement-, Adoptions- und Kostendaten über Claude-Produkte hinweg (Chat, Projekte, Claude Code und mehr) für Claude Enterprise-Organisationen. Sie verwendet einen Analytics API-Key, der in claude.ai erstellt wird.

Die beiden APIs verwenden unterschiedliche Key-Typen, die an unterschiedlichen Orten von unterschiedlichen Rollen erstellt werden. Diese Seite beschreibt, welche API zu deiner Organisation passt und wie du den richtigen Key erstellst.

Welche API benötigst du?

Die Key-Typen sind nicht austauschbar: Ein Admin API-Key kann die Claude Enterprise Analytics API nicht aufrufen, und ein Analytics API-Key kann die Admin API nicht aufrufen. Die einzige Ausnahme ist die Usage and Cost Analytics API, die Claude Enterprise-Organisationen mit ihrem Analytics API-Key aufrufen. Beide Produkt-Analytics-APIs erscheinen in der Admin API-Referenz, sind aber separate APIs mit separaten Key-Typen. Wenn deine Organisation sowohl die Claude Platform als auch Claude Enterprise nutzt, kannst du beide Keys einrichten und jede API für ihre eigenen Daten verwenden.

Zugriff auf die Claude Code Analytics API erhalten

Die Claude Code Analytics API steht jeder Organisation mit Zugriff auf die Admin API zur Verfügung und ist kostenlos nutzbar.

1. 1

   Einen Admin API-Key erstellen

   Folge den Schritten unter Einen Admin API-Key erstellen.

2. 2

   Die API aufrufen

   Übergib den Key im x-api-key-Header:

   curl "https://api.anthropic.com/v1/organizations/usage_report/claude_code?starting_at=2025-09-08" \
     -H "anthropic-version: 2026-10-21" \
     -H "x-api-key: $ANTHROPIC_ADMIN_KEY"

   

Für die verfügbaren Metriken, Anfrageparameter und das Antwortschema siehe den Leitfaden zur Claude Code Analytics API und die API-ReferenzVorschau mit Links zur API-Referenz verfügbar – drücke Tab, bis der Fokus in die Karte wechselt, und Escape, um zurückzukehren..

Zugriff auf die Claude Enterprise Analytics API erhalten

Die Claude Enterprise Analytics API steht Claude Enterprise-Organisationen zur Verfügung. Engagement- und Adoptionsdaten sind in allen Enterprise-Plänen verfügbar. Die Kosten- und Nutzungsendpunkte gelten für nutzungsbasierte Enterprise-Pläne; bei sitzplatzbasierten Enterprise-Plänen spiegeln sie nur Nutzungsguthaben wider.

1. 1

   Als primärer Eigentümer anmelden

   Nur der primäre Eigentümer der Organisation kann den API-Zugriff aktivieren und Analytics API-Keys erstellen.

2. 2

   API-Zugriff aktivieren und einen Key erstellen

   Gehe zu claude.ai > Organisationseinstellungen > API und aktiviere den öffentlichen API-Zugriff, dann erstelle einen Analytics API-Key. Keys tragen den Scope read:analytics. Kopiere das angezeigte Secret und speichere es in deinem Secrets-Manager.

3. 3

   Die API aufrufen

   Übergib den Key im x-api-key-Header und füge bei jeder Anfrage den anthropic-version-Header hinzu. Die Endpunkte befinden sich unter https://api.anthropic.com/v1/organizations/analytics/. Anfragebeispiele, Parameter und Antwortschemas findest du in der Claude Enterprise Analytics API-Referenz.

Die Claude Enterprise Analytics API bietet:

• Benutzeraktivität: tägliche Metriken pro Benutzer für Chat (Gespräche, Nachrichten, Projekte, Dateien, Artifacts), Claude Code (Sitzungen, Commits, Pull Requests, Codezeilen, Tool-Aktionen), Chat and Cowork unified (Chat-Aktivität und Cowork-Sitzungen) und andere Claude-Produkte
• Aktivitätszusammenfassungen: täglich, wöchentlich und monatlich aktive Benutzer auf Organisationsebene, Sitzplatzanzahlen und ausstehende Einladungen
• Projekt-, Skill- und Connector-Nutzung: Adoptionsaufschlüsselungen für Chat-Projekte, Skills und Connectors
• Kosten- und Nutzungsberichte: Token-Nutzung und Kosten pro Benutzer und auf Organisationsebene im Zeitverlauf (nutzungsbasierte Enterprise-Pläne)

Endpunktdetails, Parameter und Antwortschemata findest du in der Claude Enterprise Analytics API-Referenz. Die folgenden Abschnitte behandeln Datenaktualität, Metrikdefinitionen und betriebliche Hinweise, die für alle diese Endpunkte gelten.

Datenverfügbarkeit und -aktualität

Daten der Claude Enterprise Analytics API sind für Datumsangaben ab dem 1. Januar 2026 verfügbar.

Engagement- und Adoptionsendpunkte (Benutzeraktivität, Zusammenfassungen, Projekte, Skills, Connectors) geben einen Tages-Snapshot für das von dir angegebene Datum zurück. Daten für einen bestimmten Tag sind in der Regel bis etwa 13:00–13:30 UTC am folgenden Tag verfügbar (1 Tag Verzögerung). Bis dahin ist der neueste verfügbare Tag normalerweise 2 Tage vor dem aktuellen UTC-Datum. An Tagen, an denen eine vorgelagerte Datenpipeline verspätet läuft, kommen die Daten später an, und die genaue Aktualität variiert je nach Abfrage. Statt von einer festen Uhrzeit auszugehen, prüfe daher die Fehlerantwort: Die Anfrage eines noch nicht verfügbaren Datums gibt einen 400-Fehler zurück, der den neuesten verfügbaren Tag nennt. Wenn Daten deutlich über die übliche Verzögerung hinaus nicht verfügbar sind, deutet dies in der Regel auf einen Fehler der Datenpipeline auf Seiten von Anthropic hin; wende dich an den Support, wenn die Lücke bestehen bleibt.

Kosten- und Nutzungsendpunkte folgen einem anderen Aktualitätsmodell. Daten sind in der Regel innerhalb von 4 Stunden nach der zugrunde liegenden Nutzung verfügbar, können aber bis zu 24 Stunden dauern. Werte können überarbeitet werden, wenn verspätete Ereignisse eintreffen und Abgleiche laufen, bis etwa 7 Tage nach Ende des Kalendermonats. Beispielsweise können sich Werte für den 1. Oktober bis etwa zum 7. November ändern. Für rechnungstaugliche Summen frage nur Monate ab, die vor mindestens 7 Tagen geendet haben.

Wie Metriken definiert sind

Aktive Benutzer. Ein Benutzer gilt für einen Tag als aktiv, wenn eine der folgenden Bedingungen zutrifft:

• Er hat mindestens eine Chat-Nachricht in Claude gesendet.
• Er hatte mindestens eine Claude Code-Sitzung (lokal oder remote), die deiner Claude Enterprise-Organisation zugeordnet ist und Tool-Nutzung oder Git-Aktivität beinhaltete.
• Er hatte mindestens eine Cowork-Sitzung mit Tool-Nutzung oder Nachrichtenaktivität.

Chat and Cowork unified. Chat and Cowork unified bringt die Funktionen von Cowork in den claude.ai-Chat. Die meiste Aktivität in Chat and Cowork unified wird unter dem Produktwert chat_cowork_unified gemeldet, nicht unter chat oder cowork.

In der Benutzeraktivität sowie in der Skill-, Connector- und Plugin-Nutzung erscheint diese Nutzung im Objekt chat_cowork_unified_metrics. In Aktivitätszusammenfassungen wird sie in chat_cowork_unified_daily_active_user_count, chat_cowork_unified_weekly_active_user_count und chat_cowork_unified_monthly_active_user_count gezählt.

Wenn ein Benutzer Chat and Cowork unified zu verwenden beginnt, wandert seine Nutzung aus deinen Chat- und Cowork-Zahlen in die Zahlen für Chat and Cowork unified. Nutzung an Tagen, bevor ein Benutzer Chat and Cowork unified zu verwenden beginnt, bleibt unter Chat oder Cowork. Organisationsweite Zahlen wie die gesamte Token-Nutzung, die Gesamtkosten und die Gesamtzahl aktiver Benutzer ändern sich nicht. Nach Produkt gefilterte Kosten- und Nutzungsberichte lassen die Nutzung von Chat and Cowork unified aus, sofern products[] nicht chat_cowork_unified enthält.

Einige Aktivitäten von Benutzern von Chat and Cowork unified, etwa der Sprachmodus, können weiterhin unter Chat oder Cowork gemeldet werden. Die Aktivität eines Benutzers kann außerdem an dem Tag, an dem er Chat and Cowork unified zu verwenden beginnt, auf mehrere Produkte aufgeteilt werden. Dasselbe gilt für den Tag, an dem es für ihn deaktiviert wird. Wie sich die Aktivität aufteilt, ist nicht garantiert.

Ein Benutzer kann sowohl in den Chat- oder Cowork-Zahlen als auch in den Zahlen von Chat and Cowork unified erscheinen. Dies kann an einem Tag vorkommen, an dem er Chat and Cowork unified verwendet und ein Teil seiner Aktivität weiterhin unter Chat oder Cowork gemeldet wird. Wöchentliche und monatliche Zahlen können ihn in beiden enthalten, wenn das Zeitfenster Aktivität beider Arten aufweist, selbst an unterschiedlichen Tagen. Beispielsweise kann das Zeitfenster Tage vor und nach dem Beginn seiner Nutzung von Chat and Cowork unified umfassen.

Wenn du die Benutzeraktivität nach Projekt filterst, wird die Projektaktivität jedes Tages nur an einer Stelle gezählt. Wenn ein Benutzer an diesem Tag eine Chat-Nachricht in Chat and Cowork unified gesendet hat, wird seine gesamte Projektaktivität in chat_cowork_unified_metrics.chat gezählt. Andernfalls wird sie in chat_metrics gezählt.

Metrikblöcke pro Produkt. Metrikobjekte pro Produkt (zum Beispiel Office-Agent- oder Cowork-Metriken in einem Benutzeraktivitätsdatensatz) sind in jedem Datensatz immer vorhanden. Organisationen ohne Nutzung dieses Produkts sehen Zählwerte von 0 statt eines null-Objekts. Die Ausnahme ist Chat and Cowork unified: Bei Bereitstellungen, die es nicht anbieten, werden seine Felder in der Antwort weggelassen. Einzelne Felder innerhalb dieser Objekte können null sein, was bedeutet, dass der Wert nicht verfügbar ist. Wenn du beispielsweise die Benutzeraktivität nach Projekt filterst, ist distinct_skills_used_count in chat_metrics null. Die Claude Enterprise Analytics API-Referenz zeigt, welche Felder null sein können.

Connector-Namen. Connector-Namen werden über Quellen hinweg normalisiert. Zum Beispiel erscheinen Atlassian MCP server, mcp-atlassian und atlassian_MCP im Connector-Nutzungsendpunkt alle als atlassian.

Arbeiten mit der API

Paginierungs-Cursor sind an die Abfrage gebunden, die sie ausgegeben hat. Ändere bei den Kosten- und Nutzungsendpunkten die Abfrageparameter nicht mitten in einer Sequenz: Wenn du products[], group_by[], order_by, den Datumsbereich oder einen beliebigen Filter änderst und einen alten Cursor übergibst, gibt die Anfrage einen 400-Fehler zurück. Um Parameter zu ändern, beginne erneut bei der ersten Seite ohne Cursor.

Listenparameter verwenden Klammernotation. Wiederhole den Parameter für jeden Wert, zum Beispiel products[]=chat&products[]=claude_code.

Betragsfelder sind Dezimalzeichenfolgen in Cent. Währungsbeträge werden als Dezimalzeichenfolgen wie "41280.000000" zurückgegeben (was 412,80 $ USD entspricht). Um in Dollar umzurechnen, parse den Wert als Dezimalzahl und teile ihn durch 100. Vermeide binäres Gleitkomma-Parsing für Werte, die mehrere Millionen Dollar überschreiten könnten.

Ratenlimits gelten auf Organisationsebene, nicht pro Key, mit einem Standard von 60 Anfragen pro Minute über alle Endpunkte dieser API. Wenn das für deinen Anwendungsfall nicht ausreicht, wende dich an dein Anthropic-Account-Team, um eine Anpassung des Limits zu besprechen.

Versionierung

Sende bei jeder Anfrage den anthropic-version-Header; die verfügbaren Versionen findest du unter Versionen.

Bekannte Einschränkungen

Claude Code über Amazon Bedrock

Wenn deine Organisation Claude Code über Amazon Bedrock nutzt, gibt die Claude Enterprise Analytics API für diese Nutzung keine Claude Code-Aktivität zurück.

Claude Code und Cowork mit kundenverwalteten Verschlüsselungsschlüsseln

Wenn deine Organisation kundenverwaltete Verschlüsselungsschlüssel verwendet, lässt Anthropic zum Schutz deiner Daten einige Details der Claude Code- und Cowork-Nutzung aus seinen Nutzungsanalysen weg. Verwende daher die folgenden Zahlen der Claude Enterprise Analytics API nicht, um zu messen, wie stark deine Organisation Claude Code oder Cowork nutzt. Sie können 0 oder niedriger als die tatsächliche Nutzung sein:

• Codeänderungen: In der Benutzeraktivität können diese Felder in claude_code_metrics.core_metrics 0 sein: lines_of_code (hinzugefügte und entfernte Zeilen) und commit_count. Das Feld pull_request_count kann niedriger sein als die tatsächliche Anzahl der Pull Requests.
• Mit einem Slash-Befehl gestartete Skills: Wenn ein Benutzer einen Skill in Claude Code oder Cowork durch Eingabe eines Slash-Befehls wie /skill-name startet, wird diese Nutzung nicht gezählt. Dies gilt für die Skill-Nutzung und für Cowork-Skill-Zahlen in der Benutzeraktivität. Skills, die Claude ohne Slash-Befehl aufruft, werden weiterhin gezählt.

Für weitere Analyseänderungen mit kundenverwalteten Verschlüsselungsschlüsseln siehe Was CMEK auf Claude Enterprise abdeckt.

Nächste Schritte