Skip to content

Cost and FinOpsAnalysis

Anthropic linked billing beta: can customers pay for Claude?

On November 17 Anthropic put linked billing in beta: a customer links their own Claude organization, and you mark each request as billed to them or to you. This piece maps what changes in ownership and what controls stay on your side.

By INFRO Editorial

Published

7 min read

Glowing token streams being compressed into a precise efficient AI infrastructure pipeline

In short

Yes, in beta and for a narrow set of customers: those whose Claude organization pays Anthropic directly can be billed per request, while the requests still run in your organization under your limits and retention terms 12. The invoice moves to the customer; the account, rate limits, key and most of the attribution and budget work stay with you.

Key takeaways

  • Linked billing moves the invoice to the customer's Claude organization, but requests still run in your organization, so your rate limits, model access, service tier, data retention and encryption keys apply.
  • Only customers whose organization pays Anthropic directly are eligible; AWS, Google Cloud or Azure billing and subscription-only organizations get a 403 user_profile_not_billable.
  • It is a beta that Anthropic says might not be suitable for production use, so keep a fallback path where you pay and bill the customer yourself.
  • The customer's Console cap and a 402 refusal do not tell your app why a request failed, so you still need your own per-customer cap, a reset time to show, and a usage ledger.
  • A gateway's estimates measure what passed through it; whether linked-billing fields pass through your gateway is something to test, not assume.

What Anthropic shipped on November 17

Anthropic announced Linked billing in beta on November 17, behind the user-profiles-billing-2026-10-01 beta header. A customer links their own Claude organization to your app, and you then set billing_policy on each /v1/messages or /v1/chat/completions request to choose who pays. In the Claude Console the customer can set a spend cap for your app or unlink it.1

Two cautions before the mechanics. Anthropic labels Claude Platform OAuth a beta service whose endpoints, parameters and behavior can change, and says it might not be suitable for production use.2 And the arrangement is narrower than "customers pay Anthropic": it covers customers whose Claude organization pays Anthropic directly, and you may bill a customer only for requests they direct you to make, never for your own usage.3

The rest of this piece is for product, platform and finance leads deciding whether to design around it. The short version: it changes who gets the invoice. It does not move the account, the limits or most of the measurement work.

Who owns what: linked billing against the alternatives

Three setups get confused. In the first you pay Anthropic and charge your customers yourself. In the second, linked billing, the customer's Claude organization pays per request. In the third a gateway sits on your own provider accounts (BYOK in the gateway sense: you hold the contract and the keys, and the gateway does not sell you inference).4 A fourth variant, the end customer pasting their own key into your app, is a different thing again and is only in the table for contrast.

You pay, you bill customersLinked billingEnd customer pastes own key
Account the request runs inYoursYoursThe customer's
Credential your back end usesYour keyYour service account, or a per-connection OAuth tokenThe customer's key
Rate limits that applyYoursYoursThe customer's
Who is invoiced by AnthropicYouThe customer, for requests marked for themThe customer
Data retention and encryption termsYoursYours; the customer's ZDR, BAA and CMEK do not applyThe customer's
ownership by setup. The linked billing column follows Anthropic's Linked billing guide; the other columns are general to those setups.

The last row is the one that surprises people. Anthropic states that requests run in your organization, so your rate limits, model access, service tier, data retention and encryption keys apply, and the customer's own arrangements, including zero data retention, a business associate agreement and customer-managed keys, do not. Anthropic's advice is not to link customers who need HIPAA, FERPA or CMEK coverage for this usage.2

Who can be billed, and which calls qualify

Eligibility is the first filter, and it is a finance question as much as an engineering one. A customer qualifies only if their Claude organization pays Anthropic directly. Organizations billed through AWS, Google Cloud or Azure cannot be billed this way, and neither can organizations that only have a Claude subscription plan; requests for them are refused with 403 user_profile_not_billable.2 To link, the person approving must hold the Admin or Billing role in their Claude organization.3

Funding has limits too. Balance bought in the Console can pay for these requests, and an invoiced organization is invoiced for them. Some promotional allowances, such as the monthly API allowances that come with Claude Max, Ultra and Team plans, and allowances from partner, VC and startup programs, cannot pay.2

