AI 程式設計教程中文版
官方教程中文版Help Center 與排障

模型與用量排障

按 Cursor 官方幫助梳理模型選擇、Auto/Premium、API keys、usage limits、on-demand 和 token rate 的排障路徑。

模型與用量問題不能只看“模型壞了”。要先判斷是模型不可用、地區限制、團隊策略、用量耗盡、on-demand 未開、BYOK 供應商失敗,還是任務本身需要換模式。

核驗日期:2026-05-06。模型列表、價格、套餐額度、token rate 和區域可用性高度波動;涉及費用和採購時必須回到官方 pricing、dashboard 和模型參考頁複核。

1. 一句話判斷

優先用 Auto 做日常任務,用 Premium 或具體 frontier model 做複雜任務;排障先查 Dashboard Usage,再查模型選擇、地區、團隊許可權和 BYOK。

不要把賬單和模型能力混在一起。模型越強不等於更適合所有任務,尤其是自動化、反覆除錯和大上下文消耗場景。

2. 模型怎麼選

官方說明 Cursor 支援自己的 Composer,以及 OpenAI、Anthropic、Google、xAI 等供應商的 frontier models。可用模型取決於計劃,Hobby 可用模型較少,付費計劃解鎖更多模型。

常用判斷:

  • Auto:日常任務優先。Cursor 自動平衡 intelligence、cost、reliability。
  • Premium:複雜任務。由 Cursor 基於內部評測和使用者反饋選擇更強模型。
  • Composer:Cursor in-house model,適合快速互動式編碼。
  • Claude Opus / GPT Codex:更適合複雜、多步驟任務。
  • Gemini Pro / Grok:部分使用者會在特定任務中偏好。

切換入口:

  • 開啟 chat 或 agent panel 頂部 model selector。
  • 選擇目標模型。
  • 也可以按 Cmd + / 迴圈切換模型。
  • 選擇會跨 conversation 保留,直到使用者再次修改。

3. 費用和用量怎麼判斷

官方幫助頁給出的當前口徑:

  • Auto 使用固定 token rates。
  • Premium 按所選模型的 API rate 計費。
  • Cursor 對 provider API rate 不加 markup。
  • 當前 individual plans 中,Max Mode 按模型 API rate 計費。
  • legacy request-based plans 中,Max Mode 有 20% surcharge。

當前 usage limits 官方頁還列出這些計劃額度示例:

  • Pro:$20/mo,包含 $20 API agent usage。
  • Pro Plus:$60/mo,包含 $70 API agent usage。
  • Ultra:$200/mo,包含 $400 API agent usage。

這些數值必須以官方頁面和 dashboard 為準,不適合作為長期靜態報價。

4. 用量排障順序

遇到 “limit reached”、“model unavailable”、“請求變慢”、“賬單異常” 時按順序查:

  1. Dashboard Usage 是否顯示 included usage 耗盡。
  2. 是否啟用 usage-based pricing / on-demand。
  3. 是否設定 spend limit。
  4. 當前模型是否高價或 Max Mode。
  5. Team 或 Enterprise 是否限制了模型訪問。
  6. 模型是否因地區限制不可用。
  7. 是否使用 BYOK,且 provider 自身是否拒絕請求。
  8. 是否用 Agent 反覆跑大上下文任務,導致 token 消耗異常。

5. API keys 與 BYOK

BYOK 可以讓使用者使用自己的 provider key,但它會改變隱私和賬單邊界。

排障時必須問:

  • 用的是 Cursor included models 還是自己的 API key。
  • API key 屬於 OpenAI、Anthropic、Google、Azure、AWS Bedrock 或其他 provider。
  • provider 是否限制地區、組織、模型或速率。
  • Team / Enterprise 是否停用了 BYOK。
  • 使用 BYOK 時,資料處理是否仍滿足組織安全要求。

官方隱私頁明確說明:ZDR 不適用於使用者自己的 API keys,資料處理遵循使用者選擇的 provider policy。

6. “Model not available” 怎麼處理

官方解釋:某些模型可能因模型供應商地區限制不可用,不是 Cursor 自己設定的限制。

可選處理:

  • 使用 Auto,讓 Cursor 在可用模型中選擇。
  • 換其他 provider 的模型。
  • 如果公司允許,使用能服務該地區的 BYOK。
  • 查 provider supported regions。
  • Enterprise 環境再查 Team Dashboard 的 model restrictions。

7. 商業級驗收

  • 使用者能在 model selector 看見當前模型。
  • Dashboard Usage 能解釋請求消耗、剩餘額度和 on-demand。
  • 模型不可用能區分地區限制、團隊策略、BYOK 失敗和套餐限制。
  • 費用問題能區分 subscription、included usage、on-demand、Max Mode。
  • 團隊知道 Auto / Premium / Composer / frontier models 的適用邊界。
  • BYOK 使用前完成隱私和 provider policy 審查。

8. 常見失敗點

  • 把 “model not available” 當成客戶端 bug。
  • 不看 Dashboard Usage,直接猜測模型限流。
  • 用高價模型跑大量低價值自動化。
  • 啟用 BYOK 後仍按 Cursor ZDR 承諾答覆審計。
  • 把當前價格寫死到內部文件,不定期核驗。

官方來源

接下來去哪

本頁目錄