Cursor Router 是 Auto 背后的模型路由系统。并非每个请求都需要前沿级智能，路由器会根据任务为每个请求选择合适的模型：简单请求会交给快速高效的模型处理，复杂任务则会交给能力最强的模型。
Cursor Router 目前仅适用于 Teams 和企业版方案。
工作原理¶
在模型选择器中选择 Auto，并选择 Balance 或 Intelligence 后，Cursor Router 会对每个智能体请求运行分类器，并根据任务类型和复杂程度进行路由。路由器会为该请求选择在保证相近质量的前提下成本效益最高的模型。
Cursor Router 由 Cursor 基于数据进行管理。你无法手动指定由哪个模型处理请求；随着新模型上线，模型池也会不断变化。你可以通过选择优化模式来引导路由。
在企业版方案中，Cursor Router 会遵循团队的模型访问控制。如果某个模型被团队禁用，路由器会改用允许使用的模型。禁用过多模型会降低路由质量，甚至可能导致路由器无法使用。为节省成本，路由器在不调用其他前沿模型时，需要使用一款性能强大且成本高效的模型，因此必须启用 Cursor Grok 4.5，路由器才能正常运行。
优化模式¶
打开模型选择器，选择 Auto，然后在 Optimize For 下选择一种模式：
- Cost：沿用此前的 Auto 路由逻辑，优化 token 支出。
- Balance：在智能性、速度和成本之间取得平衡。
- Intelligence：针对较难的任务路由到能力最强的模型，成本低于使用单个前沿模型运行。
Balance 和 Intelligence 消耗您的用量限额比 Cost 更快。您可以随时切换模式。
定价¶
所有 Auto 模式均按每个请求路由到的模型标价计费。第三方模型还需支付 Cursor Token 费率。
截至 2026 年 9 月 7 日，企业版 Auto Cost 定价按每百万 token 计费，无论使用哪个模型 (输入和缓存写入 $1.25/1M，缓存读取 $0.25/1M，输出 $6.00/1M) 。
团队设置¶
管理员可通过团队仪表盘配置 Cursor Router。
- 启用 Cursor Router：开启或关闭路由功能。启用后，使用 Auto 的团队成员将由 Cursor Router 路由。企业版团队需手动启用路由器，因为它默认处于关闭状态。企业版方案还可按组织群组配置路由器。
- 路由偏好设置：选择团队成员可在 Auto 中选择的优化模式。最多可禁用 2 种模式。
- 底层模型：在每个回复开头显示 Auto 路由到的模型，或将其隐藏。默认推荐隐藏，以便根据结果本身而非模型名称进行评判。适用于 Balance 和 Intelligence 模式。
- 强制使用 Auto：将 Auto 设为团队所有成员的默认模型。软性会将每个新聊天的默认模型设为 Auto；成员仍可切换模型。硬性会将模型选择器锁定为 Auto。两者默认均处于关闭状态。
通过 SDK 使用 Router¶
TypeScript SDK 和 Python SDK 将 Cursor Router 以模型 ID auto-smart 的形式提供，并支持参数 optimize_for (cost、balanced 或 intelligence) 。在硬编码选择之前，请调用 Cursor.models.list() 确认该 API 密钥所属团队可使用 Router。
TypeScript¶
import { Agent } from "@cursor/sdk";
await using agent = await Agent.create({
apiKey: process.env.CURSOR_API_KEY!,
model: {
id: "auto-smart",
params: [{ id: "optimize_for", value: "balanced" }],
},
local: { cwd: process.cwd() },
});
Python¶
import os
from cursor_sdk import Agent, LocalAgentOptions, ModelParameterValue, ModelSelection
with Agent.create(
model=ModelSelection(
id="auto-smart",
params=[ModelParameterValue(id="optimize_for", value="balanced")],
),
local=LocalAgentOptions(cwd=os.getcwd()),
) as agent:
...
SDK 用于运行 Cursor 智能体工作流，并非独立的聊天补全或原始推理 API。有关目录发现、单次运行的模式覆盖和疑难排查，请参阅 TypeScript SDK 中的 Cursor Router 或 Python SDK。
