---
title: Anthropic Claude Platform
description: Link your workspace's Anthropic Claude Platform organization so Anthropic bills it directly for the Claude models your workspace runs in the Railway Agent, cloud agents, dev.new, and the Slack and Discord bots.
---
Linking connects your Railway workspace to your organization on the <a href="https://platform.claude.com" target="_blank">Anthropic Claude Platform</a>. Anthropic then bills that organization directly for the Claude models your workspace runs in Railway, and Railway never receives an API key from your organization.

Unlike ChatGPT and OpenRouter, the link belongs to the workspace, not to one person. A workspace admin links it once, and every member can then select Claude Platform models. For how models are chosen across Railway, see [Bring Your Own Models](/ai/bring-your-own-models).

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

## Requirements

Linking needs the right role on each side and a Claude organization that Anthropic can bill.

| Requirement | Details |
|-------------|---------|
| Railway workspace admin | Only workspace admins can link or unlink. Members see the card but can't change it. |
| Claude owner, admin, or billing admin | This person approves the link on Claude. It can be the same person as the workspace admin. |
| Directly billed Claude organization | Anthropic must bill the organization directly, through prepaid credits or invoiced billing. |
| Early access from Anthropic | Anthropic must enable the Claude organization first. Send Railway your organization ID, which a Claude administrator can copy from the <a href="https://platform.claude.com/settings/organization" target="_blank">Organization page</a> in the Claude Console, and link once Railway confirms it's enabled. |

## Link your organization

A workspace admin starts the link in Railway, and a Claude administrator approves it on Claude.

1. Navigate to <a href="https://railway.com/account/agents" target="_blank">Account Settings, then **Agents**</a>, with the workspace you want to link selected.
2. Find the **Claude Platform Organization** card in the **Providers** section.
3. Click **Link**. Claude opens in a popup.
4. Sign in to Claude, choose the organization to link if you belong to more than one, and approve Railway. You can set a monthly spend limit for Railway on the same screen.

Once you approve, the strip at the bottom of the card reads **Billed to your Claude organization**. Each Claude organization can be linked to one Railway workspace.

Anthropic emails your Claude organization's owners, admins, and billing members when Railway is linked, and again when it's unlinked. Some organizations, such as those under HIPAA, don't get these emails.

## Use Claude Platform models

Members don't need to set anything up. Once the workspace is linked, Claude models appear under **Claude Platform** in **Default Model** and in the chat's model picker, and with a **(Claude Platform)** label in cloud agents.

A member who has added their own Anthropic API key keeps using that key. Their Claude requests are billed to their key, not to the linked organization.

## Manage spend

Anthropic bills the Claude organization for every request a member sends to a Claude Platform model. Railway doesn't charge for these tokens.

Claude administrators manage the link on the <a href="https://platform.claude.com/linked-platforms" target="_blank">Linked platforms</a> page in the Claude Console. Workspace admins can open it from **Manage** on the card. From that page, a Claude administrator can view Railway's cost this month, set a monthly spend limit for Railway, or unlink Railway.

### Spend limits

A spend limit for Railway is optional, and the Claude Console calls it a spend cap. Your organization can also set a default limit that applies to each linked platform separately; a limit set for Railway replaces the default.

- When Railway's usage reaches the limit, Anthropic refuses requests from Railway until an administrator raises the limit or the month resets on the 1st (UTC).
- A request that crosses the limit finishes, so usage can go slightly over it.
- The limit counts usage at list price, before any discount your organization has negotiated, so a discounted organization can reach it before its bill does.
- A limit of $0 refuses every request.
- Administrators get an email when Railway's usage reaches 80% of the limit, and another at 100%.

The organization's own monthly spend limit also applies, and whichever limit is reached first refuses the request. Administrators set it under <a href="https://platform.claude.com/settings/billing#spend-limits" target="_blank">Spend limits</a> in the Claude Console.

### What pays for Railway usage

Anthropic charges Railway usage to your organization's prepaid balance, or to its invoice if it's billed monthly. Some credits can't pay for it:

| Can pay | Can't pay |
|---------|-----------|
| Credit your organization purchased | Monthly API credits included with Max, Ultra, and Team plans |
| Your monthly invoice | Credits from Anthropic's partner, VC, and startup programs |

If nothing on the account can pay, Anthropic refuses requests from Railway. Purchased credit can take some time to apply after you add funds.

## Unlink your organization

Click **Unlink** on the card. Railway stops billing the organization immediately, removes Railway from your organization's <a href="https://platform.claude.com/linked-platforms" target="_blank">Linked platforms</a> page, and members' default models that used Claude Platform reset to the Railway default. To link again later, click **Link** on the card and approve Railway again.

A Claude administrator can also unlink Railway on the Linked platforms page. New requests stop within about 10 seconds, and requests already running finish and are billed.

## Troubleshooting

Most Claude Platform problems show up as a status line on the **Claude Platform Organization** card. Until they're resolved, members can select a Railway model.

<Collapse title="The Claude link didn't complete">
Only an owner, admin, or billing admin of the Claude organization can approve the link, and Anthropic must enable the organization first. Check both, then click **Link** again. Contact Railway support if you need the organization enabled.
</Collapse>

<Collapse title="Claude says the organization is already linked">
Each Claude organization can be linked to one Railway workspace. Unlink it from the other workspace first, or link a different Claude organization.
</Collapse>

<Collapse title="The card says Spend limit reached">
The organization reached Railway's spend limit or its own monthly spend limit, or has no credit that can pay for Railway usage. A Claude owner, admin, or billing admin can raise Railway's limit on <a href="https://platform.claude.com/linked-platforms" target="_blank">Linked platforms</a>, raise the organization's limit under <a href="https://platform.claude.com/settings/billing#spend-limits" target="_blank">Spend limits</a>, or add credit. See [What pays for Railway usage](#what-pays-for-railway-usage).
</Collapse>

<Collapse title="The card says Billing unavailable">
Anthropic can't bill the Claude organization, and the response doesn't say why. Ask a Claude owner, admin, or billing admin to check the organization's spend limits, balance, and account in the Claude Console.
</Collapse>

<Collapse title="The card says Can't be billed">
The organization was unlinked on Claude, or Anthropic doesn't bill it directly. Click **Link** to link it again. If the card still shows this after linking, contact Railway support.
</Collapse>