Monitor Claude Spending & Set Team Usage Limits
This guide explains how to track your Claude API costs and set spending limits for your team. You’ll learn where to find usage data in the Anthropic Console, how to create budget alerts, and how to enforce hard limits so no one accidentally overspends. You’ll need an Anthropic Console account with admin or billing permissions.
What You’ll Need
- Anthropic Console account with Admin or Billing role
- Access to the Settings page (gear icon, bottom left)
- For team limits: a Team plan (not individual)
Step-by-Step
- Open the Anthropic Console – Go to
console.anthropic.comand log in. - Navigate to Usage – In the left sidebar, click Usage. You’ll see a graph of token usage and cost over time. Use the date range picker to view daily, weekly, or monthly data.
- Filter by API key or model – Above the graph, use the dropdowns to filter by specific API keys, models (e.g., Claude 3.5 Sonnet), or both. This helps you see which integration is driving costs.
- Check the cost breakdown table – Below the graph, you’ll see a table with columns for date, model, input tokens, output tokens, and estimated cost. Use the export button (arrow icon) to download a CSV if you need to analyze it in a spreadsheet.
- Set up budget alerts – Go to Settings → Billing. Under Spending limits, click Add spending limit. Enter a dollar amount and choose a period (daily, weekly, or monthly). You’ll receive an email when usage reaches 50%, 85%, and 100% of that limit.
- Enable hard limits (optional) – In the same section, toggle Hard limit on. This will block all API requests once the limit is reached, preventing any further cost. Leave it off if you only want warnings.
- Create a team (if needed) – If you’re on a Team plan, go to Settings → Teams. Click Create team, give it a name, and add members by email.
- Set team-level usage limits – Within the team settings, find Usage limits. You can set a monthly spending cap for the entire team, or per-member limits. Enter the amount and click Save.
- Assign members to teams – Go to Settings → Members. For each member, click the edit icon and select the team you created. Their usage will now count toward the team limit.
- Monitor in real time – Return to the Usage page and select the team from the filter dropdown. You’ll see live spending against the limit.
Common Mistakes
- Confusing token count with cost – Token usage is not the same as dollars. Costs vary by model and whether tokens are input or output. Always check the estimated cost column, not just token counts.
- Setting limits too low – If you set a hard limit below your normal usage, you’ll get unexpected API failures. Review your past 30 days of usage first.
- Forgetting to add team members – Adding a member to the team in the team settings does not automatically move them from the default workspace. You must also update their member settings.
- Ignoring date/time zone – Spending limits reset at midnight UTC, not your local time. A “daily” limit may reset at 5 PM if you’re in the US Pacific timezone.
Tips
- Set a soft alert at 70% of your expected monthly spend so you have time to react before hitting a hard limit.
- Use the CSV export to build a simple spreadsheet that tracks daily costs and predicts monthly totals.
- If you have multiple projects, create separate API keys for each and filter the Usage page by key to see per-project spend.
- Consider using the Batch API for non-urgent tasks; it’s often cheaper and won’t affect your real-time limits as much.
Troubleshooting
- I don’t see the Usage tab – You may not have the Billing role. Ask the workspace owner to grant you Billing or Admin permissions in Settings → Members.
- My spending limit isn’t triggering emails – Check that the email address on your account is correct, and look in your spam folder. Also verify that you’ve enabled the limit (not just created it).
- Hard limit blocked my requests but I still got billed – There can be a short delay (up to a few minutes) between hitting the limit and the block taking effect. Requests already in flight may still complete and be billed.
- Team limit isn’t applying – Make sure the member is actually assigned to the team (Settings → Members). If they’re still in the default workspace, their usage won’t count toward the team limit.
- Usage graph shows zero but I have activity – The Usage page may take up to 24 hours to reflect recent activity. Check the CSV export for the most current data.
Frequently Asked Questions
Can I set a limit for a single API key?
Yes. In Settings → Billing, you can add a spending limit and then choose which API key it applies to. This is useful for isolating a specific application.
What happens when a hard limit is reached?
All API requests for that key or team will return an error (HTTP 429) until the next period resets or you manually raise the limit. You can still access the console and modify settings.
Are spending limits per month or per day?
You can choose daily, weekly, or monthly when creating a limit. The period resets at midnight UTC for daily, Monday midnight UTC for weekly, and the first of the month at midnight UTC for monthly.
Can I get a refund if I accidentally exceed my limit?
Anthropic’s billing policy generally does not offer refunds for API usage. That’s why it’s important to set both soft alerts and hard limits in advance.
How do I see usage for a specific team member?
On the Usage page, use the filter dropdown to select the team, then switch the view to By member. You’ll see a breakdown per user.
Is there a way to get notified before I hit 100%?
Yes, the default email alerts are sent at 50%, 85%, and 100%. You can also create multiple spending limits with different thresholds (e.g., a $100 limit and a $200 limit) to get more granular warnings.
Related
Method: the standard formula for this calculation, rounded as each result states. See how the calculators work or report an error.