Claude Usage and Cost Analytics API: Nutzung und Kosten pro Team auswerten
Am 29. Oktober 2026 hat Anthropic die Usage and Cost Analytics API als Beta veröffentlicht. Sie liefert historische Token-Nutzung und Kosten deiner Organisation, aufgeschlüsselt nach Modell, Workspace, API-Schlüssel oder dem Nutzer- bzw. Dienstkonto hinter jeder Anfrage, und zwar mit denselben Endpunkten für Claude Console und Claude Enterprise. claude-os.de ist ein unabhängiger Beratungsdienst der lol.marketing LLC und nicht mit Anthropic verbunden. Die Produktangaben stammen aus den verlinkten Quellen von Anthropic, Stand 30. Oktober 2026.
Was ist die Usage and Cost Analytics API?
Kurzantwort: Die Usage and Cost Analytics API ist seit dem 29. Oktober 2026 als Beta verfügbar. Der Endpunkt /v1/organizations/analytics/usage liefert Token- und Anfragezahlen, /v1/organizations/analytics/cost die Kosten in US-Dollar. Beide gelten für Organisationen in der Claude Console und in Claude Enterprise. Jede Anfrage braucht den Header anthropic-beta: analytics-usage-cost-2026-08-24 und einen anthropic-version-Header. Quelle: Claude Platform Release Notes.
Für Console-Organisationen ähneln die Daten laut Dokumentation dem, was die Seiten Usage und Cost in der Claude Console zeigen. Das SDK und die ant-CLI senden beide Header automatisch und laden weitere Seiten nach. Quelle: Claude Docs. Wie du API-Schlüssel und Kosten in der Console grundsätzlich organisierst, zeigt der Ratgeber Claude API-Key und Console-Kosten.
Welche Auswertungen sind möglich?
Anthropic nennt vier Einsatzzwecke: Kosten zuordnen, Spitzenverbraucher finden, Zeitreihen für Dashboards und Finanzberichte bauen und eine einzige Integration für Console und Enterprise nutzen. Ergebnisse lassen sich nach bis zu fünf Dimensionen gruppieren, etwa Modell, Workspace, API-Schlüssel, Service-Tier oder die Identität hinter der Anfrage. Die meisten Dimensionen haben einen Filter mit bis zu 100 Werten. Quelle: Claude Docs.
| Punkt | Was gilt |
|---|---|
| Zeitabschnitte | Optional 1 Minute, 1 Stunde oder 1 Tag (UTC) |
| Zeitraum | Ab 1. Januar 2026, innerhalb der letzten 365 Tage, höchstens 31 Tage pro Anfrage; mit Minutenabschnitten höchstens 24 Stunden |
| Kostenfelder | amount nach Rabatten und vor Guthaben, list_amount zu Listenpreisen, in Cent mit sechs Nachkommastellen |
| Aktualität | Meist innerhalb von 4 Stunden, bis zu 24 Stunden; Korrekturen bis etwa 7 Tage nach Monatsende |
| Seitengröße | limit 1 bis 1.000 Zeilen, Standard 20 |
Quelle der Tabelle: Claude Docs.
Wer braucht welchen Schlüssel?
Console-Organisationen nutzen 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 aktiviert wurde. Für Einzelkonten ist die Admin API nicht verfügbar. Quelle: Claude Docs.
Anthropic empfiehlt, dem sammelnden Dienst 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 gibt es laut Dokumentation auch auf Claude Platform on AWS und bei Claude Models on Google Cloud (Anthropic managed), dort mit der jeweiligen Cloud-Berechtigung. Quelle: Claude Docs.
Was wird aus der alten Usage and Cost API?
Seit dem 29. Oktober 2026 ist die Usage and Cost API eine Legacy-API, ebenso die Endpunkte usage_report, cost_report, user_usage_report und user_cost_report der Claude Enterprise Analytics API. Alle bleiben unterstützt; für den Umstieg gibt es zwei Migrationsleitfäden. Quelle: Claude Platform Release Notes.
- Aktualität: Bei der alten API erscheinen Daten typischerweise innerhalb von 5 Minuten, bei der neuen meist innerhalb von 4 Stunden.
- Struktur: Statt Zeitabschnitten mit Ergebnislisten liefert die neue API Zeilen, sortiert nach einer Kennzahl deiner Wahl; Kombinationen ohne Nutzung erscheinen nicht.
- Enterprise: Alle Gruppen in jedem Zeitabschnitt statt nur der Top 100, dazu Gruppierung nach Akteur zusammen mit anderen Dimensionen.
Quelle der Liste: Claude Docs, Migrationsabschnitte. Ebenfalls neu: Seit dem 28. Oktober 2026 dürfen Anfragen an die Messages API und die Token Counting API in der Claude API von Anthropic bis zu 128 MB groß sein statt 32 MB. Quelle: Claude Platform Release Notes.
Was solltest du jetzt tun?
Unsere Einordnung, keine Herstelleraussage: Die neue API ist stark für Monatsberichte und Kostenzuordnung je Team oder Projekt. Für Budget-Warnungen in Echtzeit ist sie wegen der längeren Aktualisierungszeit weniger geeignet.
- Bestand prüfen: Kläre, ob ihr heute Kostenberichte über die alte Usage and Cost API oder die Enterprise-Berichte zieht.
- Parallel testen: Richte einen eigenen, rotierten Schlüssel ein und vergleiche die Summen eines abgeschlossenen Monats.
- Zuordnung festlegen: Entscheide, nach welchen Dimensionen ihr Kosten verteilt, etwa Workspace pro Projekt oder Akteur pro Team. Für Claude Code hilft zusätzlich Claude Code Kosten.
- Reporting aufbauen: Frage für endgültige Summen nur Monate ab, die seit mindestens 7 Tagen beendet sind.
Die Schritte sind unsere Empfehlung auf Basis der Angaben von Anthropic, keine Kundenergebnisse. Kostenreporting besprechen: Wir helfen dir im Rahmen unserer Claude-API-Beratung.
Quellen und Produktstand
Produktangaben wurden am 30. Oktober 2026 geprüft. Der Zugang kann je nach Tarif und Rollout abweichen.