Docs › Account and usage › Usage and limits
Usage and limits
See how much of your plan is left and when it resets, what happens when it runs out, and how additional usage and its spending limit work.
On this page
- See how much is left
- The Usage page
- When you are running low
- When the allowance is used up
- Additional usage
- Turn it on
- The monthly spending limit
- Upgrade or manage your plan
- Other limits you may meet
- With your own key
- If something goes wrong
Your AstraCode plan includes an allowance that chat, the agent, tab completion, dictation and web search all draw on. AstraCode shows it in one way everywhere: how much of your allowance is left, and the date it resets. What each plan includes, and what it costs, is on the pricing page.
The allowance is measured by what each piece of work costs to run, not by how many messages you send, so light work such as a short question goes further than a long agent run over a large project.
See how much is left
- The status bar. An item at the bottom of the window shows how much of your allowance is left; hover it for the reset date. It turns amber when the allowance is nearly gone and red when it is used up. Press it to open AstraCode Settings. It fills in after your first agent run, or when you open Usage, and it is hidden on a plan that is not metered.
- AstraCode Settings > Usage. The full picture: your plan, when it resets, additional usage and its limit. Open it with AstraCode: Open Settings, then choose Usage in the sidebar.
- AstraCode Settings > General. The account panel at the top shows your plan and a usage bar, with Manage account to open your dashboard on the site.
- The chat panel. The More menu (the three dots at the top of the chat) has Usage, and the footer of the chat history list has Usage and settings.
Usage is per account, not per window or per machine. Two editors and the CLI signed in to the same account all draw on the same allowance.
The Usage page
AstraCode Settings > Usage has these parts, top to bottom:
| Part | What it shows or does |
|---|---|
| Current plan | Your plan's name and when the allowance resets. |
| Upgrade | Opens the upgrade page on the site. Not shown on the highest plans. |
| Plan usage this month | A meter of how much of the allowance has gone. When it is full, the page says so and offers the ways on. |
| Additional usage | Whether work carries on past your allowance, with Turn on, Turn off or Add a card. See below. |
| Monthly limit | The most additional usage may add up to in one period, or No limit. See below. |
If the page cannot load your plan it says Could not reach AstraCode to load your plan. It fills in by itself once AstraCode answers. Signed out, it says Sign in to see your plan and usage.
When you are running low
Before the allowance runs out, the chat shows a warning card once, saying most of your plan is used and when it resets. Its button is Upgrade (or Upgrade to a named plan) when upgrading is the way on, otherwise View usage. Nothing stops at this point; it is a warning.
When the allowance is used up
A message you send after that gets a card titled Usage limit reached: You've used all of your plan for this period., followed by when it resets. The buttons depend on your plan and settings, with the one that gets you working again soonest first:
| Button | What it does |
|---|---|
| Upgrade to a plan, or Upgrade | Opens the upgrade page. A new plan starts its allowance straight away. |
| Turn on additional usage | Turns on additional usage, so work carries on and is billed to your card. Needs a card on file. |
| View usage | Opens AstraCode Settings > Usage. |
| Contact support | Opens the contact page. |
On a team plan you may instead read Ask your team's admin to upgrade or turn on additional usage. Only an admin can change the team's plan. If additional usage is already on, you see an information card instead: you can keep working, and the extra is billed separately until your plan resets.
Waiting is always an option: the allowance comes back on the reset date shown on the card and on the Usage page.
Additional usage
Additional usage lets work continue past your plan's allowance. It is billed at your plan's rate to the card on file at the end of each billing period. With it off, work stops when the allowance is used up and nothing is billed beyond your subscription. It is available on paid plans only; on the Free and Student plans the Usage page shows On paid plans.
Turn it on
- Open AstraCode Settings > Usage.
- Under Additional usage, choose Turn on. If the page says Needs a card on file, choose Add a card instead, add one in Billing on the site, then come back and choose Turn on.
- Optionally set a Monthly limit below it, so additional usage cannot run past an amount you choose.
To stop it, choose Turn off in the same place.
The monthly spending limit
Monthly limit is a list of fixed amounts plus No limit. Once additional usage reaches your limit, work stops again and the chat shows Additional usage limit reached: You've reached the spending limit you set for additional usage. Its button, Raise the limit, opens the Usage page so you can pick a higher one. The limit resets with your billing period.
Separately, a request can stop with Stopped at your spending cap. That is a safety cap rather than your plan's allowance; raise it on the Usage page if that is what you want.
Upgrade or manage your plan
- AstraCode: Upgrade Plan in the command palette opens the upgrade page on the site. So does Upgrade in AstraCode Settings.
- Manage account in AstraCode Settings > General opens your dashboard on the site, where Billing holds your card and invoices.
- Plans, what they include and their prices: the pricing page.
Other limits you may meet
| Card | What it means |
|---|---|
| Going too fast | A short rate limit, not your allowance. It clears on its own, and nothing was charged. |
| Inline completions are paused until tomorrow | Tab completion has a daily limit of its own. Chat and the agent still work. It resets at midnight UTC. |
| You have used this month's free allowance | The Free plan's allowance is used. Upgrading starts a new month straight away. |
Web searches the agent runs count against your allowance like any other work. To turn them off, see Web search and reading pages.
With your own key
Requests that use your own provider key are billed by that provider to your key and are not counted against your AstraCode allowance. See Bring your own key.
If something goes wrong
Every usage, billing and connection card, with its fix, is in Usage, billing and network errors.
← CLI reference Bring your own key →
All documentation
Get started
Using the editor
- Tab completion
- Edit and ask about a selection
- Reviewing the agent's changes
- Git: commit messages, branch review and conflicts
- Dictation
- Layout, themes and the settings page
Agent
- Agent overview
- Agent, Plan, Ask and Debug
- Approvals and permissions
- Plan mode
- Debug mode
- Tools
- Browser tools
- How the agent checks its work
- Checkpoints and undo
- Running several agents at once
- Subagents and background tasks
- Remote agents in GitHub Actions
- Infrastructure as code
Context
Workspaces
Connectors
- Connectors (MCP servers)
- Connector configuration reference
- Use AstraCode from Claude, ChatGPT and other apps
Extending AstraCode
CLI
Account and usage
- Usage and limits
- Bring your own key
- What AstraCode sends and keeps
- Reporting a problem and getting help
Troubleshooting
- Troubleshooting
- Sign-in problems
- Install and update problems
- Chat panel problems
- Agent run problems
- Connector problems
- Dictation problems
- Usage, billing and network errors
- CLI problems