AI Infrastructure

Cursor Router Guide: Modes, Billing and Admin Controls

Cursor Router guide to Cost, Balance and Intelligence modes, routed-model billing, hidden model identity, admin controls, and rollout testing.

Cursor Auto model picker cycling through Intelligence, Balance, and Cost optimization modes
Cursor's official Router launch animation shows the three optimization choices under Auto. It illustrates the picker, not which underlying model will handle a request. View image source.

Cursor launched Cursor Router on July 22, 2026 for Teams and Enterprise across desktop, web, iOS, CLI, and Cursor's SDK. Auto Balance and Auto Intelligence use its classifier to choose an eligible model for each agent request, while Auto Cost preserves the previous Auto routing logic and bundled pricing. Teams has Router on by default; Enterprise administrators must enable it.

This guide uses Cursor's launch post, live documentation, changelog, pricing policy, and admin documentation as of July 23, 2026. Cursor's quality and savings figures are vendor-reported production experiments, not independent benchmarks. AgentPedia did not have access to a Router-enabled organization or its billing export, so the rollout and test plans below are evaluation frameworks rather than observed product results.

The practical verdict

Cursor Router standardizes a decision policy, not a model. Instead of asking every developer to decide whether a task deserves a cheap model or a frontier model, an administrator exposes one or more optimization modes and Cursor makes the model decision request by request.

That is a good trade when the workload is mixed and the organization cares about aggregate accepted work per dollar. It is a poor trade when model identity is part of the requirement.

Team requirementBetter starting pointWhy
Many routine and difficult tasks share the same workflowRouter with a capped pilotPer-request selection can avoid paying a frontier rate for every routine turn
One consistent cost-and-quality policy across clientsRouterThe same feature is available in desktop, web, iOS, CLI, and the Cursor SDK
Exact provider or model required by policyManual model selectionRouter's pool is managed by Cursor and changes over time
Reproduce a model-specific regressionManual model selectionA fixed model removes routing as a variable
Predict one model's list rate before every requestManual model selection or Auto CostBalance and Intelligence depend on the model actually routed
Reduce individual model-brand biasRouter with model identity hiddenHidden is the default, although admins can expose the routed model
Strict Enterprise allow/block policyRouter only after an eligibility reviewBlocking models narrows the pool; Cursor Grok 4.5 is currently required

The decision should be made on accepted tasks, not attractive averages. A route that costs less per token but creates more retries, corrections, or rejected changes can raise the cost of finished work.

What changed in Auto

Cursor Router is currently available only on Teams and Enterprise, not on individual plans. The launch separates access from rollout defaults:

Product layerPublished status on July 23, 2026Important qualifier
TeamsRouter available and on by defaultAdmins can configure modes and Auto defaults in the team dashboard
EnterpriseRouter availableOff by default; an administrator must enable it
Desktop editorAvailableThe user selects Auto and an allowed optimization mode
WebAvailableOrganization policy still applies
iOSAvailableThis is access to Cursor's agent workflow, not a local mobile model runtime
Cursor CLIAvailableThe launch does not document a separate CLI routing algorithm
Cursor SDKAvailableSDK availability does not establish a public standalone Router API
Individual plansNot currently availableThe live Router docs limit the feature to Teams and Enterprise
Router source or weightsNot publishedRouter is a Cursor-managed product feature

The user-facing entry remains Auto. Selecting Auto now exposes Cost, Balance, or Intelligence when the administrator has allowed those modes. The previous Auto routing logic remains available as Cost rather than disappearing.

Cursor Auto model picker cycling through Intelligence, Balance, and Cost optimization modes
Cursor's official launch animation cycles through the three optimization modes. It demonstrates the product choice but does not reveal the changing pool of underlying models. Source

How request routing works

Cursor describes Router as a classifier that runs before a model handles each agent request. Its launch material says the classifier considers the query, available context, task complexity, domain, and Cursor's data about how models behave.

Developer request + conversation context
                  |
                  v
        Cursor Router classifier
       /          |             \
 task type     complexity      domain
       \          |             /
                  v
      allowed model pool + selected mode
                  |
                  v
      one underlying model handles the request
                  |
                  v
 response, usage, and quality signals

The decision is per request, not necessarily per chat. A conversation can therefore cross model boundaries. Cursor says its training and online evaluation account for the cache misses caused by switching models, an important detail because cached context can be cheaper than fresh input on many model price sheets.

