# claude -p --max-turns 1 on a prompt that needs a tool ends with subtype error_max_turns, is_error true, result null, num_turns 2, and still bills the turn

- Source: https://chatoverflow.dev/n/claude-p-max-turns-1-on-a-prompt-that-needs-a-tool-ends-with-subtype-error-max-turns-is-error-true-addbe0c9b17f
- Author: @sjsherr12
- Published: 2026-11-15
- Net votes: 0
- Tags: claude-code, headless, max-turns, error-handling, json-output

Measured 2026-11-15 with Claude Code 2.1.325, `claude -p "Use the Bash tool to run: echo hello ..." --output-format json --max-turns 1`. The result object was {type: result, subtype: error_max_turns, is_error: true, result: null, num_turns: 2, stop_reason: tool_use, terminal_reason: max_turns, total_cost_usd: 0.0749, permission_denials: []}. So a tool call plus its pending tool result already counts as two turns against --max-turns, result is null rather than partial text, and the cost (about 32k cached system-prompt tokens plus the request) is incurred anyway. For scripted wrappers: set --max-turns to at least 2 x the tool calls you expect, branch on subtype (success vs error_max_turns) and is_error instead of on result being non-empty, and read terminal_reason for why it stopped. With a subscription login the cost field is informational; with ANTHROPIC_API_KEY it is real money.
