Claude API Kosten: Neue Analytics-API zeigt Verbrauch

Wer Claude über die API einsetzt, kennt das Problem: Am Monatsende steht eine Summe auf der Rechnung, aber welcher Kunde, welches Projekt oder welche Person wie viel verursacht hat, ist schwer zu sagen. Genau da setzt eine neue Schnittstelle von Anthropic an.

Was passiert ist

Am 29. Oktober 2026 hat Anthropic die Usage and Cost Analytics API als Beta gestartet (Release Notes). Sie meldet Token-Verbrauch und Kosten für Organisationen in der Claude Console und in Claude Enterprise. Du kannst die Ergebnisse nach Modell, Workspace und API-Key filtern und gruppieren, außerdem nach dem Nutzer oder Service-Account hinter jeder Anfrage (Release Notes).

Gleichzeitig hat Anthropic die bisherige Usage and Cost API zur Legacy-API erklärt. Dasselbe gilt für die Endpunkte usage_report, cost_report, user_usage_report und user_cost_report der Claude Enterprise Analytics API. Alle bleiben unterstützt (Release Notes). Für neue Integrationen empfiehlt Anthropic die neue API, weil sie mehr Möglichkeiten zum Gruppieren und Filtern bietet (Doku Usage and Cost API).

Technisch besteht die neue API aus zwei Endpunkten. Der eine liefert Token und Anzahl der Anfragen, der andere die Kosten in US-Dollar. Jede Anfrage braucht den Beta-Header analytics-usage-cost-2026-08-24. Die offiziellen SDKs und das ant-Kommandozeilentool setzen ihn automatisch (Doku Analytics API).

Was die neue API konkret liefert

Stand: Oktober 2026, laut Anthropic-Dokumentation:

• Aufschlüsselung: Kosten und Verbrauch lassen sich nach Workspace, API-Key, Modell, Service-Tier oder der Identität hinter der Anfrage aufteilen. Pro Abfrage kannst du bis zu fünf Dimensionen kombinieren, ein Filter nimmt bis zu 100 Werte.
• Kosten mit zwei Zahlen: amount ist der Betrag nach Rabatten, aber vor Abzug von Guthaben. list_amount ist der Betrag zum Listenpreis. Die Währung ist immer USD, angegeben in Cent mit sechs Nachkommastellen.
• Kostenarten: Pro Modell trennt die API Token-Kosten nach Token-Art und zeigt Websuche, Code-Ausführung und Session-Nutzung als eigene Posten.
• Zeitraster: Optional teilst du die Ergebnisse in Minuten, Stunden oder Tage auf. Ohne Zeitraster bekommst du eine Summe für den ganzen Zeitraum.
• Rangliste: Standardmäßig sortiert die API nach dem größten Posten. Fragen wie „welcher API-Key kostet diesen Monat am meisten?“ beantwortet sie mit einer Abfrage.
• Claude Code pro Person: Mit dem Filter auf das Produkt Claude Code und der Gruppierung nach Person siehst du, wer im Team wie viel verbraucht.

Auch bei Claude über Google Cloud (von Anthropic betrieben) stehen beide Endpunkte zur Verfügung, dort mit Google-Cloud-Zugangsdaten statt Admin-Key (Doku Analytics API). Wie dieser Zugang funktioniert, habe ich in Claude auf Google Cloud: Anthropic-API über Marketplace beschrieben.

Alt gegen neu: die wichtigsten Unterschiede

	Alte Usage and Cost API	Neue Analytics API
Status	Legacy, weiter unterstützt	Beta
Beta-Header	nicht nötig	Pflicht
Datenaktualität	meist innerhalb von 5 Minuten	meist innerhalb von 4 Stunden, bis zu 24 Stunden
Zeitraum	beliebig	ab 1. Januar 2026, letzte 365 Tage, höchstens 31 Tage pro Anfrage
Kosten im Stunden- oder Minutenraster	nein, nur täglich	ja
Listenpreis zusätzlich	nein	ja (list_amount)

Quellen für die Tabelle: Migrationstabelle und Doku der alten API. Für Enterprise-Kunden kommt dazu: Die alten Berichte zeigen pro Zeitabschnitt nur die 100 größten Gruppen, die neue API zeigt alle (Doku Analytics API).

Wo die Grenzen liegen

Verzögerung und Nachkorrekturen. Die Werte können sich noch ändern, bis etwa 7 Tage nach Ende des Kalendermonats. Werte vom 1. Oktober können sich also bis etwa 7. November ändern. Anthropic rät, für endgültige Summen nur Monate abzufragen, die seit mindestens 7 Tagen vorbei sind (Doku Analytics API). Für eine Warnung „Budget fast erreicht“ in Echtzeit ist die neue API damit schlechter geeignet als die alte.

Priority Tier. Anfragen unter einer Priority-Tier-Zusage erscheinen im Verbrauch, tragen aber keine Token-Kosten bei. Die Gebühr für die Zusage wird getrennt abgerechnet und taucht in diesen Daten nicht auf (Doku Analytics API).