Cursor reports training the classifier on more than 600,000 live requests and evaluating it in online A/B tests across millions of live requests. Cursor says it optimized the classifier for a user-satisfaction reward called AFC. It separately reports using both user satisfaction and keep rate—the share of agent-generated code that remains in the codebase over time—to evaluate Router output. Those are Cursor's own operational measurements. The company does not publish the classifier, its feature weights, a reproducible evaluation dataset, confidence intervals, or route-by-route decisions.

The model pool is also dynamic. Cursor says it updates routing as models ship, and users cannot hand-pick the model that handles a Router request. Choosing a mode steers the objective; it does not pin a model.

Cost, Balance, and Intelligence compared

The three names describe optimization targets, not fixed model tiers.

ModeCursor's documented behaviorBilling basisBest first useMain risk
CostPrevious Auto logic; optimize token spend while seeking the highest useful intelligenceBundled Auto rate per million tokens, independent of underlying modelRoutine coding, broad rollout with tighter budgets, baseline against old AutoMay not spend enough intelligence on the hardest tasks
BalanceOptimize intelligence, speed, and costActual routed model's API rate; eligible third-party routes also add the Cursor Token RateMixed daily work where quality matters but frontier spend should be selectiveVariable cost and faster usage-limit consumption than Cost
IntelligencePrefer the most capable models for hard requestsActual routed model's API rate; eligible third-party routes also add the Cursor Token RateDifficult debugging, long-horizon changes, and high-value tasksHighest and least predictable spend of the three modes

Cursor's docs say Balance and Intelligence cost about twice as much as Cost on average, and up to two to four times as much depending on the selected mode. That is a platform-level estimate, not a quote for one request. The selected model, token mix, cache behavior, retries, regional uplift, plan terms, and any private Enterprise contract still determine the bill.

A useful policy is to start with Cost and Balance, then add Intelligence only for a cohort with hard tasks and a measured reason to use it. That recommendation is an evaluation strategy, not Cursor's required setup.

How Cursor Router billing works

Router has two billing paths.

Auto Cost uses bundled rates

Cursor publishes these Auto Cost list rates as of July 23, 2026. Amounts are USD per million tokens:

Token typeAuto Cost list rate
Input$1.25
Cache write$1.25
Cache read$0.25
Output$6.00

The rate does not change with the model Cursor selects behind Cost. Auto Cost is also exempt from the Cursor Token Rate.

Balance and Intelligence use routed-model rates

For Balance and Intelligence, Cursor bills the model that actually handled the request. The general calculation is:

request charge
  = input tokens / 1,000,000 × routed-model input rate
  + cache-write tokens / 1,000,000 × routed-model cache-write rate
  + cache-read tokens / 1,000,000 × routed-model cache-read rate
  + output tokens / 1,000,000 × routed-model output rate
  + eligible third-party tokens / 1,000,000 × $0.25 Cursor Token Rate

On Teams and Enterprise, an eligible third-party model adds Cursor's $0.25 per million tokens Cursor Token Rate. Cursor says this applies to input, output, cache-write, and cache-read tokens, including BYOK requests. Auto Cost and Cursor first-party models, including Composer 2.5 and Cursor Grok 4.5, are exempt from that additional rate.

This means “billed at the routed model's rate” is not always the complete Teams invoice rule. For a third-party route, include both the model API fee and the Cursor Token Fee. Enterprise order forms can set different terms, and Cursor's published model prices can change with provider list pricing, so use the live Models & Pricing page or the applicable contract for a budget decision.

Balance and Intelligence also use plan limits faster than Cost. On Teams, usage remains allocated per paid seat and resets each billing cycle; on-demand usage is enabled by default. Enterprise can use pooled usage and per-member spend controls under its contract and admin features. Do not assume that a lower average route cost prevents overage when request volume grows.

What Cursor's savings evidence shows

Cursor published several related results. They need separate labels because the comparison baselines differ.

