How to control Claude API billing with spend limits

0 of 9 steps done

Last checked 2026-10-20 (ET). Tick each step as you go. Your progress is saved in this browser only.

Claude API billing runs on prepaid credits for most organizations. Every organization on the Start, Build or Scale tier also has a monthly spend cap set by its tier. You can set your own lower limit for the whole organization, and a separate limit for each workspace. See all 9 providers.

Official docs: Rate limits and spend limits and Workspaces

Tier caps you already have

Anthropic lists these monthly spend caps by tier: Start $500, Build $1,000, Scale $200,000. Custom tier organizations have no monthly spend cap. When you reach your tier's cap, API usage pauses until 00:00 UTC on the first day of the next month unless you get a higher limit.

Set your own organization limit

In the Claude Console, go to the Billing page.
In the Spend limits section, click Adjust limit (or Set limit if none is set).
Enter a new value. It can't be higher than your tier's cap.

Set a limit for one workspace

Go to the Workspaces page in the Claude Console and select the workspace.
In the panel that opens, click Spend limits.
Set the monthly cap. You can also configure alerts when spending reaches certain thresholds.

Workspace limits can be lower than, but not higher than, your organization's limits. You cannot set a spend limit on the Default Workspace, so put risky keys in their own workspace.

What the cap does

When usage reaches a limit you set, requests return HTTP 400 with error type invalid_request_error. The message begins "You have reached your specified API usage limits" (or the workspace version) and says when access resumes.
When you hit your tier cap instead, requests return HTTP 429 with error_code enforced_spend_limit_reached and no retry-after header, so automatic retries keep failing.
Raise or remove the limit to restore access sooner.

What it does not do

Limits on the Claude Code workspace are checked separately, and requests over that limit "can instead receive a 429 that carries a retry-after header."
The Default Workspace can't have its own spend limit.
The docs do not describe a way to send spend alerts to a custom email address or a webhook.

Prepaid credits and auto-reload

Anthropic says "Claude API and playground usage is billed through prepaid usage credits." Purchased credits also cover Claude Code. "If you run out of credits, you can no longer call the API or use the playground until you add more."

Auto-reload "purchases additional credits automatically when your balance falls below a threshold you set." To check it:

Go to the Billing page.
In the Credit balance section, look for Manage auto-reload. If you see it, auto-reload is on.
To turn it off, click Manage auto-reload, then Turn off, and confirm.

Credits "expire one year from the purchase date", and "All credit purchases are non-refundable."

Official doc: How do I pay for my Claude API usage?

Using the OpenAI API too? Turn on its hard limit.

Where CapBrake helps

Anthropic already has a cap you can turn on, so the job is to make sure it is on. Use the free CapBrake checklist to tick off each step above. Your progress is saved in your browser. No account and no API key.