Skip to content
BENIBIX Learn

thinking Option

Also known as ThinkingConfig, Agent SDK thinking, maxThinkingTokens, Claude Agent SDK thinking

The option that says if Claude thinks before it speaks, and for how long.

Think of it like

It is like telling a kid to think first, or to just say it.

Example

Ben's agent plans hard database moves. He keeps thinking on adaptive, so Claude thinks hard on the tricky steps and moves fast on easy ones.

Why it matters

Thinking costs tokens and time. This option is how you trade them for better answers.

Definition

thinking is the Agent SDK option for how Claude reasons before it replies. It sets whether Claude thinks, and how many tokens that may take. It has three types. Adaptive lets the model choose when to think and for how long, and it is the default on models that support it. Enabled sets a fixed token budget, and disabled turns thinking off where the model allows it. It replaces the old maxThinkingTokens option.

Example code

typescript
thinking: { type: "adaptive" }
Let the model decide when and how much to think.

Common mistake

Still using the old max thinking tokens option. It is on its way out, and this one takes its place.

Key takeaways

  1. 1
    Adaptive. The model decides.
  2. 2
    Enabled. A fixed token budget.
  3. 3
    Disabled. No thinking, where allowed.