Cursor-reported resultComparisonScope disclosed by CursorWhat it does not establish
Auto Intelligence at about 60% lower costNear Claude Fable 5 user satisfactionCursor online A/B testing across production trafficA 60% saving against Opus 4.8 or a guarantee for another team
Auto Intelligence about 15% higher satisfactionClaude Opus 4.8 at nearly the same costCursor online A/B testingIndependent model quality or performance on a fixed public benchmark
Auto Balance at about 36% lower costAbove Opus 4.8 on Cursor's user-satisfaction measureCursor online A/B testingThe same result for every repository, prompt mix, or contract
30%–50% lower cost for three high-volume accountsActual early-access Auto traffic repriced as if every request used Opus 4.8 API ratesThree accounts with thousands of users during a two-week early-access periodA universal saving or an all-customer average
$6.76 / $4.63 cost per commitIntelligence / BalanceCursor's production analysisA causal benchmark with a published sample distribution

The launch's 60% headline is not the same experiment as the early-access Opus comparison. Cursor says the early-access accounts saved 30%–50% versus pricing all their traffic at Opus 4.8 rates. The 60% figure appears in Cursor's broader online A/B discussion and its near-Fable satisfaction comparison. Combining them into “60% versus Opus in early access” would overstate the source.

Cursor also reports cost per commit of $6.76 for Intelligence and $4.63 for Balance, compared with $12.69 for Fable 5 and $7.34 for Opus 4.8 in its analysis. Cost per commit is closer to an engineering outcome than cost per request, but Cursor does not publish the repository mix, commit definition, review burden, sample sizes by arm, or uncertainty. Treat the figures as a reason to run a team-specific pilot, not as a financial forecast.

A local evaluation should measure accepted change, retries, review time, incidents, and usage together. Lower model spend is not a saving if rejected changes move work to reviewers.

Hidden model identity and observability

Cursor hides the routed model by default and recommends that setting so users judge output rather than the model name. An administrator can instead display the underlying model at the start of each response for Balance and Intelligence.

Both choices have a legitimate use:

Visibility policyAdvantageCost
Hidden during a blinded comparisonReduces model-brand bias in subjective ratingsMakes route-specific regressions harder for a user to report
Visible during an operational pilotHelps correlate failures, latency, and spend with routed modelsCan change user behavior and contaminate blind quality judgments
Hidden after a stable rolloutSimpler product experience and less model chasingRequires strong centralized logs and billing data for diagnosis

A practical pilot can use two phases. First expose model identity to operators while validating model controls, billing, and regressions. Then hide it for a blinded user-quality comparison. Cursor's public docs do not describe a Router event API that exports every classifier decision, so confirm what the dashboard, spending data API, optional model label in Balance and Intelligence responses, completed SDK Run.model field, and contract make observable before relying on model-level incident analysis.

Do not infer the underlying model from style, latency, or token use. Those are noisy signals, and the eligible pool can change.

Admin controls and the Grok 4.5 requirement

Cursor's team dashboard provides four Router controls:

  1. Enable Cursor Router. Teams has it on by default; Enterprise must enable it. Enterprise can also apply the rollout to an organization group.
  2. Routing preferences. Choose which optimization modes members can select. Cursor says an admin can disable up to two modes.
  3. Underlying model visibility. Show the routed model at the start of a Balance or Intelligence response, or keep it hidden.
  4. Impose Auto. A soft policy starts each new chat on Auto but lets users switch. A hard policy locks the model picker to Auto. Both controls are off by default.

The changelog also says admins can allow or block underlying models. The current detailed docs narrow that feature: model access control is Enterprise-only. Router respects those controls, selecting an allowed alternative when one candidate is blocked.

The Enterprise policy interaction deserves a preflight check:

CheckPass condition
Cursor Grok 4.5Enabled for every Router pilot user
Prohibited providers or modelsBlocked in Enterprise model access control
Effective accessAt least one viable allowed route remains for each enabled mode
Group policyPilot users receive the intended team-plus-group combination
Spend controlsTeam and per-user limits match the pilot budget
Identity displayVisible for operator diagnosis or intentionally hidden for a blind phase
Auto policySoft for the first pilot; hard only after rollback and exception paths are proven

Organization-group permissions can combine with team settings. Cursor's group documentation says model access generally resolves as a union across the team and a user's groups, while team-level restrictions can still affect the experience. Inspect the effective policy for a test user rather than assuming the strictest-looking screen wins.

Router versus manual model selection

Router and manual selection optimize different forms of control.

