Claude Platform Docs
AdminClaude Platform OAuth

Claude Platform OAuth

Lass deine Kunden die Claude-Nutzung in deinem Produkt über ihre eigene Claude-Organisation bezahlen.

Mit Claude Platform OAuth können deine Nutzer die Nutzung innerhalb deiner App ihrer Claude-Organisation in Rechnung stellen.

Was du bauen kannst

Lass Kunden ihre eigene Claude-Nutzung bezahlen

Wenn dein Produkt Claude aufruft, kann die Nutzung der eigenen Claude-Organisation deiner Kunden in Rechnung gestellt werden. Deine Nutzer klicken auf eine Schaltfläche Link your Claude organization, melden sich bei Claude an und genehmigen deine App. Für Linked billing muss der Nutzer in seiner Claude-Organisation die Rolle Admin oder Abrechnung haben.

Danach gilt:

  • Du entscheidest bei jeder Claude API-Anfrage, ob der Kunde zahlt oder du zahlst.
  • Wenn eine Anfrage, die du für den Kunden markierst, ihm nicht in Rechnung gestellt werden kann, lehnt die Claude API sie ab, anstatt sie dir in Rechnung zu stellen.
  • Der Kunde kann die Verknüpfung mit deiner App jederzeit aufheben.
  • Du darfst einem Kunden nur die Anfragen in Rechnung stellen, die du auf seine Anweisung stellst, niemals deine eigene Nutzung.

Du unterstützt deine Kunden: Anthropic stellt die Genehmigungsseite und die Claude Console-Seite bereit, auf der sie eine Ausgabenobergrenze festlegen oder die Verknüpfung mit deiner App aufheben, und alle anderen Fragen zu deiner App kommen zu dir.

Linked billing funktioniert für Kunden, deren Claude-Organisation Anthropic direkt für ihre API-Nutzung bezahlt. Es funktioniert nicht für Organisationen, die über einen Cloud-Marketplace abgerechnet werden. Siehe Linked billing.

So funktioniert es

Linked billing folgt einem kurzen Ablauf. Die Person verlässt dein Produkt einmal für die Genehmigungsseite von Claude, genehmigt dort deine App und kehrt zurück:

Browser
Dein Backend
auth.claude.com
Auf „Link your Claude organization“ klicken
Die Person zur Genehmigungsseite von Claude weiterleiten
Bei Claude anmelden und deine App genehmigen
Die Person mit einem einmaligen Code zu deinem Produkt zurückschicken
Den Code übergeben
Den Code eintauschen
Eine Verbindungs-ID

Die Genehmigungsseite zeigt den Namen deiner App und an, was deine App anfordert, damit die Person weiß, was sie genehmigt.

Einmalige Einrichtung der OAuth-App

Linked billing beginnt mit diesen einmaligen Einrichtungsschritten in der Claude Console. Der Leitfaden Linked billing führt dich durch sie.

  1. Erstelle die App. Ein Mitglied deiner Claude-Organisation mit der Rolle Admin erstellt in der Claude Console eine OAuth-App und kopiert deren „client ID“ (Client-ID). Die App enthält den Namen, den Personen auf der Genehmigungsseite sehen, sowie die Adresse in deinem Produkt, zu der sie zurückkehren.
  2. Richte die Client-Authentifizierung ein. Anstelle eines „client secret“ (Client-Geheimnis) weist dein Back-End nach, dass eine Anfrage von deiner App stammt, und zwar mit einem kurzlebigen Token deines eigenen „identity provider“ (Identitätsanbieter), etwa AWS, Google Cloud, Microsoft Entra ID oder Kubernetes. Du wählst den Identitätsanbieter und welche seiner Token akzeptiert werden, auf dem Tab Client authentication der App aus.
  3. Richte die Identität deines Back-Ends ein. Erstelle ein Dienstkonto und eine zweite Föderationsregel mit Workload Identity Federation, und wähle das Dienstkonto als Operator-Dienstkonto der App aus.

Nächste Schritte

Der Leitfaden Linked billing führt dich durch die Einrichtung und deinen ersten verknüpften Kunden.

Lass deine Kunden die Claude-Nutzung in deinem Produkt über ihre eigene Claude-Organisation bezahlen

Endpunkte, Parameter, Token-Antworten, Lebensdauern und Fehler

War diese Seite hilfreich?