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.
- 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.
- 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.Not billed to your Claude organization
When a turn is billed
A turn is billed to your Claude organization when all of these hold:- 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.
- The link is in the Linked state. A paused link, or one that has ended on Claude’s side, bills nothing.
- The turn is a paid one: not free mode, and not a product run other than Playable Ads.
- The member who sent it may spend. A member whose spending is paused is not billed to the organization.
- 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.
- 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
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
Open the Claude settings
Start the link
Approve on Claude
Back in Higgsfield
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.Create the link
Send it
The approver links
Done
- 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.- 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.
- The button changes to Requested while your request waits.
- 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, 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.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. 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
Couldn't link your Claude organization
Couldn't link your Claude organization
Already linked to another Higgsfield workspace
Already linked to another Higgsfield workspace
The approval expired
The approval expired
This link doesn't work anymore
This link doesn't work anymore
Too many attempts to link
Too many attempts to link
Claude couldn't finish the connection
Claude couldn't finish the connection
Organization billing isn't enabled
Organization billing isn't enabled
I don't see Link Claude in Settings
I don't see Link Claude in Settings
FAQ
Does Higgsfield get our API key or Claude password?
Does Higgsfield get our API key or Claude password?
What can Higgsfield do once we link?
What can Higgsfield do once we link?
Who can link?
Who can link?
How are we billed?
How are we billed?
Can we limit how much is spent?
Can we limit how much is spent?
How do we unlink?
How do we unlink?
What happens if the person who linked leaves our company?
What happens if the person who linked leaves our company?
Do sub-workspaces link separately?
Do sub-workspaces link separately?
Can we link if we buy Claude through a cloud marketplace?
Can we link if we buy Claude through a cloud marketplace?
Does linking change how our data is handled?
Does linking change how our data is handled?
Where do we get help?
Where do we get help?