Was ist die Usage and Cost Analytics API?
Laut den Release Notes der Claude Platform hat Anthropic die Usage and Cost Analytics API am 29. Oktober 2026 als Beta gestartet. Ihre Endpunkte /v1/organizations/analytics/usage und /v1/organizations/analytics/cost melden Token-Nutzung und Kosten für Organisationen in der Claude Console und in Claude Enterprise. Für Console-Organisationen ähneln die Daten laut Dokumentation dem, was die Seiten Usage und Cost in der Claude Console zeigen.
Jede Anfrage braucht den Header anthropic-beta: analytics-usage-cost-2026-08-24 und einen anthropic-version-Header. Das SDK und die ant-CLI senden beide Header automatisch und laden weitere Seiten nach.
Welche Auswertungen sind möglich?
Anthropic nennt vier Einsatzzwecke: Kosten zuordnen, Spitzenverbraucher finden, Zeitreihen bauen und eine einzige Integration für Console und Enterprise nutzen. Ergebnisse lassen sich nach bis zu fünf Dimensionen gruppieren, zum Beispiel Modell, Workspace, API-Schlüssel, Service-Tier oder der Identität hinter der Anfrage. Filter gibt es für die meisten Dimensionen, mit bis zu 100 Werten pro Filter.
- Zeitabschnitte: optional 1 Minute, 1 Stunde oder 1 Tag in UTC.
- Zeitraum: ab 1. Januar 2026, innerhalb der letzten 365 Tage, höchstens 31 Tage pro Anfrage, bei Minutenabschnitten höchstens 24 Stunden.
- Kosten: amount nach Rabatten und vor Guthaben, list_amount zu Listenpreisen, angegeben in Cent mit sechs Nachkommastellen.
Wer braucht welchen Schlüssel?
Organisationen in der Claude Console nutzen laut Dokumentation einen Admin-API-Schlüssel oder eine andere Admin-API-Berechtigung, etwa ein OAuth-Token mit dem Scope org:admin. Claude-Enterprise-Organisationen nutzen einen Schlüssel mit dem Scope read:analytics, den der Primary Owner in claude.ai erstellt, nachdem die Analytics API für die Organisation aktiviert wurde. Die Admin API ist für Einzelkonten nicht verfügbar.
Anthropic empfiehlt, dem Dienst, der die Daten sammelt, einen eigenen Schlüssel zu geben, ihn in einem Secrets-Manager zu speichern und regelmäßig zu rotieren, oder besser Workload Identity Federation mit kurzlebigen Tokens zu nutzen. Beide Endpunkte stehen laut Dokumentation auch auf Claude Platform on AWS und bei Claude Models on Google Cloud (Anthropic managed) zur Verfügung, dort mit der jeweiligen Cloud-Berechtigung.
Wie aktuell sind die Daten?
Jede Antwort enthält einen Zeitstempel data_refreshed_at. Daten aktualisieren sich laut Anthropic in der Regel innerhalb von 4 Stunden nach der Nutzung und können bis zu 24 Stunden brauchen. Werte können sich durch späte Ereignisse und Abgleich bis etwa 7 Tage nach Monatsende noch ändern. Für endgültige Summen empfiehlt Anthropic, nur Monate abzufragen, die seit mindestens 7 Tagen beendet sind.
Bei der alten Usage and Cost API erscheinen Daten laut Migrationstabelle typischerweise innerhalb von 5 Minuten. Unsere Einordnung, keine Herstelleraussage: Für Budget-Warnungen in Echtzeit ist die neue API deshalb weniger geeignet, für Monatsberichte und Kostenzuordnung dagegen gut.
Was wird aus den bisherigen Schnittstellen?
Die Usage and Cost API ist seit dem 29. Oktober 2026 eine Legacy-API, ebenso die Endpunkte usage_report, cost_report, user_usage_report und user_cost_report der Claude Enterprise Analytics API. Alle bleiben laut Anthropic unterstützt; für den Umstieg gibt es zwei Migrationsleitfäden. Die übrigen Endpunkte der Enterprise Analytics API sind nicht Legacy.
Für Enterprise-Organisationen nennt Anthropic als Vorteile unter anderem alle Gruppen in jedem Zeitabschnitt statt nur der Top 100 und die Gruppierung nach Akteur zusammen mit anderen Dimensionen. Außerdem hat Anthropic am 28. Oktober 2026 die maximale Anfragegröße für die Messages API und die Token Counting API in der Claude API von Anthropic von 32 MB auf 128 MB angehoben.
Was sollten Unternehmen jetzt tun?
Prüfen Sie, ob Sie heute Kostenberichte über die alte Usage and Cost API oder die Enterprise-Berichte ziehen. Testen Sie die neue API parallel mit einem eigenen, rotierten Schlüssel und vergleichen Sie die Summen eines abgeschlossenen Monats. Legen Sie fest, nach welchen Dimensionen Sie Kosten zuordnen, etwa Workspace pro Projekt oder Akteur pro Team, und bauen Sie darauf ein einfaches Monatsreporting auf.
Der kostenlose KI-Systemcheck hilft, KI-Kosten, Zuständigkeiten und Schlüsselverwaltung im Team zu ordnen. Die Hinweise hier sind Vorschläge, keine Kundenergebnisse.
Nachvollziehbar bleiben
Primärquellen
- Claude Platform Release Notes · 29.10.2026 und 28.10.2026Quellenstand:
- Claude Docs: Usage and Cost Analytics APIQuellenstand:






