Follow Discord
Sweep 29 Sep 2026 · 18:10Z Build v2.1.285 506 read Stable v2.1.280 Latest v2.1.285 Next v2.1.285 Feeds RSS JSON llms.txt llms-full.txt Unofficial
Home / Reference / Settings keys

maxTurns

setting never mined JSON

A Claude Code settings key, read out of the shipped bundle. No mined inventory carries it: everything below comes from what this site has written about it.

The built-in autonomous agent can now keep working for 500 turns instead of stopping at 200.

Not Anthropic's. This is the line from the earliest changelog entry here that named it, v2.1.246.

First seen — never in a mined build
Last seen — never in a mined build
Builds0 / 128on this box, as of v2.1.285
Written about v2.1.30 first named in a changelog, 3 Feb 2026

In the changelogs

6

Releases whose published page names maxTurns.

  1. v2.1.285
    A turn limit is now passed along with a request when one is set

    When a maxTurns turn limit is set, Claude Code now sends it along with a request instead of leaving it out

    named in this entry, found in this entry's text

  2. v2.1.285
    SDK tidies its maxTurns value and tracks errors in turns without a model

    In the SDK, the maxTurns value is now normalized before use, and errors from turns that end without the model are tracked

    named in this entry, found in this entry's text

  3. v2.1.285
    Tool restrictions and turn limits now carry over to spawned sessions

    Spawned sessions now keep your disallowedTools and tools restrictions and your maxTurns limit

    found in this entry's text

  4. v2.1.251
    Web fetching capped at 15 turns and runs in the foreground

    Web fetching is capped at 15 turns and runs in the foreground unless you background it.

    found in this entry's text

  5. v2.1.246
    Built-in autonomous agent can run 500 turns

    The built-in autonomous agent can now keep working for 500 turns instead of stopping at 200.

    found in this entry's text

  6. v2.1.30
    Enhanced Custom Subagent Schema

    found in this entry's text

First cited

0

No release's published evidence quotes this name. The ledger indexes the Evidence lines of every changelog on this site, so this says nobody here has ever quoted it; it says nothing about how old the name is.

Presence across releases

0

The miner has never read a build containing this name. It is here because a changelog entry of ours names it, which is evidence that it existed and not evidence of which releases carried it. The inventory starts at v2.1.138 and everything older than that was never mined.

Read out of the published npm bundle release by release, and out of Anthropic's own documentation as this site captured it. Nothing on this page is a description anybody here wrote about what the settings key does. All settings keys.

Feedback