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

# Linked billing with Claude Platform

> Link your Claude organization to ClickHouse Cloud so that Claude usage in ClickHouse Cloud is billed directly to your Anthropic account.

Public preview

Linked billing with Claude Platform lets customers of both ClickHouse and Anthropic bill all Claude model usage across ClickHouse Cloud products, such as [ClickHouse Agents](https://clickhouse.com/docs/agents/index.md), directly to their own Claude organization.

Linked billing with Claude Platform is in public preview and is available to all ClickHouse Cloud organizations.

You link your Claude organization to your ClickHouse Cloud organization once.
From then on, Anthropic bills the Claude model usage of your ClickHouse Cloud organization to your Claude organization, at your Claude organization's rates and under its existing billing terms.
This lets you use any committed spend or negotiated rates that you have with Anthropic.

## How billing works

While your Claude organization is linked:

* Anthropic bills Claude model usage in your ClickHouse Cloud organization to your Claude organization, from its prepaid balance or on its invoice.
* Your Claude organization's rates and any committed spend with Anthropic apply.
* Claude model requests for your organization go to Anthropic instead of Claude models hosted in Amazon Bedrock.

Keep the following in mind:

* Linked billing covers all Claude model usage across all ClickHouse Cloud products.
* Once linked billing with Claude Platform is enabled for your organization, only Claude models are available in ClickHouse Cloud.
* Promotional credits in your Claude organization can't be used for linked billing.
* Linking changes only how Claude usage is billed. It doesn't change the terms or data arrangements that apply to your use of Claude in ClickHouse Cloud.
* When you link, you can set a monthly spend limit for Claude usage through ClickHouse Cloud. When the spend incurred through ClickHouse Cloud reaches the limit, Claude model requests from ClickHouse Cloud stop until the next month or until you raise the limit.

If you don't link a Claude organization, nothing changes: Claude models in ClickHouse Cloud continue to be served from Amazon Bedrock.

## Requirements

* **No HIPAA or PCI DSS compliance enabled.** Linked billing with Claude Platform isn't available for ClickHouse Cloud organizations that have [HIPAA](https://clickhouse.com/docs/products/cloud/reference/security/compliance-overview.md#hipaa-since-2024) or [PCI DSS](https://clickhouse.com/docs/products/cloud/reference/security/compliance-overview.md#pci-service-provider-since-2025) compliance enabled.
* **A ClickHouse Cloud role that can link billing.** You need the Admin role in your ClickHouse Cloud organization.
* **A Claude role that can approve billing.** You need the Owner, Admin, or Billing role in your Claude organization.
* **An eligible Claude organization.** Your Claude organization must pay Anthropic directly for its API usage, using either prepaid credits or invoiced billing. Claude organizations that are billed through a cloud marketplace (AWS, Google Cloud, or Azure), and organizations that have only a Claude subscription plan, can't be linked.

## Link your Claude organization

**1. Open organization settings**

As an organization Admin in the ClickHouse Cloud console, open **Organization settings** and scroll to the **Claude organization** section.
Click **Link your Claude organization**.

![Claude organization section in ClickHouse Cloud organization settings, with the Link your Claude organization button](https://mintcdn.com/private-7c7dfe99/qazwLtg9WlUT2mHa/images/cloud/linked-billing-claude-platform/01-link-button.webp?fit=max\&auto=format\&n=qazwLtg9WlUT2mHa\&q=85\&s=eeee8de1c872cf22f78793f2757a339e)

**2. Sign in to Claude**

You're redirected to Claude.
If you aren't already signed in, sign in with an account that has the Owner, Admin, or Billing role in the Claude organization that you want to link.
If your account belongs to several Claude organizations, pick the one to link.

**3. Review how billing works**

Claude shows how billing works for the connection.
Review the details and click **Continue**.

![Claude approval page explaining that ClickHouse will use Claude on your organization's behalf and Anthropic will bill that usage to your organization](https://mintcdn.com/private-7c7dfe99/qazwLtg9WlUT2mHa/images/cloud/linked-billing-claude-platform/02-consent-how-billing-works.webp?fit=max\&auto=format\&n=qazwLtg9WlUT2mHa\&q=85\&s=aaee9bfc3247a4d19767c4f9e696a706)

**4. Set a monthly spend limit**

Optionally, enter a monthly spend limit for Claude usage through ClickHouse Cloud and click **Continue**.
To link without a limit, click **Continue without a limit**.
You can change the limit at any time in the Claude Console.

![Claude approval page with a field to set a monthly spend limit for Claude usage through ClickHouse Cloud](https://mintcdn.com/private-7c7dfe99/qazwLtg9WlUT2mHa/images/cloud/linked-billing-claude-platform/03-consent-spend-limit.webp?fit=max\&auto=format\&n=qazwLtg9WlUT2mHa\&q=85\&s=12277e959c9a9326423f8ac981b5a97e)

**5. Link and authorize**

Review what ClickHouse will be able to do and click **Link and authorize**.

![Claude approval page summarizing that ClickHouse can use Claude on your organization's behalf up to the monthly spend limit, with the Link and authorize button](https://mintcdn.com/private-7c7dfe99/qazwLtg9WlUT2mHa/images/cloud/linked-billing-claude-platform/04-consent-link-and-authorize.webp?fit=max\&auto=format\&n=qazwLtg9WlUT2mHa\&q=85\&s=409341bfec2f7d156988cd45c161e39c)

**6. Confirm the link**

You're returned to the ClickHouse Cloud console, which confirms that your Claude organization is linked.
The **Claude organization** section shows a **Linked** status, the date that you linked, and the last characters of the link ID.

![Claude organization section showing the Linked status, the link date, the link ID, and the Unlink button](https://mintcdn.com/private-7c7dfe99/qazwLtg9WlUT2mHa/images/cloud/linked-billing-claude-platform/05-linked.webp?fit=max\&auto=format\&n=qazwLtg9WlUT2mHa\&q=85\&s=0d6175373c3242ba08e8f262ecda92ce)

From now on, Claude usage in your ClickHouse Cloud organization is billed to your Claude organization.

## Monitor usage and spend in the Claude Console

To see how much Claude usage through ClickHouse Cloud has cost your Claude organization, open [Linked platforms](https://platform.claude.com/linked-platforms) in the Claude Console and select **ClickHouse**. This page shows:

* The Claude organization that's billed, when it was linked, and who approved it.
* **Spent this month**: how much spend has been incurred through ClickHouse Cloud this month, measured against your monthly spend limit if you set one. The limit resets on the first day of each month (UTC).
* **Link history**: each time the organization was linked or unlinked, and by whom.

![Claude Console Linked platforms page for ClickHouse, showing the Connection details and the Spent this month meter against a monthly spend limit](https://mintcdn.com/private-7c7dfe99/qazwLtg9WlUT2mHa/images/cloud/linked-billing-claude-platform/07-claude-console-spend.webp?fit=max\&auto=format\&n=qazwLtg9WlUT2mHa\&q=85\&s=6202deed30425ce6b20c97ed34666b50)

From this page, you can also set, raise, or remove the monthly spend limit for Claude usage through ClickHouse Cloud, or unlink ClickHouse.

Your Claude organization's overall **Monthly spend limit**, under [Spend limits](https://platform.claude.com/settings/billing#spend-limits) in the Claude Console, also applies to Claude usage through ClickHouse Cloud.

## Unlink your Claude organization

You can unlink from either side. The result is different for each.

### Unlink in ClickHouse Cloud

In **Organization settings**, click **Unlink** in the **Claude organization** section.
ClickHouse Cloud returns to the default behavior: Claude model requests in your organization go to Claude models hosted in Amazon Bedrock, and Claude usage is no longer billed to your Claude organization.
This is the only way to return to the default behavior.

### Unlink in the Claude Console

On the [Linked platforms](https://platform.claude.com/linked-platforms) page, select **ClickHouse** and click **Unlink**.
ClickHouse Cloud can no longer use Claude on your organization's behalf, and Anthropic stops billing new Claude usage through ClickHouse Cloud to your Claude organization.

> [!WARNING]
>
> Unlinking in the Claude Console doesn't switch ClickHouse Cloud back to the default behavior.
> Until you relink, or explicitly unlink in ClickHouse Cloud **Organization settings**, Claude model requests from your ClickHouse Cloud organization fail.
> For example, ClickHouse Agents responds with `The model provider could not complete this request (status 403).`

![ClickHouse Agents chat showing the error The model provider could not complete this request (status 403)](https://mintcdn.com/private-7c7dfe99/qazwLtg9WlUT2mHa/images/cloud/linked-billing-claude-platform/08-agents-403-error.webp?fit=max\&auto=format\&n=qazwLtg9WlUT2mHa\&q=85\&s=23bd7f47a5cad66e05fd60203022345c)

The **Claude organization** section in ClickHouse Cloud **Organization settings** then shows the message `The link was removed on the Claude side, or your Claude organization cannot be billed directly. Relink to continue.`

![Claude organization section showing a warning that the link was removed on the Claude side, with the Relink and Unlink buttons](https://mintcdn.com/private-7c7dfe99/qazwLtg9WlUT2mHa/images/cloud/linked-billing-claude-platform/06-link-removed.webp?fit=max\&auto=format\&n=qazwLtg9WlUT2mHa\&q=85\&s=6636033c2899a0f6b19e0fa10618058a)

To continue, do one of the following:

* Click **Relink** and go through the [linking steps](#link-your-claude-organization) again to keep billing Claude usage to your Claude organization.
* Click **Unlink** to return to the default behavior, where Claude model requests go to Claude models hosted in Amazon Bedrock.

## Troubleshooting

| Symptom | Likely cause | What to do |
| - | - | - |
| The **Link your Claude organization** button is disabled. | You don't have the Admin role in your ClickHouse Cloud organization, or your organization has HIPAA or PCI DSS compliance enabled. | Ask an organization Admin to link. Linked billing with Claude Platform isn't available for organizations that have HIPAA or PCI DSS compliance enabled; Claude models continue to be served from Amazon Bedrock. |
| Claude doesn't offer your organization on the approval page, or says that ClickHouse can't be linked. | Your Claude organization isn't [eligible](#requirements), or your account doesn't have the Owner, Admin, or Billing role in it. | Check the [requirements](#requirements). |
| Claude requests fail, and **Organization settings** says that the link was removed on the Claude side. | The link was removed in the Claude Console, or Anthropic can't bill your Claude organization directly. | [Relink or unlink](#unlink-in-the-claude-console) in ClickHouse Cloud. |
| Claude requests stop partway through the month. | Spend incurred through ClickHouse Cloud has reached the monthly spend limit you set when linking, or your Claude organization has reached its overall monthly spend limit. | In the Claude Console, raise the spend limit for Claude usage through ClickHouse Cloud under [Linked platforms](https://platform.claude.com/linked-platforms), or your organization's limit under [Spend limits](https://platform.claude.com/settings/billing#spend-limits). |
| Claude requests fail and your Claude organization is linked. | Anthropic can't currently bill your Claude organization, for example because it's out of prepaid credit or suspended. | Check your billing in the Claude Console. |

For questions about ClickHouse Cloud, contact [ClickHouse support](https://clickhouse.com/support/program).
To manage the spend limit or the connection on the Anthropic side, use the [Linked platforms](https://platform.claude.com/linked-platforms) page in the Claude Console.
