Skip to content
BENIBIX Learn

effort Option

Also known as Agent SDK effort, reasoning effort level, Claude Agent SDK effort

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

Think of it like

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

Example

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

Why it matters

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

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 code

typescript
effort: "low"
Quick, cheap replies for simple jobs.

Common mistake

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

Key takeaways

  1. 1
    Five levels. low to max.
  2. 2
    Lower is cheaper. And faster.
  3. 3
    Per subagent too. Overrides.