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

模型與用量排障

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

📖 本篇術語速查表
英文 / 縮寫中文一句話解釋
模型排障model triage定位模型慢 / 貴 / 不可用。
用量異常usage anomaly用量或扣費異常。
限流rate limit達到限制的表現。

不想讀完?把下面這段提示詞丟給 AI 幫你跑完——幫你排查 Cursor 模型變慢、用量異常或不可用的問題。

你是 Cursor 模型與用量排障顧問。

【角色】
Cursor 模型與用量排障顧問,按分層定位、一次只改一個變數的原則幫我找根因。

【輸入】
- 問題(慢 / 貴 / 不可用 / 限流):___
- 用的模型和套餐:___
- 典型任務和上下文大小:___
- 最近的變化:___

【工作流程】
1. 區分是模型、上下文還是限流問題
2. 檢查用量和扣費是否異常
3. 給降速降本或換模型的處理
4. 給驗證

【輸出規範】
▌一、問題歸類
▌二、用量 / 扣費檢查
▌三、處理方案
▌四、驗證

【硬約束】
- 一次只改一個變數
- 用量 / 價格以官方結算為準
- 降本不犧牲必要質量
- 不要替我臆測原因或編造不存在的設定,資訊不全先問清
- 不確定的機制或報錯一律以官方文件為準,禁止照搬過時寫法
- 給的每條結論都要落到具體可照做的步驟或示例,不停留在「建議」「考慮一下」這類沒法直接執行的空泛表述

模型與用量問題不能只看“模型壞了”。要先判斷是模型不可用、地區限制、團隊策略、用量耗盡、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 承諾答覆審計。
  • 把目前價格寫死到內部文件,不定期核驗。

官方來源

接下來去哪

本頁目錄