// troubleshooting guide · zed
Zed Agent 'Max Tokens Reached' Error
- Status
- Workaround available
- platforms:
- All
- updated:
- November 15, 2026
- reports:
- 2
- Method
- how we research
RUNBOOK · zed/max-tokens-reached4 FIXES
// quick answer
Start a new thread, pick a larger-context model, or split the task.
Most likely fix: New thread
How to fix it
// try these in order, the most common fix is first
FIX 1New thread
- 01Start a new agent thread
Did this fix it?FIX 2Switch model
- 01Choose a larger-context model in AI settings
Did this fix it?FIX 3Split task
- 01Break the request into smaller tasks
Did this fix it?FIX 4Trim context
- 01Clear tool outputs or older messages in thread controls
Did this fix it?
Symptoms
Agent stops with Max tokens reached.
Why it happens
- C-01Long thread
- C-02Model token limit
// this guide also covers
- zed max tokens reached
- zed agent error
Still not working?
If Zed keeps failing, you're not alone. See every Zed problem users report or the alternatives people switch to.
Have an app idea? Our small team builds any software: web and mobile apps, games, desktop, AI tools. Price agreed together.
Talk to usThe same problem in other apps
All not loading, error messages & connection guides →
VS Code Python Interpreter Not Found (VS Code)
Cursor High Load Error (ERROR_RESOURCE_EXHAUSTED) (Cursor)
Sublime Text Package Control Error 12029 and 12057 on Windows (Sublime Text)
GitHub Copilot Proxy and Certificate Errors (GitHub Copilot)
Other Zed errors
- Zed Vulkan Error on Linux (NoSupportedDeviceFound)
- Zed Blank or Invisible Window on Linux
- Zed Slow on Linux Laptop (Using Wrong GPU)
- Zed Too Many Open Files Error on Linux
- Zed High CPU Usage or Freezing
- Zed Wrong Scaling on High-DPI Linux (X11)
- Zed Language Server Not Working
- Zed Won't Start or Crashes on Launch