疑难排查 · Cline
Cline 429 rate_limit_error——打破重试循环
Cline 的代理运行一个接一个地发送请求,然后在 429 重试中打转。为什么代理负载会触达账户的速率上限,以及如何让一次运行顺利完成。
你看到的报错
HTTP 429
{"error":{"message":"Rate limit reached. Please retry shortly.","type":"rate_limit_error","param":null,"code":"rate_limit_exceeded"}}为什么会发生
- 代理循环每一步发送一个请求,一个接一个,所以单个活跃任务自己就可能触达账户的速率上限。
- 这把密钥与其他工具或同事共用,他们的流量计入同一个上限。
- 在已饱和的窗口内自动重试,会让窗口一直饱和。
如何解决
- 让一个 429 过去——Cline 会退避并重试。如果一次运行在 429 上反复循环,暂停一分钟,而不是一次次重启它。
- 每把密钥同一时间只运行一个 Cline 任务,长时间运行期间暂停共用这把密钥的其他工具。
- 如果你长期需要更高的吞吐量,请向密钥的签发方提高上限,而不是用重试去硬扛。
相关搜索
cline 429 rate limitcline retrying request
常见问题
为什么 Cline 比聊天工具更快撞上 429?+
代理的一步不是一条消息——每次迭代都是一个新请求,带着历史、文件上下文和工具输出。它的请求速率是聊天的好几倍。
立即重试有用吗?+
没用——立即重试会让窗口一直满载。按 Retry-After 的间隔退避才能把它清空。
这是 Cline 自己的限制吗?+
不是。使用你的密钥时,Cline 没有自己的计量;429 是该密钥背后账户的上限。
全部 Cline 错误 · API 错误码 · 配置指南