Explainers

What Is Ultracode in Claude Code? Who Gets It and What It Costs

Ultracode is a Claude Code setting, not a model, plan or effort level: with /effort ultracode on, Claude runs a workflow of parallel subagents for each substantive task. Every paid Claude plan and the API have it, but each request uses more tokens, so a subscription hits its limits sooner.

Updated

In short

Ultracode is a Claude Code setting that makes Claude plan and run a dynamic workflow, a script that runs many subagents at once, for every substantive request in a session. It is not a model, a plan or an effort level: /effort ultracode turns it on for the session at whatever effort level the session already uses, and it works on every paid Claude plan (on Pro, once you turn on workflows in /config) and through the API. What it costs is usage. Each request uses more tokens and takes longer, so on Pro, Max or Ultra a session with ultracode on reaches its five-hour or weekly limit sooner than the same work with it off.

On this page5

Ultracode is not max effort, ultrathink or the Max plan

It is often confused with three other things: the max effort level, the ultrathink keyword and Claude's Max and Ultra plans. Read the table by its first column; only the first two rows are ultracode.

Setting

What it changes

How long it lasts

How you set it

/effort ultracode

Claude plans a workflow for each task it judges substantive

The session, or every session with "ultracode": true in your settings

/effort ultracode or the Ultracode toggle in the /effort slider (in VS Code, under Effort); /effort ultracode off

The word ultracode in a prompt

That one task runs as a workflow

One prompt you type yourself

Type it; turn off the Ultracode keyword trigger in /config

The word ultrathink in a prompt

Deeper reasoning on that one turn

One turn

Type it

Effort levels, low to max

How much reasoning the model spends on each request

The session, or every session when saved in your settings (not max)

/effort and a level

Claude Max and Ultra

How much usage your subscription includes

Your billing period

Your Claude plan

Anthropic introduced ultracode with dynamic workflows on May 28, 2026. Until Claude Code v2.1.284 (September 28, 2026), turning it on also set effort to xhigh; since then it is a separate toggle that keeps the session's level. Starting Claude Code with claude --effort ultracode still does both: it turns ultracode on and sets effort to xhigh.

That makes the session's effort level matter. Claude Code runs Opus 5.5, Sonnet 5.5 and Haiku 5.5 at medium effort by default and Fable 5.1 at high, so an ultracode session on Opus 5.5 plans its workflows at medium unless you raise it. Ultracode also needs a model that supports xhigh effort: Fable 5.1, Opus 5.5, Sonnet 5.5 and Haiku 5.5 do; Opus 4.6, Sonnet 4.6 and models without effort support, such as Sonnet 4.5, do not, and Claude Code does not offer ultracode on them.

The keyword counts only in a prompt you type yourself, at the interactive prompt, in an IDE extension panel or in a Remote Control client. A prompt passed with -p, a scheduled task, a webhook or a pull request comment that contains the word does not start a workflow.

Every paid plan has it; Pro turns workflows on first

Anthropic makes dynamic workflows available on all paid plans, with Anthropic API access, and on Amazon Bedrock, Google Cloud's Agent Platform and Microsoft Foundry, and ultracode comes with them on any model that supports xhigh effort. Workflows are on by default for Max, Ultra, Team, Enterprise and API use, and they run in the CLI, the desktop app, the IDE extensions, claude -p and the Agent SDK.

  • Pro: turn on the Dynamic workflows row in /config before ultracode appears. Pro also starts on the small size guideline, which tells Claude to aim for fewer than five agents per workflow; other accounts start on medium, fewer than ten. The guideline is advice to Claude, not a cap.
  • Organizations: an admin can turn workflows off for everyone, in managed settings or on the Claude Code admin settings page, and that removes ultracode as well. No setting removes ultracode on its own, and an effort cap lowers the effort a session with ultracode runs at without turning it off.

A substantive request can chain several workflows, and every agent spends tokens

In Anthropic's example, a single request turns into several workflows in a row: one to understand the code, one to make the change and one to verify it. Each workflow runs up to 16 agents at once by default, and each agent runs on your session's model unless something else assigns one, such as a smaller model the script names for a stage. Anthropic's launch post says workflows can use substantially more tokens than a typical Claude Code session and suggests starting with a scoped task; on a subscription those tokens count toward your plan's usage and rate limits.

