Cursor 卡在 planning next moves 怎么办:排查顺序与临时绕过
Agent 一直停在 Planning next moves / planning next move 时,按网络与 API、模式切换、重启会话、降级模型、看日志的顺序排查,并说明和「Predict next moves」不是同一功能。

状态栏或 Agent 面板长时间停在 Planning next moves(也有人写成 planning next move),界面不报错、也不继续改文件——这是排障类高意图查询。先分清:它通常是 Agent 在规划/等模型 的卡死态,不是编辑器里「Predict your next moves」那种预测光标功能(GitHub Discussion 里禁用预测是另一件事)。
先做 2 分钟分流
- 看网络与代理:公司 VPN、系统代理、SSL 拦截会导致「一直 planning」。换网络或关代理试一次。
- 看是否所有模式都卡:Auto、指定模型、Ask 是否全挂。全挂更像账号/网络/服务端;只有某一模型挂更像该路由或 BYOK Key。
- 看是否只有某一个仓库卡:换一个空文件夹新窗口试。仓库索引损坏或超大上下文可能导致规划阶段空转。
账号掉线类症状对照 账号掉线排查;支付失败导致能力降级对照 payment failed。
推荐排查顺序(由轻到重)
1. 停掉当前 Agent,开新会话重述任务。
旧线程上下文过长时,规划阶段会反复转。把目标写成 3 条验收标准,新开 Agent。
2. 从 Auto 换成单一稳定模型,或反过来。
Auto/Router 在分流时若后端某一环超时,表现就是一直 planning。指定一个你常用的模型试;若只有 Router 卡,先关 Auto。Router 背景见 changelog 相关说明,决策文可参考 还该不该换 Cursor。
3. 检查 BYOK / 自定义 Base URL。
自备 Key 无效、额度用尽、或第三方 bridge 挂了,也可能卡在规划。临时关掉 API Keys,改用 Cursor 内置模型验证。配置边界见 BYOK 怎么配置。
4. 重启 Cursor + 签出再签入。
排除卡死的本地进程与过期 session。
5. 看本地日志。
社区反馈里,有人在日志中看到 API 直接失败却只在 UI 显示 planning。按官方文档打开日志目录,搜 error / 401 / 429 / ECONN。有 429 就降并发、换时段;有 401 就重新登录或换 Key。
6. 仍不行:更新或回退版本。
个别版本回归会导致 Agent 规划环卡死;论坛常见建议包括更新到最新,或临时回退到上一稳定版(以你环境可回退包为准)。
临时绕过:先把活干完
- 把大任务拆成「只改一个文件」的短 Agent,降低规划复杂度。
- 改用 Chat + 手动应用补丁,避开 Agent 循环。
- Side Chat 做只读调查,主 Agent 暂停,见 Side Chat 用法。
- 终端向任务可暂切 Claude Code / Codex,见 三者怎么选。
和「Predict next moves」别搜串
若你要关的是编辑器预测/提示下一步编辑,应搜设置项或社区讨论里的 Predict your next moves,而不是 Agent 的 Planning 状态。两个英文短语接近,意图完全不同:一个是功能开关,一个是故障态。
常见问题
卡着会不会一直扣费?
视模式与后端是否在重试而定。长时间无输出时,手动 Stop Agent,避免空转。BYOK 用户更要看提供商控制台是否在刷失败重试。
只有某个项目卡?
优先清该工作区缓存、缩小打开的文件夹、排除 node_modules/构建产物被索引。必要时用「打开单包路径」而不是整个 monorepo。
重装能好吗?
重装是最后手段。先完成网络、会话、模型、Key、日志五步;重装前导出设置。