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。
