> ## Documentation Index
> Fetch the complete documentation index at: https://docs.higgsfield.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Link your Claude organization

> Bill Claude usage in Supercomputer to your own Claude organization instead of Higgsfield credits.

A Team, Scale or Enterprise workspace can link its own Claude organization, so that Anthropic bills it directly for the Claude usage in Supercomputer and the studio assistants. You need no API key: an owner, admin or billing admin of your Claude organization approves the link once on Claude's site, and can set a monthly spend limit for Higgsfield there.

## Before you start

* **Higgsfield:** an active Team, Scale or Enterprise workspace, and you are its owner, an admin or its billing member. Link from the main workspace: sub-workspaces follow its link. Other members of the main workspace, and owners and admins of a sub-workspace, can [ask the admins to link](#ask-your-admins-to-link).
* **Claude:** an organization on the Claude Platform, the API product that Anthropic bills directly. Organizations billed through AWS, Google Cloud or Azure can't link.
* **Approval:** the person who approves on Claude's site must be an owner, admin or billing admin of that Claude organization. If that isn't you, [send them an approval link](#ask-someone-else-to-approve).
* **One workspace per organization:** a Claude organization can pay for one Higgsfield workspace, together with its sub-workspaces.

## What is billed where

The link covers the main workspace and all its sub-workspaces. Your Higgsfield plan is billed separately, as before.

### Billed to your Claude organization

Claude usage in the places below, when the Claude model runs on Anthropic's own API.

| Where | Details |
| - | - |
| Supercomputer chats | On the web, in the mobile app, and in the Slack and Telegram bots |
| Assistant chats in the studios | Canvas, Ads Studio, Image Studio, Video Studio, Cinema Studio, 3D Scene Builder and other assistants built on Supercomputer |
| Sub-agents and helper steps that a chat starts | Billed when they run on Claude, whatever model the chat itself uses. One example is improving a prompt before a generation |
| Context compaction of these chats | The summary a long chat makes of its own history |
| Playable Ads runs, on Enterprise plans | The run's Claude usage only. Its generations and paid tools are paid as before |
| A chat continued after a product run has finished | For example, an AI Reels or Dramas chat once its run is over |

### Not billed to your Claude organization

| What | Who pays |
| - | - |
| Models other than Claude, such as GPT and Gemini | Higgsfield credits |
| Claude served by another provider (OpenRouter, Amazon Bedrock, Google Vertex) or through an early-access line | Higgsfield credits |
| The AI model in your own app when you use Higgsfield through MCP, for example in Claude or ChatGPT | Your own plan with that app. Generations started this way use Higgsfield credits, as before |
| Generations: images, video, audio, 3D, upscaling and others | Higgsfield credits |
| Paid agent tools: web search, page and document extraction, media analysis, rented GPU time | Higgsfield credits |
| Product runs: Video Explainer, Katana, YouTube faceless video, Dramas and episode edits, AI Reels, What If, and every other job except Playable Ads | The product's own price or charge |
| Free mode and the free assistants: free models, the Short Drama Studio assistant, AI Reels script writing, the API support assistant | Nobody. It stays free |
| Text nodes in Canvas, and prompt improvement and text steps of generations started outside a chat | As before: Higgsfield credits or the generation's price |
| Chat titles, memory, suggestions, moderation and other background helpers | Higgsfield |
| The rest of a reply after Anthropic refuses the billing: a spend limit is reached, no credit can pay, or the link has ended | Higgsfield credits |
| The Claude usage from the first table, while the workspace is not linked, the link is paused, or the plan is not an active Team, Scale or Enterprise plan | Higgsfield credits, as before |

### When a turn is billed

A turn is billed to your Claude organization when all of these hold:

1. The main workspace is on an active Team, Scale or Enterprise plan and has linked a Claude organization. Sub-workspaces use the main workspace's link.
2. The link is in the **Linked** state. A paused link, or one that has ended on Claude's side, bills nothing.
3. The turn is a paid one: not free mode, and not a product run other than Playable Ads.
4. The member who sent it may spend. A member whose spending is paused is not billed to the organization.
5. The model call is Claude on Anthropic's own API. This is checked for each call, so a sub-agent on another model uses Higgsfield credits. When a Claude model has several routes, a linked workspace uses Anthropic's.
6. Anthropic accepts the request. If it refuses, Supercomputer continues the same reply on Higgsfield credits, if the member has credits and may spend them.

### What pays on Anthropic's side

Anthropic bills the usage to your Claude organization's purchased credit balance, or to its invoice if it's billed monthly. These can't pay for it:

* monthly API credits that come with Max, Ultra and Team plans
* credits from Anthropic's partner, VC and startup programs
* billing corrections from Anthropic

If nothing on your Claude organization can pay, Anthropic refuses the usage and Supercomputer goes back to Higgsfield credits (see [When billing pauses](#when-billing-pauses)). Credit you buy can take some time to apply.

### Your data

Linking changes only how Claude usage is billed. Requests still run in Higgsfield's Claude organization under Higgsfield's data arrangements with Anthropic, so your Claude organization's BAA, customer-managed keys and data retention settings don't apply to this usage.

## Link

**1. Open the Claude settings**

In Higgsfield, open **Settings** → **Link Claude** in your main workspace. On desktop, admins also see **Link your Claude organization to Higgsfield** under the composer on the Supercomputer home page: **Link** opens the same settings, and brings you back afterwards.

**2. Start the link**

Click **Link your Claude organization**, read the summary, and click **Continue to Claude**.

**3. Approve on Claude**

On Claude's site, sign in, choose your Claude organization if you belong to several, optionally set a monthly spend limit for Higgsfield, and approve.

**4. Back in Higgsfield**

You return to the Claude settings, which now show **Linked** and the date. From then on, Claude usage in Supercomputer is billed to your Claude organization, unless Anthropic refuses it (see [When billing pauses](#when-billing-pauses)). Anthropic emails your Claude organization's owners, admins and billing members that Higgsfield was linked.

> [!NOTE]
>
> The approval works once and expires after 10 minutes, and only the Higgsfield account that started it can finish it. If it expires, click **Link your Claude organization** again.

## Ask someone else to approve

Often the person who can approve in Claude isn't an admin of the Higgsfield workspace. You can send them a one-time link instead. They don't need a Higgsfield account and don't join your workspace.

**1. Create the link**

In **Settings** → **Link Claude**, under **Can't approve it yourself?**, click **Create link**.

**2. Send it**

Click **Copy message** and send the message to the approver. Higgsfield sends no email itself, and shows the link only right after you create it, so copy it then.

**3. The approver links**

The approver opens the link. The page shows which workspace asked them, who asked, by name and verified email address, and when the request expires. **Link your Claude organization** takes them to Claude to approve.

**4. Done**

The approver sees **Claude organization linked**, and your Claude settings show **Linked**.

About the link:

* It works once, for 7 days. Opening it doesn't use it up: only clicking **Link your Claude organization** does.
* After that click, the approver can try again for 2 hours, in the same browser. Claude can bring them back in another tab of that browser.
* A workspace has one link at a time. **Revoke** turns it off, and then you can create a new one.
* It stops working once the workspace is linked, whoever linked it, and once the person who created it is no longer an admin of the workspace.
* You can create a link only from a Higgsfield account with a verified email address.

## Ask your admins to link

Members of the main workspace can ask for a link. In a sub-workspace, only its owner and admins can; other sub-workspace members don't see **Link Claude**.

Open **Settings** → **Link Claude**: the page shows that the link is managed by your workspace admins, or by your main workspace in a sub-workspace.

1. Click **Request link**. The main workspace's owner, admins and billing member get a notification, which opens their Claude settings. They're notified about the first request only; later requests wait with it.
2. The button changes to **Requested** while your request waits.
3. Once they link, you get a notification and the page shows **Linked**. If they decline, you get a notification too, and you can ask again.

## Manage the link

**Manage in Claude Console** in the Claude settings opens [Claude Console → Linked platforms](https://platform.claude.com/linked-platforms), where your Claude organization's admins see what Higgsfield has cost this month, set its spend limit, and unlink it.

### Spend limit

The spend limit is optional, and it applies only to what Higgsfield bills your Claude organization. You can set it while approving, or later under Linked platforms, where Claude Console calls it a spend cap. A default limit for all linked platforms applies to Higgsfield unless you set one for Higgsfield.

* At the limit, Anthropic refuses Higgsfield's usage until an admin raises the limit or the month resets on the 1st (UTC). Meanwhile Supercomputer runs on Higgsfield credits.
* A request that crosses the limit is served in full, so small overages can happen.
* The limit counts usage at list price, before any discount you negotiated with Anthropic, so you can reach it before your bill reaches that amount.
* Your Claude organization's own monthly spend limit still applies. Whichever limit is reached first stops the usage.
* A limit of \$0 refuses all of Higgsfield's usage.

### Emails from Anthropic

Anthropic emails your Claude organization's owners, admins and billing members when Higgsfield is linked and when it is unlinked, and your admins when Higgsfield's usage reaches 80% and 100% of its spend limit. Some organizations, such as those under HIPAA, don't get these emails.

### Credit history

Claude usage billed to your Claude organization appears with no credit charge in the credit history of the member who used it. Admins don't see other members' rows. Each row is named after the Claude model and labelled **Billed to your Claude organization**. A chat turn gets one row, and each sub-agent gets its own.

If Higgsfield refunds a Playable Ads run because of a failure on its side, it also gives back the Claude usage your organization paid for in that run, as Higgsfield credits in a row named **Claude Usage Compensation**. Anthropic's bill for that usage stands.

## When billing pauses

If Anthropic can't bill your Claude organization, Supercomputer keeps working on Higgsfield credits, and workspace admins see a notice in the Claude settings and, on desktop, on the Supercomputer home page. Members aren't interrupted while the workspace has Higgsfield credits.

| Notice | What happened | What to do |
| - | - | - |
| **Claude spend limit reached** | Your Claude organization hit a spend limit, or has no credit that can pay | Check its spend limits and balance in [Claude Console](https://platform.claude.com/linked-platforms). Billing to your Claude organization resumes by itself once the limit is raised, credit is added, or the month resets on the 1st (UTC). |
| **Anthropic can't bill your Claude organization** (on the Supercomputer home page: **Claude billing unavailable**) | Anthropic can't bill the organization right now | Check your Claude account. Billing resumes by itself once it is in order. |
| **Claude connection dropped** | Higgsfield was unlinked in Claude Console, or the organization can no longer be billed | Check it in [Claude Console](https://platform.claude.com/linked-platforms), then click **Link again**. Until then the Claude settings show **Not billable**. |

## Unlink

Click **Unlink** in the Claude settings and confirm. Claude usage goes back to Higgsfield credits. Claude requests already running when you unlink are billed to your Claude organization. Everything after that uses Higgsfield credits. Higgsfield also ends the link on Claude's side, and Anthropic emails your Claude organization's owners, admins and billing members about it.

If the Claude settings show **Paused** afterwards (on the Supercomputer home page: **Claude billing paused**), billing has stopped on Higgsfield's side but Higgsfield may still be linked in Claude. If you also saw **Unable to unlink right now**, click **Unlink** again. To resume instead, click **Link your Claude organization** and approve on Claude again. To end the link on Claude's side, unlink Higgsfield in [Claude Console → Linked platforms](https://platform.claude.com/linked-platforms).

You can also unlink from Claude Console at any time. Requests already running finish and are billed. The Claude settings show **Claude connection dropped** and **Not billable** the next time Supercomputer uses Claude.

Higgsfield can also end the link from its side. If we do, we tell your workspace admins first, and Supercomputer runs on Higgsfield credits until you link again.

## Troubleshooting

> [accordion] Couldn't link your Claude organization
>
> The person who tried to approve has no owner, admin or billing admin role in that Claude organization. [Send an approval link](#ask-someone-else-to-approve) to someone who has one of these roles.
>
> You also see this when the Claude settings show **Paused** and you choose a different Claude organization: Higgsfield is still linked to the previous one. Unlink Higgsfield in that organization's [Claude Console](https://platform.claude.com/linked-platforms) first.

> [accordion] Already linked to another Higgsfield workspace
>
> A Claude organization can pay for one Higgsfield workspace. Unlink Higgsfield in [Claude Console](https://platform.claude.com/linked-platforms), then link again here. The other workspace goes back to Higgsfield credits.

> [accordion] The approval expired
>
> The approval on Claude works once, within 10 minutes, for the account that started it. Start again with **Link your Claude organization**.

> [accordion] This link doesn't work anymore
>
> The approval link expired, was revoked, was already used, the workspace is already linked, or the person who sent it is no longer a workspace admin. Ask the person who sent it for a new one.

> [accordion] Too many attempts to link
>
> Each person can start linking up to 20 times an hour, and a workspace up to 60 times an hour. A workspace can create up to 20 approval links a day. Try again later.

> [accordion] Claude couldn't finish the connection
>
> Try again. If it keeps failing, email the support address shown in the notice.

> [accordion] Organization billing isn't enabled
>
> The workspace can't link a Claude organization right now: its plan is no longer an active Team, Scale or Enterprise plan, or you are no longer its owner, an admin or its billing member. You see the same in a sub-workspace or as a member when the main workspace can't link.
>
> If this happens while the workspace is linked, Claude usage goes back to Higgsfield credits. To end the link on Claude's side, unlink Higgsfield in [Claude Console](https://platform.claude.com/linked-platforms).

> [accordion] I don't see Link Claude in Settings
>
> It appears in an active Team, Scale or Enterprise workspace. The owner, admins and the billing member of the main workspace link from it; other members of the main workspace, and owners and admins of a sub-workspace, can [request a link](#ask-your-admins-to-link). Other sub-workspace members don't see it.

## FAQ

> [accordion] Does Higgsfield get our API key or Claude password?
>
> No. An admin of your Claude organization approves the link on Claude's site. Higgsfield never receives an API key or your Claude password.

> [accordion] What can Higgsfield do once we link?
>
> Bill your Claude organization for the Claude usage it makes for you, as listed in [What is billed where](#what-is-billed-where).

> [accordion] Who can link?
>
> On Claude's side, a member of your Claude organization with the owner, admin or billing admin role approves. On Higgsfield's side, the owner, an admin or the billing member of the main workspace starts the link, or [sends an approval link](#ask-someone-else-to-approve). Other members of the main workspace, and owners and admins of a sub-workspace, can [ask them to link](#ask-your-admins-to-link).

> [accordion] How are we billed?
>
> Anthropic bills your Claude organization for Claude usage in Supercomputer and studio assistant chats and their sub-agents, and on Enterprise plans in Playable Ads runs. See [What is billed where](#what-is-billed-where). Your Higgsfield plan, and the Higgsfield credits you use for everything else, are billed separately.

> [accordion] Can we limit how much is spent?
>
> Yes. Any admin of your Claude organization can set or change a monthly spend limit for Higgsfield at any time. See [Spend limit](#spend-limit).

> [accordion] How do we unlink?
>
> Any admin of your Claude organization can unlink Higgsfield at any time in [Claude Console → Linked platforms](https://platform.claude.com/linked-platforms). Admins of your main workspace can also click **Unlink** in the Claude settings. See [Unlink](#unlink).

> [accordion] What happens if the person who linked leaves our company?
>
> The link stays active. It belongs to your Claude organization and your Higgsfield workspace, not to that person, and any admin of either can manage it.

> [accordion] Do sub-workspaces link separately?
>
> No. One link covers the main workspace and all its sub-workspaces.

> [accordion] Can we link if we buy Claude through a cloud marketplace?
>
> No. Your Claude organization must be billed directly by Anthropic. Organizations billed through AWS, Google Cloud or Azure can't link.

> [accordion] Does linking change how our data is handled?
>
> No. Linking changes only how Claude usage is billed. See [Your data](#your-data).

> [accordion] Where do we get help?
>
> For anything about Higgsfield, contact Higgsfield support. For questions about your Claude organization or its billing, contact Anthropic.


## Related topics

- [Organizations](https://docs.higgsfield.ai/docs/organizations.md)
- [Organizations and roles](https://docs.higgsfield.ai/docs/enterprise/organizations.md)
- [Managing members](https://docs.higgsfield.ai/docs/organizations/managing-members.md)
- [Access control](https://docs.higgsfield.ai/docs/enterprise/access-control.md)
- [Webhooks](https://docs.higgsfield.ai/docs/how-to/webhooks.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.