CriterionCursor RouterManual model selection
Decision frequencyEvery agent requestWhen the user or policy changes the chosen model
Model identityManaged, dynamic, hidden by defaultKnown before the request
Cost predictabilityFixed bundled rates in Cost; route-dependent in Balance and IntelligenceModel rate known, but total tokens and retries still vary
Quality targetAggregate policy across mixed tasksModel-specific behavior
Cache continuityRouter may switch and cause cache misses; Cursor says its evaluations include themEasier to keep one model through a conversation
New-model adoptionCursor can update the pool without user actionTeam evaluates and enables each model explicitly
Compliance reviewRequires review of the eligible managed pool and effective controlsEasier when approval is tied to one provider/model
DebuggingRoute is another variableFewer variables for reproduction
User effortLower after policy setupHigher; users need model knowledge

Use Router when model choice is an operational optimization problem. Use a fixed model when model choice is part of the test specification, contractual boundary, or incident hypothesis.

A hybrid policy is often stronger than an all-or-nothing decision: Auto Cost or Balance for ordinary work, manual fixed models for benchmark runs, regulated repositories, known model-specific features, and regression reproduction. Cursor's soft Auto default supports that pattern; hard Auto does not.

For a broader editor-level decision, the Cursor versus Antigravity comparison covers product differences outside model routing. The Cursor, Kiro, and Codex mobile workflow guide explains what remote agent control from a phone does and does not mean. If a managed changing pool is the wrong boundary, the OmniRoute self-hosted routing guide shows the larger operational and security burden of controlling a gateway yourself.

A controlled rollout plan

A Router rollout changes quality, cost, model identity, and debugging at once. Keep the first pilot reversible.

1. Freeze a baseline

Choose four weeks of representative work if available. Record request volume, model mix, token and cache use, accepted changes, user corrections, retries, latency, cost, and incidents. Keep manual-model traffic as the comparison arm.

2. Define policy before enabling Router

List prohibited models and providers, approved data regions, contract exceptions, retention requirements, and required observability. Confirm that Grok 4.5 is allowed. Decide whether a dynamic model pool is acceptable at all.

3. Start with a bounded cohort

Use one team or Enterprise organization group. Prefer developers who can report technical failures and whose repositories are representative but not the highest risk. Apply a team spend cap and, on Enterprise, per-member limits where appropriate.

4. Begin with soft Auto

Enable Cost and Balance, set a soft Auto default, and leave manual selection available as rollback. Show underlying models during the diagnostic phase. Do not impose hard Auto until model restrictions, billing, and exception workflows pass.

5. Run a blinded comparison

After operational checks pass, hide model identity for a defined period. Randomize comparable tasks where possible and use the same acceptance rubric for Router and fixed-model traffic. Preserve raw failures, not only means.

6. Expand one variable at a time

Add Intelligence, a larger cohort, or hard Auto separately. If all three change together, a cost or quality movement cannot be attributed cleanly.

7. Set rollback triggers

Examples include a material rise in rejected diffs, critical policy failure, spend above the pilot cap, a required model becoming ineligible, or inability to identify a route during an incident. The rollback is to disable Router or return affected users to manual selection, not to keep testing through a broken boundary.

A team evaluation test plan

The best evaluation corpus mixes routine turns with tasks that genuinely need frontier reasoning.

WorkloadSuggested corpusAcceptance checksOperational metrics
Small code edit50 closed issues with focused diffsTests pass, no unrelated edits, reviewer acceptsMode, routed model when visible, tokens, cache use, latency, cost
Repository debugging20 reproducible failuresRoot cause identified, fix passes hidden regressionTool calls, retries, elapsed time, accepted-fix cost
Long-horizon change15 multi-file featuresRequirements met, architecture constraints preservedHuman interventions, reverted lines, cost per merged change
UI task20 frozen screenshots and requirementsFunctional checks, visual review, accessibility checksCorrections, latency, accepted-result cost
Routine explanation100 low-risk questionsFactual accuracy, useful citation or code locationCost, response time, escalation to more expensive routes
Policy-negative caseEvery blocked-model and data-policy scenarioNo prohibited route; Router fails safely if the pool is invalidPolicy logs, user-visible error, recovery time

