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 承诺答复审计。
  • 把当前价格写死到内部文档,不定期核验。

官方来源

接下来去哪

本页目录