Endpoint coverage is also partial:

  • /v1/messages and /v1/chat/completions support billing_policy. /v1/messages/count_tokens accepts the field and ignores it.
  • A request that bills the customer cannot use billable code execution features; the API returns a 400, so send those with bill_to: "self" or no policy.
  • Message Batches does not support billing the customer. A batch request that sets bill_to: "user_profile" is refused, and neither side is billed for it.2

If your product leans on batch or code execution for customer-directed work, those paths stay on your invoice.

The identity plumbing you take on

The customer-facing step is one button. The back-end step is not small. You register an OAuth app in the Console, set up client authentication with a token from your own identity provider (Anthropic does not issue client secrets), and create a service account plus a federation rule that serves as the app's operator identity.2 Your back end authenticates to the authorization endpoints with private_key_jwt, and a client assertion may live no more than one hour.5

By default, any authenticated request as the operator service account can bill every linked customer, by setting the user profile header and bill_to. Anthropic describes a tighter option: tokens issued per connection, where a request made with a connection's token is billed to that connection's customer and to no other.25 For a finance reviewer, that is the difference between "our code is trusted to pick the right customer" and "the credential cannot pick the wrong one". Decide which you are running before launch.

The customer record mapping is one-to-one. Each customer needs a user profile in your organization; one Claude organization links to one profile and one profile to one Claude organization. Several teams that share a Claude organization share one profile. A company gets one profile, not one per person.26 Settle that before you link the first customer.

What still has to live on your side

Linked billing answers "who is invoiced". It leaves the following with you.

Your own capacity. All linked customers' requests run under your organization's rate limits, so one heavy customer can consume capacity others need. A per-customer concurrency or rate rule is yours to build.

A cap you can explain. The customer can set a spend cap in the Console. When nothing on their account can pay, the API can refuse with a 402, and the response does not say whether a lack of funds or a spend limit caused it.2 Your app cannot tell the user which one to fix, and the response does not give you a reset time. If you want a message such as "your monthly AI limit resets on the 1st", you need your own per-customer counter. INFRO's end-customer caps work this way on traffic through the gateway: a cap per end customer, with overrides, and a refused request returns a 402 with the reset time for your app to show.7

A separate ledger for own usage versus customer usage. Requests with no profile count as your own usage, and Anthropic advises keeping end-customer traffic and internal traffic in separate organizations.6 Evals, background jobs and support tooling should be bill_to: "self" and tagged as such, so you can prove none of it reached a customer's invoice.

Per-customer usage for reconciliation. The customer will see an Anthropic invoice and may compare it with what your app displays. Keep your own record per request: customer id, model, tokens, and whether it was marked for the customer or for you. INFRO records requests, tokens and estimated provider cost for each end customer id you attach, by day or month, project and model, as a CSV or JSON export, and attributes spend by feature and workflow metadata.89 These are estimates of provider cost, not Anthropic's invoice.

A fallback. Unlinking, a funding failure or an ineligible customer type all land on your app. Decide per plan whether a refused request falls back to a plan you pay for, or stops.

A request sketch

The point of the sketch is where the decision sits: per request, in your code. That makes the marking logic a control. Put it in one function, log its output, and review the log the way you would review a pricing rule.

Where a gateway fits, and what to test first

A BYOK gateway sits on your own provider accounts. It measures and limits the traffic that passes through it, and your provider invoices you directly at your own rates.4 That is the opposite end of the ownership spectrum from linked billing, where Anthropic invoices the customer. They can coexist, but nothing in the pages read here confirms that a particular gateway forwards billing_policy or the profile header, or whose rates a customer-billed request carries. Treat both as open questions and test before you route linked-billing traffic through anything.

If the customer-billed requests do bypass your gateway, the per-customer cap and usage export will not see them, and you will need the other ledger described above. If your gateway does carry them, check whether its estimates, which use your contract's rates, are the right figure to show a customer.

