Claude Code
Max Turns
A cap on how many tool-use round trips an agent loop may run before it is forced to stop.
In depth
A cap on how many tool-use round trips an agent loop may run before it is forced to stop. In the Claude Agent SDK, a turn is one cycle: the model asks for tool calls, the SDK runs them, and the results go back to the model. When maxTurns is reached, the run ends with an error_max_turns result. Claude Code offers the same limit as --max-turns in print mode, unlimited by default, and it pairs well with a spend cap like --max-budget-usd.
Primary source: code.claude.com
Example
Claude Code offers the same limit as --max-turns in print mode, unlimited by default, and it pairs well with a spend cap like --max-budget-usd.
Go deeper at Developers Digest
Hands-on guides, comparisons, and tutorials that cover Claude Code.
FAQ
Common questions
What is Max Turns?
A cap on how many tool-use round trips an agent loop may run before it is forced to stop.
Why does Max Turns matter for AI developers?
Max Turns sits in the Claude Code part of the AI stack. Understanding it helps you make better decisions when building, debugging, and shipping AI features.
Where can I learn more about Max Turns?
Developers Digest publishes tutorials and videos that cover Claude Code topics including Max Turns. Check the blog and YouTube channel for hands-on walkthroughs.
Related
Related terms
Claude Code
Credit Metering
Billing model usage against a pool of consumable credits so that programmatic and interactive work draw from separate budgets.
Claude Code
Planning (Agent)
The phase in an agent's workflow where it analyzes a task, breaks it into steps, and determines the order of operations before taking any action.
Claude Code
Model Merging
Combining the weights of two or more models into a single model without further training, usually by averaging or interpolating their parameters.
Put this concept to work
Get Smarter About AI Dev
New tutorials, open-source projects, and deep dives on coding agents - delivered weekly.
One email per weekReal code, not theoryFree forever