模型与用量排障
按 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”、“请求变慢”、“账单异常” 时按顺序查:
- Dashboard Usage 是否显示 included usage 耗尽。
- 是否启用 usage-based pricing / on-demand。
- 是否设置 spend limit。
- 当前模型是否高价或 Max Mode。
- Team 或 Enterprise 是否限制了模型访问。
- 模型是否因地区限制不可用。
- 是否使用 BYOK,且 provider 自身是否拒绝请求。
- 是否用 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 承诺答复审计。
- 把当前价格写死到内部文档,不定期核验。
官方来源
- https://cursor.com/help/models-and-usage/available-models.md
- https://cursor.com/help/models-and-usage/api-keys.md
- https://cursor.com/help/models-and-usage/usage-limits.md
- https://cursor.com/help/models-and-usage/token-rate.md
- https://cursor.com/docs/models-and-pricing.md