Claude API Linked Billing: Kunden zahlen selbst
// kurz gesagt
Anthropic hat am 17. November 2026 Linked Billing als Beta gestartet. Dein Kunde verknüpft seine eigene Claude-Organisation per OAuth mit deiner App, und du legst pro API-Anfrage fest, wer die Claude-Nutzung bezahlt. Der Kunde kann in der Claude Console ein monatliches Ausgabenlimit für deine App setzen und die Verknüpfung jederzeit lösen. Seine eigenen Vereinbarungen zu Zero Data Retention oder Verschlüsselung gelten für diese Anfragen nicht.
Was passiert ist
Anthropic hat am 17. November 2026 Linked Billing als Beta gestartet. Das steht in den Release Notes der Claude-Plattform. Die Idee: Deine Kunden bezahlen die Claude-Nutzung in deiner App über ihre eigene Claude-Organisation. Der Kunde verknüpft seine Organisation einmal mit deiner App. Danach legst du bei jeder Anfrage über das Feld billing_policy fest, wer zahlt. Das funktioniert laut Release Notes für die Endpunkte /v1/messages und /v1/chat/completions (Stand: November 2026).
Die Dokumentation zu Linked Billing beschreibt drei Fälle:
| Einstellung in der Anfrage | Wer zahlt die Claude-Nutzung |
|---|---|
bill_to: "user_profile" | dein Kunde |
bill_to: "self" | du |
kein billing_policy | du |
Wichtig für deine Kalkulation: Kann Anthropic eine Anfrage nicht dem Kunden berechnen, wird sie abgelehnt. Anthropic bucht sie laut dem Abschnitt Expected errors nie stillschweigend auf deine Rechnung um.
Wie verknüpft ein Kunde seine Organisation?
Du legst in der Claude Console eine OAuth-App an. Für jeden Kunden erzeugst du ein Nutzerprofil und schickst ihn per Weiterleitung auf eine Freigabeseite von Anthropic. Dort wählt er seine Organisation, liest eine Erklärung zur Abrechnung, kann ein monatliches Ausgabenlimit eintragen und bestätigt mit „Link and authorize“. Die Schritte stehen im Abschnitt zur Kundensicht der Dokumentation.
Zwei Details solltest du deinen Kunden vorab sagen:
- Rolle: Freigeben kann nur, wer in der Kunden-Organisation die Rolle Admin oder Billing hat. So steht es in der Dokumentation.
- Konto: Die Freigabeseite nutzt das Claude-Konto, das im Browser gerade angemeldet ist. Das kann ein privates statt des Firmenkontos sein, und deine App kann das Konto nicht vorgeben.
Die Einrichtung auf deiner Seite ist Entwicklerarbeit. Die App authentifiziert sich laut Dokumentation ohne Client Secret, über eine signierte JWT-Assertion und einen Service-Account. Wenn du ohne Programmierkenntnisse mit Claude baust, brauchst du dafür jemanden, der OAuth sauber umsetzen kann.
Welche Kunden können so zahlen?
Nicht jeder. Laut dem Abschnitt Eligible customers and endpoints muss die Organisation des Kunden ihre API-Nutzung direkt bei Anthropic bezahlen, per Prepaid-Guthaben oder auf Rechnung. Ausgeschlossen sind Organisationen, die über einen Cloud-Marktplatz (AWS, Google Cloud oder Azure) abgerechnet werden, und solche, die nur ein Claude-Abo haben.
Auch nicht jedes Guthaben zählt. Die monatlichen API-Guthaben aus den Plänen Claude Max, Ultra und Team können diese Anfragen nicht bezahlen, ebenso wenig Guthaben aus Anthropics Partner-, VC- und Startup-Programmen. Das regelt der Abschnitt Which credits can pay.
Für viele deiner Kunden heißt das: Ein Claude-Abo reicht nicht. Sie brauchen eine Organisation auf der Claude-Plattform mit eigenem API-Guthaben.
Wie funktioniert das Ausgabenlimit?
Der Kunde kann für deine App ein monatliches Limit in US-Dollar setzen, entweder schon auf der Freigabeseite oder später in der Console auf der Seite „Linked platforms“. Die Regeln aus dem Abschnitt Spend caps (Stand: November 2026):
- Ist das Limit erreicht, lehnt die API Anfragen auf Kosten des Kunden mit einem Fehler 402 ab. Das gilt bis 00:00 UTC am ersten Tag des Folgemonats oder bis der Kunde das Limit anhebt oder entfernt.
- Das kleinste Limit ist 0 US-Dollar. Damit wird jede Anfrage abgelehnt, die du diesem Kunden berechnen willst.
- Das Limit rechnet mit Listenpreisen für Token und Websuche, vor ausgehandelten Rabatten. Die tatsächliche Rechnung des Kunden kann davon abweichen.
- Du kannst weder das Limit eines Kunden noch den verbrauchten Anteil auslesen.
Solange deine App noch nicht veröffentlicht ist, gelten engere Grenzen. Im Test ist ein Limit Pflicht, und es liegt bei höchstens 50 US-Dollar, wie die Tabelle While your app is in testing zeigt. Verknüpfen können in dieser Phase nur Personen auf deiner Liste der Testnutzer.
Der Kunde kann deine App außerdem jederzeit trennen. Anthropic benachrichtigt dich dann nicht, weder per Webhook noch per E-Mail. Du merkst es daran, dass Anfragen auf Kosten dieses Kunden mit einem Fehler 403 zurückkommen.
Was gilt nicht, wenn der Kunde zahlt?
Die Anfragen laufen weiter in deiner Organisation. Es gelten also deine Rate-Limits, dein Modellzugang, deine Datenaufbewahrung und deine Schlüssel. Die Vereinbarungen des Kunden greifen laut Dokumentation für diese Nutzung nicht. Anthropic nennt ausdrücklich Zero Data Retention (ZDR), ein Business Associate Agreement (BAA) und kundeneigene Verschlüsselungsschlüssel (CMEK). Kunden, die für diese Nutzung HIPAA-, FERPA- oder CMEK-Abdeckung brauchen, sollst du gar nicht erst verknüpfen.
Dazu kommen zwei technische Lücken in der Beta:
- Batches: Die Message Batches API unterstützt die Abrechnung über den Kunden derzeit nicht.
- Code-Ausführung: Eine Anfrage auf Kosten des Kunden darf keine kostenpflichtige Code-Ausführung nutzen, sonst antwortet die API mit einem Fehler 400.
Beides rechnest du weiter über dich ab.
Was es für dich bedeutet
Du musst Token-Kosten nicht mehr vorstrecken. Bei Anfragen mit bill_to: "user_profile" landet die Claude-Nutzung auf der Rechnung des Kunden bei Anthropic. Dein Kostenrisiko durch einzelne Vielnutzer sinkt. Linked Billing regelt aber nur, wer Anthropic bezahlt. Dein eigenes Preismodell für die App musst du weiterhin selbst festlegen.
Plane die Ablehnung ein. Erreicht ein Kunde sein Limit oder hat er kein Guthaben mehr, steht deine App für ihn still, bis du reagierst. Du kannst die abgelehnte Anfrage auf eigene Kosten erneut senden oder dem Kunden einen klaren Hinweis zeigen. Weil du sein Limit nicht siehst, kannst du ihn nicht vorwarnen. Den Verbrauch pro Kundenprofil siehst du mit Verzögerung über die Analytics-API für Claude-API-Kosten.
Ordne Anfragen sauber zu. Die Zugangsdaten deines Service-Accounts können laut Dokumentation jeden verknüpften Kunden belasten. Nennt eine Anfrage das falsche Profil, zahlt die falsche Organisation, und kein Fehler weist dich darauf hin. Eine erfolgreiche Antwort sagt auch nicht, wer bezahlt hat. Führe deshalb ein eigenes Protokoll. Die Zugangsdaten gehören so geschützt wie jeder API-Key, etwa mit der IP Allowlist für die Claude API.
Kläre den Datenschutz vor dem Verknüpfen. Wer bei Anthropic ZDR vereinbart hat, verlässt sich darauf. In deiner App gilt das nicht, auch wenn der Kunde die Rechnung zahlt. Sag das deinen Kunden offen, bevor sie auf „Link and authorize“ klicken. Die Grundlagen stehen im Ratgeber Ist Claude DSGVO-konform?.
Setze noch kein Produkt allein darauf. Anthropic stuft Claude Platform OAuth als Beta-Dienst ein. Endpunkte, Parameter und Verhalten können sich ändern, und der Dienst ist laut Dokumentation möglicherweise nicht für den Produktivbetrieb geeignet. Vor dem Start für alle Kunden musst du die App veröffentlichen. Hat deine Organisation keine Abrechnung auf Rechnung, weist du dabei die Kontrolle über deine Domain nach, und Anthropic prüft die App.
Du überlegst noch, ob du überhaupt auf der API bauen willst? Der Ratgeber App mit Claude erstellen zeigt die Wege dorthin.
Quellen
- Claude Platform Release Notes, Eintrag vom 17. November 2026
- Dokumentation: Linked Billing (Organization billing connections)
Häufige Fragen
Was ist Claude API Linked Billing?
Linked Billing ist eine Beta-Funktion der Claude-Plattform, gestartet am 17. November 2026. Kunden verknüpfen ihre eigene Claude-Organisation mit deiner App und bezahlen die Claude-Nutzung darin selbst. Du bestimmst pro Anfrage über das Feld billing_policy, ob der Kunde oder du zahlst.
Welche Kunden können über Linked Billing zahlen?
Nur Organisationen, die ihre API-Nutzung direkt bei Anthropic bezahlen, per Prepaid-Guthaben oder auf Rechnung. Organisationen, die über AWS, Google Cloud oder Azure abgerechnet werden oder nur ein Claude-Abo haben, sind laut Dokumentation ausgeschlossen (Stand: November 2026).
Was passiert, wenn das Ausgabenlimit des Kunden erreicht ist?
Die Claude API lehnt Anfragen, die du dem Kunden berechnest, mit einem Fehler 402 ab. Das gilt bis 00:00 UTC am ersten Tag des Folgemonats oder bis der Kunde das Limit anhebt oder entfernt. Du kannst die Anfrage auf eigene Kosten erneut senden.
Zahle ich, wenn die Abrechnung beim Kunden scheitert?
Nein. Laut Anthropic wird eine Anfrage, die du dem Kunden zuordnest, entweder dem Kunden berechnet oder abgelehnt. Eine stille Umbuchung auf deine Rechnung gibt es nicht.
Gilt die Zero-Data-Retention-Vereinbarung meines Kunden bei Linked Billing?
Nein. Die Anfragen laufen in deiner Organisation, also gelten deine Einstellungen zu Datenaufbewahrung und Verschlüsselung. Zero Data Retention, ein BAA oder kundeneigene Schlüssel des Kunden greifen für diese Nutzung laut Dokumentation nicht.
Du willst das selbst ausprobieren?
Im KI-Tutoring baust du mit mir an deinem eigenen Projekt. Allein oder in einer kleinen Gruppe, 100 % online.
15 Minuten kennenlernen