# thinking Option

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

**Field:** Artificial Intelligence  
**Category:** Claude Agent SDK  
**Also known as:** ThinkingConfig, Agent SDK thinking, maxThinkingTokens, Claude Agent SDK thinking

## Think of it like

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

## 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

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.

## Example code

```typescript
thinking: { type: "adaptive" }
```

Let the model decide when and how much to think.

## Why it matters

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

## Common mistake

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

## Three principles

- **Adaptive.** The model decides.
- **Enabled.** A fixed token budget.
- **Disabled.** No thinking, where allowed.

## Related terms

- [Extended Thinking](https://learn.benibix.com/term/ai/extended-thinking)
- [effort Option](https://learn.benibix.com/term/ai/effort-option)
- [Reasoning Model](https://learn.benibix.com/term/ai/reasoning-model)
- [ClaudeAgentOptions](https://learn.benibix.com/term/ai/claude-agent-options)
- [model Option](https://learn.benibix.com/term/ai/model-option)

---

Source: https://learn.benibix.com/term/ai/thinking-option
Author: Behnia Zarei (a developer in Vienna, Austria, who builds and teaches data, AI and business intelligence at BENIBIX)
Publisher: BENIBIX Learn (https://learn.benibix.com/)
Last updated: 2026-11-20
Licence: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Quote freely with attribution.