A decision rule for finance and product:

  1. Use linked billing for customers who are on direct Anthropic billing, do not need ZDR, a BAA or CMEK on this usage, and whose work uses /v1/messages or chat completions.
  2. Keep paying and billing yourself for batch, code execution, cloud-billed and subscription-only customers.
  3. Keep a beta fallback: Anthropic says behavior can change, so avoid making it the only way a customer can use the feature.
  4. Build the per-customer cap and ledger regardless of which route a customer takes.

Questions readers ask

Does linked billing replace the end customer pasting their own API key into my app?
They solve similar problems differently. With linked billing the customer approves your app through OAuth and never hands you a key; you call Claude as your own organization and mark which requests the customer pays for 3. A pasted key keeps the customer's own account, limits and data terms on the request, which linked billing does not.
What happens if the customer unlinks my app?
The customer can unlink at any time, and a request you mark for the customer that cannot be billed to them is refused rather than billed to you 2. Your app should treat that as a state to handle, with a message and, if you choose, a fallback to a plan you pay for.

From the team that builds it

Where this shows up in INFRO

INFRO is a control plane in front of the provider accounts you already hold. The capabilities below are the parts of it this article touches, each with the documentation that defines its behaviour.

  • End-customer spend caps

    Available with a plan

    One spend cap for every end customer of your product, per organization or per project, with overrides your backend sets through the management API. A refused request returns a 402 with the time the cap resets, for your app to show its user. Caps and the per-customer cost view on every plan.

    Read the documentation for End-customer spend caps
  • Usage per end customer, for billing

    Available with a plan

    Requests, tokens and estimated provider cost for each end customer, by day or month, project and model, as a CSV from the console or JSON from the API — for you to bill your own users from in your billing system. Included on every plan.

  • Spend attribution

    Available with a plan

    Group cost by model, project, key, or an end-user id you attach to the request.

    Read the documentation for Spend attribution
  • Usage and cost per request

    Available with a plan

    Every request records its model, latency, token or unit counts, and estimated provider cost, queryable by project and key.

    Read the documentation for Usage and cost per request
  • Provider cost reconciliation

    Available with a plan

    Daily comparison of estimated spend against the cost reported by OpenAI's and Anthropic's own cost APIs, using a separate admin credential, with the likely cause of a persistent gap and a suggested rate you can apply. Included on every plan.

    Read the documentation for Provider cost reconciliation

INFRO accounts are self-serve. Provider usage is billed to you by your providers; INFRO charges a software subscription and takes 0% of model spend. See plans.

Sources

Numbered in order of first citation. Each was opened and checked against the claim on the date shown.

  1. 1.Claude Platform release notes (opens in a new tab) — Anthropic. Accessed Nov 19, 2026.
  2. 2.Linked billing (opens in a new tab) — Anthropic. Accessed Nov 19, 2026.
  3. 3.Claude Platform OAuth (opens in a new tab) — Anthropic. Accessed Nov 19, 2026.
  4. 4.INFRO documentation (opens in a new tab) — INFRO. Accessed Nov 19, 2026.
  5. 5.OAuth reference (opens in a new tab) — Anthropic. Accessed Nov 19, 2026.
  6. 6.User profiles for end-customer attribution (opens in a new tab) — Anthropic. Accessed Nov 19, 2026.
  7. 7.End-customer caps (opens in a new tab) — INFRO. Accessed Nov 19, 2026.
  8. 8.Usage per end customer (opens in a new tab) — INFRO. Accessed Nov 19, 2026.
  9. 9.Cost attribution (opens in a new tab) — INFRO. Accessed Nov 19, 2026.

About this article

Read on 2026-11-19: Anthropic's news page and Claude Platform release notes, the Linked billing, Claude Platform OAuth, OAuth reference and User profiles pages, and INFRO's docs overview, end-customer caps, usage per end customer and cost attribution pages. Pages were truncated, so the exact billing_policy request shape, Anthropic-side usage reporting per profile and whether a gateway forwards the linked-billing fields are left out as unconfirmed.

Last checked against its sources on . The next review is due by . No separate named reviewer is recorded for this article.

How articles are written, sourced and corrected is set out in the editorial standards.