---
title: "Railway now supports linked billing with Claude Platform"
description: "Link your Railway workspace to your Anthropic Claude Platform organization. Anthropic bills your organization directly for the Claude models you run in Railway Agent, and no API key needed to be stored."
date: 2026-11-17T18:15:00.000Z
authors: ["Cody De Arkland"]
category: "AI"
url: https://blog.railway.com/p/linked-billing-claude-platform
---

# Railway now supports linked billing with Claude Platform

# Link your Claude Platform organization to Railway

You can now link your Claude Platform organization to your Railway workspace. Once linked, Anthropic bills that organization directly for Claude API usage in Railway Agent, Cloud Agents, and the Slack and Discord bots, on your existing terms. There is no API key to share. An admin approves the link, can set a monthly spend limit, and can unlink at any time.

![Linked Billing Claude Platform](https://cms.railway.com/media/0dcb68ae-31ec-477c-94c2-5abbb1e138c5-01-linked-hero.png)

## Use the Claude organization you already have

A lot of you already have a Claude organization. When you run agents on Railway, you should be able to use it instead of starting a second bill for the same access.

Until now, the way to do this was to create a Claude API key and paste it into the Agent Settings page. API keys are still supported, and can be added within the agents configuration screen. Linked billing is an additional option.

We added linked billing so you can use Claude in Railway with no API key to share, store or rotate. Link your organization, set your model - and just go build.

## Link once, use by many 

Linking requires a Railway workspace admin to start the flow, and an owner, admin, or billing admin of the Claude organization you're linking to, to approve it (often that's the same person). The flow looks like this:

1. Open [Account Settings](https://railway.com/account/agents), then Agents with the workspace you want to link selected.
2. Find the **Claude Platform Organization** card in the **Providers** section and click **Link**.
3. Claude opens in a popup. Choose the organization if you belong to more than one, set a monthly spend limit for Railway if you want one, and approve.

![Claude Platform Linked Billing Screen](https://cms.railway.com/media/65a8a42e-a759-401f-8a55-b731dca3c593-02-providers-before-linking.png)

![Configure Spend Limits](https://cms.railway.com/media/86bd95c4-837f-4503-ba61-983d9f6680b5-CleanShot-2026-11-13-at-5.27.39-PM-2x.png)

Claude models show up under the **Claude Platform** header in the Default Model list and in the chat's model picker, and with a **(Claude Platform)** label inside cloud agents. 

![Default Model selection](https://cms.railway.com/media/234fcf43-a98b-45be-887f-48ab45b60539-CleanShot-2026-11-13-at-5.28.55-PM-2x.png)

If someone on the team has already added their own Claude API key and selected the API key configurations as their Default Model, Railway will keep using it for their requests. Their usage goes to their key, and everyone else's goes to the linked organization.

## What access Railway holds

An admin approves the link on Claude’s own page. There’s no API key from your organization sitting in Railway’s database.

Every request to a Claude Platform model goes through a check before it leaves Railway, to make sure it's targeting the correct organization for billing. If that check fails, Railway doesn't send it. 

Only billing is linked, and requests still run in Railway’s organization.

## Spend controls in Claude

Since Anthropic is the one billing your Claude API usage, the controls live where your Claude administrators already work. On the [Linked platforms](https://platform.claude.com/linked-platforms) page in the Claude Console they can see what Railway has cost this month, set or change Railway's monthly spend limit (the Console calls it a spend cap), or unlink it. Workspace admins can jump there from **Manage** on the card.

![Linked Billing in Claude Platform](https://cms.railway.com/media/bca995b2-149c-4670-8a30-4303e5baa560-CleanShot-2026-11-13-at-5.32.10-PM-2x.png)

Your organization's own monthly spend limit still applies, and whichever of the two is reached first is the one that stops requests. 

When a limit is reached, the card says so (**Spend limit reached**), agents try again on the next request, and members can switch to a Railway model in the meantime. 

Clicking Unlink in Railway stops Claude API usage in Railway from being billed to your organization, removes Railway from your Linked platforms page, and resets any default model.

## What you need to link

There isn't much to line up before you click Link:

- You need to be an admin of the Railway workspace.
- You (or a teammate) are an owner, admin, or billing admin of the Claude organization.
- Anthropic bills that organization directly

## Start here

We want to build a platform that unburdens users so they can focus on what matters - shipping great software. That applies to the models behind your agents as much as it does to the service running your app. With linked billing, you can use Claude where you ship, with no API key to share.

The [Claude Platform docs](https://docs.railway.com/ai/bring-your-own-models/claude-platform) cover linking, spend, and every card state in detail. Link your organization from [Agents settings](https://railway.com/account/agents), pick a model, and tell us how it goes on [Central Station](https://station.railway.com).

Happy shipping.


---

Open this post in a browser: https://blog.railway.com/p/linked-billing-claude-platform
