疑难排查 · 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 limit
  • cline retrying request

常见问题

为什么 Cline 比聊天工具更快撞上 429?+
代理的一步不是一条消息——每次迭代都是一个新请求,带着历史、文件上下文和工具输出。它的请求速率是聊天的好几倍。
立即重试有用吗?+
没用——立即重试会让窗口一直满载。按 Retry-After 的间隔退避才能把它清空。
这是 Cline 自己的限制吗?+
不是。使用你的密钥时,Cline 没有自己的计量;429 是该密钥背后账户的上限。

跳过折腾坏掉的配置

apiToken.sale 通过 OpenAI 兼容端点、Messages(Anthropic 格式)端点和原生 Gemini 端点提供 GPT 与 Gemini 模型——标准 SDK、一把密钥、一个预付余额。把你工具的 base URL 指向它,本页的配置即可原样生效。