Turning ultracode on also switches off three safeguards, because Anthropic treats turning it on as consent to large runs:

  • the Large workflow warning, shown when a workflow schedules more than 25 agents or its projected total passes 1.5 million tokens;
  • the session's limit of 20 concurrent subagents for subagents Claude starts with the Agent tool;
  • in auto permission mode, the approval prompt before the first workflow launch.

The workflow runtime's own caps, such as 1,000 agents per run, still apply. On a subscription, Fable 5.1 usage can bill usage credits instead of plan limits, depending on the plan and seat. On API billing the cost is direct, and the monthly API credit that comes with Max, Ultra and Team does not pay for interactive Claude Code sessions. As an illustration, not an Anthropic figure, and ignoring prompt caching: if each agent in a nine-agent workflow on Opus 5.5 reads 40,000 tokens and writes 2,000, the run costs about $1.80 at Opus 5.5's $4 input and $20 output per million tokens, where one such turn in conversation costs $0.20.

A run waits out a five-hour reset, not a distant weekly one

When an agent in a workflow hits your Claude usage limit, the run pauses instead of failing, and the waiting agents start again shortly after the limit resets. That only happens when every condition holds: an interactive session signed in with a Claude subscription, Claude Code v2.1.271 or later, the autoContinueAtUsageLimit setting on, a reset within 24 hours, and fewer than two earlier waits in the run. A run started with -p, the Agent SDK or in a background session does not wait, and neither does one whose limit resets more than 24 hours later, as a weekly limit can: those agents fail. Anthropic's error guide adds that one heavy burst, such as a large workflow fan-out, can use up the weekly allowance before the five-hour window resets. The /workflows view shows each agent's token use while the run goes, and you can stop the run there, usually keeping the work already finished.

When ultracode is worth the extra usage

Anthropic points workflows at work that splits into many parallel pieces: codebase-wide bug sweeps, migrations across hundreds of files, research that needs sources checked against each other, and plans worth drafting from several angles. For one task of that size, the keyword gets you a workflow without leaving the whole session on ultracode. For routine edits, run /effort ultracode off: while it is on, every substantive request is planned as one or more workflows.

On a subscription, the plan decides how far a long run gets. Pro starts on the small size guideline and shares one five-hour limit with your chats, while a verified Ultra account has no five-hour limit at all, which suits long runs that would otherwise pause at the five-hour reset. If your workflows regularly run past your plan, API billing has no five-hour or weekly limit and charges per token instead.

Edited byRick Finch

Official sources

Editorial guidance grounded in official product sources.

Show all 10 sources

FAQ

Common questions

Is ultracode the same as max effort?

No. Effort sets how much the model reasons on each request; ultracode decides whether Claude splits a task into a workflow of subagents, and since Claude Code v2.1.284 it runs at whatever effort the session already uses. Launching Claude Code with claude --effort ultracode also sets effort to xhigh.

What is the difference between ultracode and ultrathink?

Ultrathink asks for deeper reasoning on one turn and leaves the session's effort as it is. Ultracode, typed in a prompt, runs that task as a workflow of subagents; turned on with /effort ultracode, it does that for every substantive task in the session.

Does ultracode cost extra?

Anthropic lists no separate charge for it. It costs usage: a workflow runs many agents, so each request uses more tokens and takes longer. On Pro and Max those tokens count against your five-hour and weekly limits, on a verified Ultra account against the weekly one, and Fable 5.1 usage can bill usage credits instead, depending on plan and seat; with an API key they are billed per token.

Can I use ultracode on Claude Pro?

Yes. Dynamic workflows are available on every paid plan, but on Pro you first turn on the Dynamic workflows row in /config. Pro also defaults to the small size guideline, which asks Claude for fewer than five agents per workflow instead of fewer than ten.

How do I turn ultracode off?

Run /effort ultracode off, or flip the Ultracode toggle in the /effort slider. To stop the word ultracode in a prompt from starting a workflow, turn off the Ultracode keyword trigger in /config. Turning dynamic workflows off removes ultracode entirely. If a settings file sets ultracode to true, remove that line too.

What happens if a workflow hits my usage limit?

In an interactive session signed in with a Claude subscription and with autoContinueAtUsageLimit on, the run pauses and the waiting agents continue shortly after the limit resets, if the reset is within 24 hours and the run has not already waited twice. Otherwise, including when a weekly limit resets later than that, the agents that hit the limit fail.

Next steps

Open the products behind the concept