<- all tokdocs

Claude Code Effort Levels: Is Medium on Opus 5.5 Already the Default?

By , founder of Mavric and Apso

View on TikTok ->

Matt Pocock (@mattpocockuk) tells viewers in a TikTok to "freaking lower your effort," and says he runs Opus 5.5 on medium while debating a move to low. His point about overthinking matches Anthropic's own documentation. But medium is already the shipped default on Opus 5.5, so running it there is the baseline rather than a reduction. Only the move to low he is considering would lower effort.

What are Claude Code's effort levels?

The Claude Code model configuration docs list five levels: low, medium, high, xhigh and max. The video's caption writes the fourth as "X high," which is how it sounds.

Support varies by model. Fable 5.1, Fable 5, Opus 5.5, Sonnet 5.5, Haiku 5.5, Opus 5, Sonnet 5, Opus 4.8 and Opus 4.7 accept all five. Opus 4.6 and Sonnet 4.6 accept low, medium, high and max, without xhigh.

The API uses the same names under output_config.effort. The API effort page warns: "Don't pass adaptive as an effort value: adaptive is a thinking mode, not an effort level."

What is the default effort level on Opus 5.5?

Medium. The model configuration page says high is the "Default on every model that supports effort," with exceptions: "medium: Default on Opus 5.5, Sonnet 5.5, and Haiku 5.5" and "xhigh: Default on Opus 4.7."

The API docs agree: "Claude Opus 5.5 and Claude Haiku 5.5 default to medium," and setting the default "produces exactly the same behavior as omitting the effort parameter entirely."

Anthropic gives a reason for the choice: "In Anthropic's testing, Opus 5.5 at medium matches or exceeds Opus 5 at high on coding and knowledge-work evaluations." The Opus 5.5 launch page, dated 22 September 2026, says "Opus 5.5 at default effort beats Opus 5 at max effort for about a fifth of the cost" on Terminal-Bench 4.0.

So an Opus 5.5 user who never touches the setting is already on medium.

Does high effort make Claude overthink?

At the top of the scale, yes, according to Anthropic. The model configuration page says "max may show diminishing returns and is prone to overthinking, so test before adopting it broadly." The API guidance for Opus 4.7 says that "On most workloads max adds significant cost for relatively small quality gains, and on some structured-output or less intelligence-sensitive tasks it can lead to overthinking."

Claude Academy's effort tutorial describes the symptom: "When the effort is too high...you will notice a pattern of overthinking, or of identifying more tasks than you actually assigned." It recommends a narrower method than a blanket cut: "Start at the default, watch what comes back, and adjust one level at a time."

When should you use low effort?

Pocock's examples are small code changes and repo exploration. The docs describe low as fitting "Quick exchanges where you review each result, such as brainstorming, a first sketch, or a small change like a rename." The API page calls it "Most efficient. Significant token savings with some capability reduction," suited to "Simpler tasks that need the best speed and lowest costs, such as subagents."

The cost docs also suggest you "Delegate verbose operations to subagents," so verbose output stays in the subagent's context and only a summary returns.

One caveat: the API page says effort is "not a strict token budget." At lower levels, "Claude still thinks on sufficiently difficult problems, but thinks less." Dropping to low makes fewer tokens likely without guaranteeing them.

How to change the effort level

In Claude Code, the level comes from CLAUDE_CODE_EFFORT_LEVEL, the --effort launch flag, or /effort during a session, then from a per-model modelSettings entry or the effortLevel settings key, then from the model default. Skills and subagents accept an effort: key in frontmatter. In the API it is output_config.effort. The video does not name any of these.

Does lower effort keep more room in the context window?

Indirectly. Pocock says "The fewer tokens you use, the smarter the model remains and the more juice you have in your context window." The API page says effort "affects all tokens in the response," including text, tool calls and thinking, and "Lower effort also means fewer and terser tool calls." It controls output, not context directly.

The context half is real. Anthropic's context engineering post from 29 September 2025 says "as the number of tokens in the context window increases, the model's ability to accurately recall information from that context decreases," and calls context "a finite resource with diminishing marginal returns." Because "Claude Code sends your full conversation with every request," fewer output tokens per turn slow how fast the context grows.

On Opus 5.5, effort is also the only lever. The cost docs say "You can't turn off thinking on Opus 5.5, Sonnet 5.5, Haiku 5.5, or the Fable models," and the API returns a 400 error for thinking: {"type": "disabled"} on Opus 5.5.

Bottom line

Pocock is right that high, xhigh and max are more than most coding tasks need, and Anthropic says max is prone to overthinking. On Opus 5.5, medium is the default, so lowering effort means choosing low for simple work like renames, small edits and exploration subagents. Adjust one level at a time and watch the results.

Sources

Published October 13, 2026. Based on a TikTok by @mattpocockuk. Full video notes (markdown)