Cursor 限流报错：rate limit / too many requests 怎么办

正写着代码，对话框突然弹一句，文案大致是 You've hit your rate limit、Too many requests，或者 You've hit your limit，光标转着圈发不出去。装都装好了、钱可能也付了，偏偏这会儿用不了。第一反应别是卸载重装，也别是狂点重试，先花一分钟分清你撞上的是哪一种「被限」，三种的救法完全不同。

先分清三种「被限」

发一句最短的话，比如「回一个 ok」，再看提示落在哪一类（具体文案随版本会变，以你屏幕上的原文为准）：

1. 短时高频限流，文案多含 too many requests 或 rate limited。你在很短时间里发了太多请求，属于临时限速，等几十秒到几分钟通常自己恢复。
2. 套餐用量上限，文案多含 You've hit your limit 或 usage/request limit。这不是网络问题，是这个计费周期的额度到顶了，得去账号 Usage 里看。
3. 高峰期供应商侧繁忙，文案多含 high demand 或某模型 busy。上游模型在挤，换 Auto、换个模型或错峰往往就好。

还有一种长得像、其实不是限流的：报 Model not available 或 This model provider doesn't serve your region。那是区域问题，不是额度用尽，别混在一起排，走 区域不可用排查。

撞上时先别做的三件事

别急着卸载重装，限流几乎都在账号或上游侧，重装解决不了。别对着报错狂点重试，短时高频恰恰会把临时限流拖得更久，甚至叠加。也别注册小号绕开，既解决不了额度，还容易触发风控，把主账号也搭进去。

按类型对症

短时高频限流最简单：停手等一会，把连着刷任务的 Agent 收掉，别让它在后台一直发请求；把几个小问题合并成一次问，降低发送频率，一般很快恢复。

套餐用量上限要看数据，别凭感觉。打开账号里的 Usage，确认是不是这周期真到顶了，读法见 Dashboard / Usage 怎么看。到顶之后的选择就三条：等重置日、升级或按量付费（对着 官方定价页 看清买到的是什么），或者把全程顶配的模型换成 Auto、性价比档，省着用到重置，选型见 模型怎么选。

高峰繁忙就错峰：切到 Auto 让客户端挑一个当前顺畅的模型，或换一个没那么挤的型号，过一会再试。这类往往是暂时的，不用改设置。

从源头少触发限流

限流很多时候是用法太猛喂出来的。任务切小，一次只交一个可验收目标，别让一条 Agent 从早跑到晚。别开着 Agent 去扫全库，无关目录逛一圈，请求数和上下文都白涨。也别全程顶配，排错、读栈、改单文件用中上模型就够，把强模型留给关键路径。上下文收窄一点，少 @ 无关文件、少重复贴长日志，既省额度也少踩高频限速。这套习惯和省 token 是同一件事，可对照 Agent 入门 里的小步验收。

国内用户常见的叠加情况

国内环境容易把两件事搅在一起：一边是限流或区域不可用，一边是官方支付不顺，想升级换更高额度却付不了款。先分清你卡在哪一层。纯粹是额度到顶、支付又过不去，那是支付通道问题，可以看 自定义 API / BYOK，把模型走自己能付的通道；CodePass 这类服务解决的是「请求能不能稳定发出去、怎么计费」，替不了你审代码，也不改官方的限流规则。但如果报的是区域不可用，那跟额度无关，别去充值，先按区域那篇排。

怎么算这次排查完了

1. 发一句最短提问，确认现在到底是临时限速、额度到顶，还是区域不可用（三者文案不同）。
2. 是临时限速：停手、收掉后台 Agent，等一两分钟再发，能通就结束。
3. 是用量上限：打开 Usage 核实周期与剩余，再决定等重置、升级还是换低配模型。
4. 是区域不可用：转到区域排查，别在这条线上耗。

一句话收尾：限流不是「Cursor 坏了」，是它在告诉你「这会儿发太快」或「这周期用到头了」。看清报错原文、分对类型，比反复重装和狂点重试省事得多。额度怎么读见 Usage，套餐怎么选见 价格与套餐。