遇到 Cursor 报 Max tokens exceeded,很多人的第一反应是去找设置里能调大 token 的选项。实际上这个操作方向不对。先要做的是定位超限到底发生在哪一层。
在 Cursor 中出现 Max tokens exceeded 提示,首先需要确认是当前请求一次性的 token 超出模型上限,还是整个对话累计的上下文超限。两者的处理方式不同。如果只是单次请求,通常是因为选中了大段代码或文件内容;如果是在持续对话后出现,则要考虑历史消息占用了大量上下文。建议先查看对话窗口侧边栏是否有 token 占用统计,若没有,可以尝试复制当前问题到新对话中,若问题不再出现,则基本可以判断是上下文累计超限。
如果你用的是项目问答模式,还需要留意 Cursor 是否把项目索引结果也塞进了上下文。判断方法很简单:新建一个空白对话,只粘贴当前报错的文件内容,如果不再报错,那就是索引文件或历史消息占了空间。
缩小上下文范围,而不是硬调参数
最直接的调整办法是缩小上下文范围。在 Cursor 中,可以通过取消勾选无关的文件引用,只保留当前修改的文件,来减少每次请求携带的内容。如果对话已经很长,使用 New Chat 开启新会话,或者使用 /clear 命令清空历史,但注意会丢失之前的上下文信息。对于需要保留常用指令的用户,可以把一些固定要求写入 .cursorrules 文件中,这样每次会话都会自动加载,而不必在对话中重复陈述,从而节省 token。
这里的“无关文件引用”需要具体操作:在 Chat 输入框下方的上下文选择区域,取消勾选那些只是被检索到但当前不相关的文件。如果你不确定哪些文件被带上了,可以点开 Context 或文件引用列表查看。对于 .cursorrules 文件,需要注意它不是用来写临时指令的,而是放那些每次都要生效的固定约束,比如“不要解释代码,只输出修改结果”,这类规则持续占用固定 token,所以不要写太长。
没有 token 滑动条,能控制的是发送量
在 Cursor 设置中,并没有一个可以直接调整 token 上限的滑动条。模型能够接受的 token 数量由后端模型决定,比如不同模型有不同上下文长度。用户能做的只是控制发送给模型的 token 数量。如果你的工作需要频繁处理长文件,可以尝试在 Chat 中分段提问,或使用编辑器打开文件后只选择关键函数,再发送给模型,而不是把整个文件内容粘贴进去。
所谓“调整参数”,在 Cursor 里真正可行的只有控制发送量。如果你确实需要让模型看长文件,优先选择文件中的关键函数或类,而不是整个文件。分段提问也一样,先让模型总结第一段,再让它基于总结继续处理第二段,比一次性发送全部代码更稳定。
观察 token 消耗的实际方法
Cursor 的 Chat 界面有时会显示 token 计数,但这个功能并不是所有版本都有。如果你看不到计数器,可以打开 Cursor 的设置,查看当前所选模型的 context length 参数。然后根据你自己的文本长度做粗略估算:中文通常 1.5 个字符对应 1 个 token,代码通常 3 到 4 个字符对应 1 个 token。这个估算只用于判断是否要继续拆分任务,不要当作精确用量的依据。
更直接的办法是观察请求日志,但普通用户一般接触不到。退一步说,如果你反复遇到同样的报错,可以打开一个新对话,让模型只回答一个最小问题,如果正常,说明是之前对话里的噪声太多,而不是模型本身的问题。
两个容易忽略的坑
使用项目级问答时,Cursor 会自动把项目索引里相关的文件内容打包进上下文,即使你没有主动选择它们。大型数据文件、node_modules、dist 目录都可能成为 token 消耗大头。解决办法是在项目根目录创建 .cursorignore 文件,把这类目录加进去,例如:
.cursorignore
node_modules/
dist/
*.log
*.zip
另一个坑是编辑器和 Chat 共享上下文。你在编辑器中选中一块代码,即使只是临时看一眼,Cursor 也可能把它当成上下文发送。所以当你只想问一个和选中代码无关的问题时,先按 Escape 取消选择,或者在 Chat 里手动检查输入框上方的引用列表。
清理后仍报错时的下一步
如果清理完上下文、取消选择大文件之后还是继续报错,先确认当前模型本身是不是不支持更长上下文。有的情况下你可以暂时切换到上下文更长的模型,但不要尝试通过修改 API Key 或请求参数去硬突破限制。Cursor 是闭源工具,内部会校验输入长度,超限会直接拒绝请求,而不是自动截断。反复重试同样的内容只会消耗额度,甚至可能进入更长的冷却状态。
如果你必须要处理一个超长文件,另一个办法是把它拆成多个部分,分别对话后手动合并结果。虽然麻烦,但不占用额外风险,也能保证每次请求都在模型能力范围内。