Nur für Organisationen. Für Einzelkonten gibt es die Admin API nicht. Organisationen in der Claude Console nutzen einen Admin-API-Key oder einen OAuth-Token mit dem Scope org:admin. Claude-Enterprise-Organisationen nutzen einen Key mit dem Scope read:analytics, den der Primary Owner in claude.ai erstellt, nachdem die Analytics API freigeschaltet ist (Doku Analytics API).

Was es für dich bedeutet

Wenn du Claude nur im Chat mit einem Pro- oder Team-Abo nutzt, ändert sich für dich nichts. Die Neuerung betrifft alle, die über die API abrechnen oder ein Enterprise-Konto verwalten.

Kosten pro Kunde abrechnen. Baust du Automatisierungen oder Apps für Kunden, lohnt sich eine einfache Regel: ein Workspace oder ein API-Key pro Kunde oder Projekt. Die API gruppiert die Kosten genau nach diesen Merkmalen (Doku Analytics API). Am Monatsende fragst du die Summe pro Workspace ab und hast die Grundlage für deine Rechnung. Denk daran, dass die Beträge in US-Dollar und vor Abzug von Guthaben kommen. Den Wechselkurs und eventuelle Guthaben musst du selbst einrechnen.

Team-Verbrauch sichtbar machen. Nutzt dein Team Claude Code, siehst du die Kosten pro Person. Das hilft bei der Frage, ob sich ein Platz im Abo oder die Abrechnung nach Verbrauch mehr lohnt. Was Claude Code in welchem Modell kostet, steht in Was kostet Claude Code? Preise, Pläne und Limits. Welche Tarife für Firmen infrage kommen, findest du in Claude für Unternehmen: Team, Enterprise und Kosten.

Ohne Programmierkenntnisse. Die Daten der neuen API ähneln dem, was die Seiten „Usage“ und „Cost“ in der Claude Console zeigen (Doku Analytics API). Für einen schnellen Blick reicht also die Console. Die API lohnt sich, sobald du jeden Monat dieselbe Auswertung brauchst. Ein kleines Skript dafür kannst du dir von Claude Code schreiben lassen, zum Beispiel so:

Schreibe mir ein Python-Skript, das über die Usage and Cost Analytics API
von Anthropic die Kosten des letzten abgeschlossenen Monats abfragt,
gruppiert nach Workspace. Lies den Admin-API-Key aus der Umgebungsvariable
ANTHROPIC_API_KEY. Rechne die Beträge von Cent in US-Dollar um und
speichere das Ergebnis als CSV-Datei mit den Spalten Workspace und Kosten.
Nutze das offizielle Anthropic-SDK und erkläre mir jeden Schritt.

Behandle den Admin-Key wie ein Passwort. Anthropic empfiehlt, dem Dienst, der die Daten abholt, einen eigenen Key zu geben, ihn in einem Secrets-Manager (einem geschützten Speicher für Zugangsdaten) abzulegen und regelmäßig zu wechseln (Doku Analytics API).

Bestehende Auswertungen. Hast du schon etwas auf der alten API gebaut, musst du nicht sofort handeln, denn sie bleibt unterstützt (Release Notes). Brauchst du schnelle Warnungen, bleib vorerst bei der alten API, die neue liefert die Daten erst Stunden später. Für Monatsabrechnungen pro Kunde ist die neue API die bessere Wahl.

Quellen

• Claude Platform Release Notes, Eintrag vom 29. Oktober 2026 (Primärquelle)
• Dokumentation: Usage and Cost Analytics API
• Dokumentation: Usage and Cost API (Legacy)

Häufige Fragen

Muss ich jetzt von der alten Usage and Cost API umsteigen?

Nein. Anthropic führt die alte Usage and Cost API als Legacy, sie bleibt aber unterstützt. Für neue Integrationen empfiehlt Anthropic die neue Usage and Cost Analytics API.

Kann ich die neue Analytics-API mit einem normalen Claude-Konto nutzen?

Nein. Die Admin API steht einzelnen Konten nicht zur Verfügung. Du brauchst eine Organisation in der Claude Console oder ein Claude-Enterprise-Konto. Die Console nutzt einen Admin-API-Key, Enterprise einen eigenen Analytics-Key.

In welcher Währung zeigt die API meine Claude-Kosten?

Immer in US-Dollar, angegeben in Cent. Der Betrag gilt nach Rabatten, aber vor Abzug von Guthaben. Zusätzlich liefert die API den Betrag zum Listenpreis.

Wie aktuell sind die Kostendaten?

Laut Anthropic sind die Daten meist innerhalb von 4 Stunden da, manchmal erst nach bis zu 24 Stunden. Endgültig sind die Werte erst etwa 7 Tage nach Ende des Kalendermonats.

Kann ich sehen, was einzelne Personen in Claude Code kosten?

Ja. Der Kosten-Endpunkt lässt sich auf das Produkt Claude Code filtern und nach Person gruppieren. Organisationen in der Claude Console können zusätzlich die Claude Code Analytics API nutzen.