Docs › Troubleshooting › Usage, billing and network errors
Usage, billing and network errors
Every usage, billing, account and connection card the chat can show, with what it means and what to do.
On this page
- Usage limit reached
- You have used this month's allowance
- Additional usage limit reached
- Stopped at your spending cap
- Additional usage will not turn on
- Going too fast
- Inline completions are paused until tomorrow
- Payment is needed to continue
- You are signed out
- Your account is not allowed to do that
- Could not reach AstraCode
- AstraCode is temporarily out of capacity
- This model is temporarily unavailable, or the model is busy right now
- The model refused this request
- That model is out of credit
- That model is not available
- This conversation is too long for the model
- That was too large to send
- That message had nothing in it to send
- AstraCode sent something the gateway could not read
- The gateway had a problem
- The request did not go through
When a request fails, the chat shows a card with a title, sometimes a detail, a hint and a Reference line. Find the card's title below. How the allowance works is on Usage and limits; plans and prices are on the pricing page.
Usage limit reached
Cause: your plan's allowance for this period is used up. The card says when it resets.
- Upgrade starts a larger allowance straight away.
- Turn on additional usage lets work continue, billed to your card.
- View usage opens AstraCode Settings > Usage.
- Or wait for the reset date.
On a team plan, Ask your team's admin to upgrade or turn on additional usage. Only an admin can.
You have used this month's allowance
You have used this month's free allowance on the Free plan, where upgrading starts your month again straight away. On other plans, open AstraCode Settings > Usage to see when it resets or to turn on additional usage.
Additional usage limit reached
Cause: additional usage reached the monthly limit you set.
- Choose Raise the limit.
- Pick a higher Monthly limit, or No limit, on the Usage page.
Stopped at your spending cap
Cause: a safety cap was reached, not your plan's allowance. Raise it on the Usage page if that is what you want.
Additional usage will not turn on
| Message | What to do |
|---|---|
| Add a valid card in Billing to turn on additional usage. | Choose Open Billing, add a card on the site, then Turn on again. |
| On paid plans | The Free and Student plans cannot have additional usage. Upgrade to a paid plan. |
| AstraCode did not accept that change to additional usage. | Try again. If it repeats, contact support. |
| Could not reach AstraCode to change additional usage. | Check your connection and try again. |
Going too fast
The title starts Going too fast and says when to try again, or that it clears on its own. Nothing was charged to your allowance.
Cause: a short rate limit. Wait the time it gives, then send again.
Inline completions are paused until tomorrow
Cause: tab completion's daily limit. Chat and the agent still work. It resets at midnight UTC.
Payment is needed to continue
Cause: the gateway needs a payment on your account before it serves more. The card may carry the gateway's own sentence instead. Open AstraCode Settings > Usage to see your plan and allowance, and Billing on the site for your card.
You are signed out
Cause: your session ended or was refused. Run AstraCode: Sign In. See Sign-in problems.
Your account is not allowed to do that
This card may instead carry the gateway's own sentence, such as a model or feature not enabled for your organisation.
Cause: your organisation's settings do not allow the request. Signing in again will not change this; an owner of your organisation can.
Could not reach AstraCode
The detail says what failed, and the hint says a VPN or corporate network may be blocking api.astracode.io.
| Detail | What it usually means |
|---|---|
| the secure connection could not be verified | A VPN, proxy or firewall is inspecting encrypted traffic. Ask for an exception for api.astracode.io and astracode.io, or have the proxy's certificate trusted on this machine. |
| the server could not be found | No internet connection, or DNS cannot resolve the address. |
| the connection was refused | Something on the network is blocking the connection. |
| the connection was interrupted | The connection dropped. Send again. |
| the request timed out | The network is slow or blocking. Send again. |
| the network is unreachable | This machine has no route to the internet. |
- Check that the machine is online.
- Allow
api.astracode.ioandastracode.iothrough your VPN, proxy or firewall. AstraCode has no proxy setting of its own. - If your organisation runs its own gateway, check AstraCode Settings > Browser & Network > Gateway (
astracode.gatewayUrl). - Send the message again.
Could not reach AstraCode to load your plan. on the Usage page has the same causes, and fills in by itself once AstraCode answers.
AstraCode is temporarily out of capacity
Cause: a problem on our side, and we are notified. Your work is saved. Try again shortly.
This model is temporarily unavailable, or the model is busy right now
Cause: the model provider is unavailable or overloaded. Nothing was charged. Try again in a moment. With your own key, pick another model.
The model refused this request
Rephrase the request. If it keeps happening, report it with AstraCode: Report a Problem.
That model is out of credit
Cause: the provider refused for billing, not because of anything in your message. With your own key, add credit to that provider account, or pick another model. See Bring your own key.
That model is not available
Cause: the model you pinned is not offered. Pick another model, set Auto, or update AstraCode if the model is new.
This conversation is too long for the model
Compact the session (Compact session in the context ring, or AstraCode: Compact Session), start a new chat, or detach some files. Sending the same message again will not help.
That was too large to send
Detach some files or shorten the message, then send it again.
That message had nothing in it to send
Cause: an attachment on its own is not always enough. Add a line of text and send it again.
AstraCode sent something the gateway could not read
Cause: a bug on our side; retrying the same thing will not help. Choose Report this on the card, then start a new chat or rephrase.
The gateway had a problem
Cause: a fault on our side, not your account or your request. Try again shortly. If it repeats, report it with the Reference from the card.
The request did not go through
Try again. If it keeps happening, choose Report this so the details below the card reach us.
← Dictation problems CLI problems →
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