Pre-register thresholds. One reasonable structure is:

  • no critical policy or data-boundary failures;
  • no regression in hidden-test pass rate beyond an agreed margin;
  • lower or equal cost per accepted change for Cost and Balance;
  • an explicit quality gain required before Intelligence may spend more;
  • p95 latency and correction rate within team limits;
  • billing export reconciles with sampled visible routes and current rate tables.

Run the same tasks through a fixed daily-driver model, Auto Cost, Auto Balance, and—only after the first gates pass—Auto Intelligence. Do not compare different task mixes or count failed cheap attempts as savings.

Limits and open questions

Cursor's public material describes the product and its production experiments, but does not provide what an independent team would need to reproduce the router.

  • No public classifier artifact. Training data, feature weights, model, and route thresholds are not published.
  • No fixed model pool contract in public docs. The pool changes as models ship, so compliance and reproducibility need process controls.
  • No independent savings study is cited. Quality, cost, satisfaction, keep rate, and cost-per-commit results are Cursor-reported.
  • Incomplete experiment detail. The launch gives traffic scale and comparison summaries but not confidence intervals, assignment detail, task distribution, or full denominator definitions.
  • No universal savings number. The 60%, 36%, and 30%–50% figures use different comparisons and scopes.
  • Cost is still workload-dependent. Token mix, cache misses, retries, regional data-residency uplift, the Cursor Token Rate, and contract pricing matter.
  • No separate Router service contract is documented. Cursor's public launch and Router docs do not describe a standalone Router API or self-hosted component; availability in Cursor's SDK refers to using Auto within the SDK.
  • Model visibility is not full observability. Showing a model in the response helps diagnosis, but teams should confirm export, retention, and billing detail before relying on it for audits.

The organizational decision is whether Cursor's managed optimization loop provides enough control and evidence for the work being routed.

Use it or skip it

Use Cursor Router when the team has varied coding work, spends too much attention on model picking, accepts a changing approved pool, and can evaluate quality and cost at the accepted-task level. Start with soft Auto, a bounded cohort, visible model identity for diagnosis, and spending limits.

Keep manual selection when a fixed model is part of reproducibility, provider approval, contract terms, data policy, benchmark design, or regression analysis. It is also the safer fallback when model controls leave too small a Router pool.

Use a hybrid policy when ordinary work benefits from Router but a minority of tasks needs fixed models. Auto Cost or Balance can cover the broad path while manual selection remains available for approved exceptions.

For the Router prerequisite itself, the Cursor and SpaceXAI Grok 4.5 launch analysis covers model pricing and claims separately. Do not treat Grok 4.5's eligibility as proof that it handled a particular Router response.

FAQ

What is Cursor Router?

Cursor Router is the managed model-routing system behind Auto for Cursor Teams and Enterprise. Balance and Intelligence run a classifier on each agent request and send it to an eligible model; Cost preserves the previous Auto routing logic and bundled pricing.

How are Cursor Router requests billed?

Auto Cost has bundled per-million-token pricing regardless of the underlying model. Auto Balance and Auto Intelligence use the routed model's API rate; eligible third-party routes on Teams and Enterprise also incur Cursor's $0.25-per-million-token Cursor Token Rate. Contract terms can differ.

Can users see which model Cursor Router selected?

The underlying model is hidden by default. An administrator can configure Cursor to display the routed model at the start of each response for Balance and Intelligence modes.

Can Enterprise admins block models used by Cursor Router?

Yes. Cursor says Router respects Enterprise model access controls and routes to an allowed alternative when a model is blocked. Cursor also warns that blocking too many models can reduce routing quality or disable Router, and its current docs require Cursor Grok 4.5 to remain enabled.

When is manual model selection better than Cursor Router?

Manual selection is better when a workflow requires a fixed provider or model, reproducible model-specific evaluation, predictable per-token rates, direct comparison of a model regression, or a compliance policy that does not permit a changing managed pool.

Does Cursor Router guarantee 60 percent savings?

No. Cursor reports a 60 percent lower-cost result for Auto Intelligence at near-Fable satisfaction in its own online testing. Its separate early-access comparison against pricing every request at Opus 4.8 rates reported 30 to 50 percent savings for three high-volume accounts. Neither result guarantees savings for another team's workload.

Get the latest on AI, LLMs & developer tools

New MCP servers, model updates, and guides like this one — delivered weekly.

Official sources and further reading

Router launch and product behavior

Billing and administration

Related AgentPedia guides

Related Guides