Claude APIのLinked billingがbeta開始 — 利用料を顧客の組織に請求できる
2026年11月17日、Claude APIにLinked billingがbetaで登場。顧客が自分のClaude組織を連携すると、アプリ経由の利用料をbilling_policyでリクエストごとに顧客払いにできます。
2026年11月17日のAPIリリースノートに、Linked billingがbetaで載りました。Claude APIを組み込んだアプリの利用料を、アプリ側ではなく、顧客自身のClaude組織に請求できる仕組みです。betaヘッダーは user-profiles-billing-2026-10-01 です。
要点
Linked billingでできるようになること
- 顧客が自分のClaude組織をアプリに一度連携すると、そのアプリ経由の利用料を顧客の組織が払えるようになる
- 誰が払うかは、
/v1/messagesと/v1/chat/completionsのリクエストごとにbilling_policyで選ぶ - 顧客はClaude Consoleでアプリごとの支出上限を設定でき、いつでも連携を解除できる
- 対象は、Anthropicに直接API利用料を払っている組織だけ。クラウドマーケットプレイス経由や、サブスクリプションだけの組織は対象外
- betaなので、エンドポイントやパラメータ、挙動は変わる可能性がある
アプリ開発者にとっては、利用料を自前で立て替えて請求し直す構成を、Anthropic側の仕組みに置き換えられる更新です。
あなたの利用フローはどう変わるか
アプリ開発者(請求を受け持つ側)
連携の準備は、アプリごとに一度だけ行う設定と、顧客ごとに繰り返す手順に分かれます。
Linked billingを使い始めるまでの流れ
- 1
Consoleでアプリを登録する
組織のAdminがOAuth appsのページでアプリを作ります。アプリ名とリダイレクトURIを入れ、権限は「Bill and link to organizations」を選びます。
- 2
バックエンドの認証を設定する
クライアントシークレットは発行されません。代わりに、自分のIDプロバイダーが署名したJWTをクライアントアサーションとして送ります。
- 3
サービスアカウントと既定ワークスペースを決める
推論リクエストを送るサービスアカウント(オペレーター)を指定し、アプリの既定ワークスペースも選びます。ワークスペースが無いと、後段のコード交換が
unauthorized_clientで拒否されます。 - 4
顧客ごとにユーザープロファイルを作り、連携する
顧客1社につきユーザープロファイルを1つ作り、PAR(Pushed Authorization Request)で承認ページへ送ります。顧客がAdminかBillingの役割で承認すると、コード交換で
connection_idが返ります。 - 5
リクエストに billing_policy を付ける
顧客が払うリクエストだけに
bill_to: "user_profile"を付けます。自分で払うリクエストはbill_to: "self"にするか、billing_policyごと省きます。
顧客払いのリクエストは、次のような形になります(ドキュメントのPython例に沿った形です)。
client.beta.messages.create(
model="claude-opus-5-5",
max_tokens=1024,
messages=[{"role": "user", "content": prompt}],
betas=["user-profiles-billing-2026-10-01"],
extra_headers={
"anthropic-user-profile-id": user_profile_id,
},
extra_body={
"billing_policy": {
"type": "billing_policy",
"bill_to": "user_profile",
}
},
)anthropic-user-profile-id には、その顧客の連携を持つユーザープロファイルのIDを入れます。billing_policy を付けるリクエストには、betaヘッダーも必要です。
誰が払うかは、リクエストの書き方で決まります。
| 書き方 | 払う人 | betaヘッダー |
|---|---|---|
bill_to: "user_profile" | 払う人顧客の組織 | betaヘッダー必要 |
bill_to: "self" | 払う人アプリ側の組織 | betaヘッダー必要 |
billing_policy を省く | 払う人アプリ側の組織 | betaヘッダー任意 |
顧客の払いにしたリクエストを自分の払いに切り替えたいときは、bill_to: "self" で送り直せます。顧客の側で拒否された場合も、この手が残ります。
顧客(Claude組織の管理者)
連携を承認できるのは、顧客のClaude組織でAdminかBillingの役割を持つ人です。アプリ側のボタンから auth.claude.com の承認ページに移り、サインインして次の画面を順に進みます。
- 組織の選択(選べる組織が複数あるときだけ)
- 課金の仕組みの説明
- 月間の支出上限の設定
- 「Link and authorize」ボタンのある最後の画面
承認ページは、ブラウザーでサインイン中のClaudeアカウントの組織しか出しません。個人アカウントでサインインしていると、仕事用の組織が選べません。アプリ側はアカウントを指定できないので、承認前に「どのアカウントで入っているか」を顧客に確かめてもらう案内が要ります。
連携はユーザー個人ではなく、組織に紐づきます。承認した人が組織を抜けても、連携は有効なままです。顧客はConsoleの「Linked platforms」ページで、アプリごとの当月の費用を見たり、支出上限を変えたり、連携を解除したりできます。
対象になる顧客と使えない条件
払える組織は限られる
連携できるのは、Anthropicに直接API利用料を払っている組織です。前払いクレジットも請求書払いも対象に入ります。次の組織は対象外で、リクエストは403の user_profile_not_billable で拒否されます。
- AWS、Google Cloud、Azureのマーケットプレイス経由で請求される組織
- Claudeのサブスクリプションプランだけを持つ組織
クレジットにも条件があります。Claude Max、Ultra、Teamの各プランに付く月間APIクレジットや、パートナー、VC、スタートアップのプログラムのクレジットは、この支払いには使えません。支払える残高が無いと、リクエストは402になります。
データの扱いは顧客側の契約に従わない
リクエストはアプリ側の組織で実行されます。つまり、レート制限、モデルへのアクセス、サービスティア、データ保持、暗号化キーは、アプリ側の設定が適用されます。顧客が結んでいるZDR(ゼロデータ保持)、BAA、CMEK(顧客管理の暗号化キー)は、これらのリクエストには効きません。HIPAA、FERPA、CMEKの対応が必要な顧客は、連携の対象にしない扱いです。
使えるエンドポイント
| エンドポイント | 顧客払い |
|---|---|
/v1/messages | 顧客払い対応(課金対象のコード実行機能を使う場合は400) |
/v1/chat/completions | 顧客払い対応 |
/v1/messages/count_tokens | 顧客払いbilling_policy を受け付けて無視する |
/v1/messages/batches | 顧客払い未対応 |
Message Batchesで bill_to: "user_profile" を指定した個別リクエストは、invalid_request_error で失敗します。顧客にも自分にも課金されず、同じバッチの他のリクエストは通常どおり動きます。
背景・文脈
User Profilesの上に載った課金の帰属
Linked billingは、ユーザープロファイルの仕組みを前提にしています。プロファイルは、アプリ側の組織の中にある「顧客1社を表す記録」で、リクエストごとにそのIDを送ることで、Anthropicはどの顧客のリクエストかを判断します。プロファイルの作り方とヘッダーの付け方は、Claude APIのUser Profilesでエンドユーザーを識別する手順にまとめています。
連携の単位に注意が要ります。1つのアプリの中で、顧客のClaude組織と、アプリ側のユーザープロファイルは1対1です。顧客の複数チームが同じ組織を共有しているなら、プロファイルは1つにします。チームごとに別の組織を持つなら、組織の数だけ作ります。
すでに利用者1人ごとにプロファイルを持っている場合は、顧客の組織用にプロファイルをもう1つ作り、そちらを連携する案内です。顧客払いのリクエストには顧客のプロファイルIDを送り、利用者個人は metadata.user_id に不透明な識別子で載せます。名前やメールアドレス、電話番号は入れません。
再販のように利用者がさらに先にいる構成では、プロファイルを作るときに access_type: "passthrough" を付けます。サンプルは省略していて、省略時は application のプロファイルになります。同じ reference_id で作成しても毎回新しいプロファイルができるため、保存したIDを使い回します。
失敗は黙って自分の払いにならない
顧客払いを指定したリクエストは、顧客に請求されるか、拒否されるかのどちらかです。アプリ側に黙って請求が回ることはありません。拒否のコードは次のとおりです。
| ステータスとコード | 意味 | 再試行 |
|---|---|---|
403 user_profile_not_billable | 意味顧客に請求できない。理由はレスポンスに出ない | 再試行原則しない |
402 linked_organization_billing_unavailable | 意味組織が停止中、または返信の途中でクレジットが尽きた | 再試行しない |
402 linked_organization_spend_limit_reached | 意味支出上限に達した、または払えるクレジットが無い | 再試行しない |
503 overloaded_error | 意味顧客に請求できるか判断できなかった | 再試行バックオフ付きで再試行 |
400 user_profile_required | 意味anthropic-user-profile-id ヘッダーが無い | 再試行ヘッダーを足す |
/v1/chat/completions では、同じステータスとメッセージがOpenAI形式で返り、コードは付きません。成功レスポンスには誰が払ったかが載らないので、顧客払いで送ったリクエストはアプリ側で記録しておく必要があります。
user_profile_not_billable は原因が複数あります。リクエストの認証がオペレーターのサービスアカウントでない、ヘッダーが連携していないプロファイルを指している、連携が解除された、顧客の組織が対象外、のいずれかです。連携し直して直るのは一部だけです。新しい連携は、コード交換のあと約10秒で効くことがあるため、その間の拒否だけは再送で通ります。
顧客の支出上限
顧客は、アプリごとに月間の支出上限をUSDで決められます。組織全体の月間支出上限とは別のもので、どちらかに達するとアプリが顧客払いにしたリクエストは拒否されます。上限に達した拒否は、翌月1日の0時(UTC)か、顧客が上限を上げるか外すまで続きます。
上限の読み取りはアプリ側からはできません。顧客の上限の値も、使用済みの額も取得できないので、上限に達したときは402を受けて顧客に案内する設計になります。アプリが公開されるまでは、上限の設定が必須で、最大額は50ドルです。公開後は上限なしでも連携でき、顧客がConsoleから上限を外すこともできます。
アプリの公開には、ホームページのドメインをDNSのTXTレコードで証明し、Anthropicの審査を受ける手順が入ります(請求書払いの組織は、ダイアログでの確認だけで公開されます)。審査中や公開前は、Test usersに登録した人しか連携できません。
連携後の運用
アプリ側のバックエンドから、連携の状態を次のように確認できます。
- ユーザープロファイルの取得で、
connection_statusがconnected/disconnected/not_connectedのどれかを返す(user-profiles-search-2026-08-30のbetaヘッダーが必要) POST /v1/user_profiles/{id}/unlinkか、OAuthの失効エンドポイントで連携を解除する- Usage and Cost Analytics APIを
user_profile_idでグループ化し、プロファイルごとの利用量と費用を見る
顧客が連携を解除しても、Anthropicからアプリへの通知(Webhookやメール)はありません。次のリクエストが user_profile_not_billable で返って初めて気づくので、状態の取得を定期的に回す運用が現実的です。connected は「連携が有効」という意味だけで、リクエストの成功は保証しません。
顧客払いは責任の置き場所も動かす
Linked billingで動くのは請求書の宛先だけではありません。「この利用は顧客が頼んだものか」という判断も、アプリ側に残ります。bill_to: "user_profile" は、顧客が指示したリクエストにだけ付ける決まりで、テストや評価、他の顧客のための処理を顧客に請求してはいけません。Claude APIは、その区別を代わりに確かめてくれません。
もう1点、既定の構成ではアプリのサービスアカウントが、連携済みの全顧客に請求できます。別の顧客のプロファイルIDを入れてしまっても、エラーは出ず、そのプロファイルの組織に請求されます。顧客ごとにトークンを分けて、請求先を取り違えない構成にもできます。ただし、接続ごとのアクセストークンを使うリクエストの有効化は、betaの間はAnthropicのアカウントチームに問い合わせる扱いです。
User Profilesのenforcement_statusで制限・BANを確かめる手順が扱うように、プロファイルは利用者の管理にも使われます。請求の帰属先も同じプロファイルに集まるため、顧客と連携組織の対応表は、アプリの設計の早い段階で決めておく項目になります。Anthropicは顧客がどの組織を連携したかを教えないので、未連携の別組織を選ばれても、アプリ側からは気づけないことがあります。すでに別のプロファイルへ連携済みの組織なら、承認時に user_profile_already_linked で拒否されます。
まとめ
- アプリ開発者: 利用料を立て替えて請求し直している場合、顧客の組織に直接払ってもらう選択肢が増えました。対象はAnthropicに直接払う組織だけで、betaの仕様変更に備えが要ります
- 顧客のデータ要件がZDR、BAA、CMEKに及ぶ場合: 顧客払いのリクエストはアプリ側の組織で実行されるため、連携の対象から外す扱いです
- 顧客の組織管理者: AdminかBillingの役割で承認します。アプリごとの支出上限は、Consoleの「Linked platforms」ページで上げ下げや解除ができます
- 運用担当者: 解除の通知が来ないので、連携状態の取得と、402や403の処理を最初に組み込みます
- 支出上限の考え方はClaude Spend Limits APIで支出上限と増額申請を管理する、認証の土台となるサービスアカウントはWIF認証とはが参考になります
参照した一次ソース
この記事の記述は、次の一次ソースと照合しています。更新時に参照先が変わった場合は一覧も更新します。