Command Code

Usage Exceeded

The Usage Exceeded error occurs when you exceed your plan's usage limits. This error indicates that you have consumed your allocated credits for the current billing period, or hit one of your plan's rolling usage windows.

Possible causes

  • Monthly credits spent: You've used the full credit allocation for your current billing period.
  • 5-hour or weekly limit reached: Each plan has a rolling 5-hour window and a rolling weekly window on top of the monthly pool. Hitting one returns a message naming the window and when it resets, e.g. You've reached your 5-hour usage limit. Resets in 2h 41m (3:00 PM). See Usage limits for how they work.
  • Organization spend limit reached: On an organization plan, an owner or admin can set a spend cap on a member, or on a member for a single model. Reaching one returns a message naming the cap and when it resets, e.g. You've reached the $10.00/mo spending limit your organization set for GLM-5. It resets in 3 days. Skip straight to step 5 — the individual-plan steps (1–3) don't apply, since a member has no plan of their own to upgrade and no credits of their own to buy.

Troubleshooting steps

  1. Check your usage: Review your current usage and plan limits in Command Code Studio billing page, or run /usage in the CLI to see your credit balance and live 5-hour / weekly limit meters. On an organization plan, /usage also lists any spend caps assigned to you — how much of each you've spent and when it resets — under Spend limits; the section is absent when you have none.
  2. Add on-demand credits: Top-up and pay-as-you-go credits aren't throttled by the rolling windows. Run /extra (or enable auto top-up in Studio) to continue immediately past a window limit.
  3. Upgrade your plan: Run /upgrade, or upgrade in Studio, to raise both your monthly credits and your rolling window caps.
  4. Wait for reset: Rolling windows reset on a 5-hour / weekly schedule from first use; monthly credits reset at the start of your next billing period.
  5. Org members — ask an owner or admin: Only an organization owner or admin can raise a member's spend cap. Until they do, wait for the cap's window to reset, or — when the cap is set on one model — switch to another model. Run /usage, or open the Usage page in Studio, to see the caps you're currently under and when each one lifts.

See the Command Code Pricing page for more details on available plans and their respective limits.

Recommendation

If you consistently hit usage limits, add on-demand credits with /extra to keep working without interruption, or upgrade your plan to raise both your monthly allocation and your rolling window caps.