# effort Option

> The option that sets how hard Claude thinks on each reply, from low to max.

**Field:** Artificial Intelligence  
**Category:** Claude Agent SDK  
**Also known as:** Agent SDK effort, reasoning effort level, Claude Agent SDK effort

## Think of it like

It is like asking for a fast job or a slow, good one.

## Definition

effort is the Agent SDK option that sets how much reasoning Claude puts into each reply. The levels are low, medium, high, xhigh and max. Lower levels use fewer tokens, so they are faster and cost less. Not every model supports it. You can also set it per subagent, to override the session level.

## Example

Leo's agent mostly lists files and greps. He sets effort to low, and each run gets cheaper and faster.

## Example code

```typescript
effort: "low"
```

Quick, cheap replies for simple jobs.

## Why it matters

Simple jobs do not need deep thought, and paying for it adds up.

## Common mistake

Using max for every task. Save it for hard, multi-step problems.

## Three principles

- **Five levels.** low to max.
- **Lower is cheaper.** And faster.
- **Per subagent too.** Overrides.

## Related terms

- [effortLevel](https://learn.benibix.com/term/ai/effort-level-setting)
- [maxBudgetUsd Option](https://learn.benibix.com/term/ai/max-budget-usd-option)
- [Subagent](https://learn.benibix.com/term/ai/subagent)
- [Extended Thinking](https://learn.benibix.com/term/ai/extended-thinking)

---

Source: https://learn.benibix.com/term/ai/effort-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.
