---
title: "模型与用量排障"
description: "按 Cursor 官方帮助梳理模型选择、Auto/Premium、API keys、usage limits、on-demand 和 token rate 的排障路径。"
verifiedAt: "2026-05-09"
---
模型与用量问题不能只看“模型坏了”。要先判断是模型不可用、地区限制、团队策略、用量耗尽、on-demand 未开、BYOK 供应商失败，还是任务本身需要换模式。

> [!NOTE]
> **核验日期**：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 承诺答复审计。
- 把当前价格写死到内部文档，不定期核验。

## 官方来源

- [https://cursor.com/help/models-and-usage/available-models.md](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/api-keys.md)
- [https://cursor.com/help/models-and-usage/usage-limits.md](https://cursor.com/help/models-and-usage/usage-limits.md)
- [https://cursor.com/help/models-and-usage/token-rate.md](https://cursor.com/help/models-and-usage/token-rate.md)
- [https://cursor.com/docs/models-and-pricing.md](https://cursor.com/docs/models-and-pricing.md)

## 接下来去哪

<Cards>
  <Card title="继续下一页" description="104-security-privacy-help" href="/docs/cursor/official/07-help-troubleshooting/104-security-privacy-help" />
  <Card title="模型理解篇" description="把费用和模型选择放进工作流" href="/docs/cursor/understanding/10-models-pricing-usage" />
  <Card title="企业模型控制" description="继续看团队限制和 BYOK" href="/docs/cursor/official/06-teams-enterprise/88-model-integration-management" />
</Cards>
