疑难排查
Cline API 报错——API Request Failed、401、429、上下文超限
Cline 把大多数故障显示为 "API Request Failed" 横幅，下方附带提供商的响应。横幅本身并不是诊断结论——响应体里的状态码和 error.type 才是。下面的页面把每种响应体映射到对应的修复方法。
| 错误 | 含义 |
|---|---|
API Request Failed | Cline 的 API Request Failed 横幅只是提供商响应的包装。如何读取其下的状态码和 error.type，把自己引导到真正的修复方法。 |
{"type":"error","error":{"type":"authentication_error","message"… | 当 Anthropic 兼容端点拒绝密钥时，Cline 返回 401 invalid x-api-key：base URL 字段填错、密钥带空白，或密钥已被吊销。修复清单如下。 |
{"type":"error","error":{"type":"rate_limit_error","message":"Th… | Cline 的智能体运行会快速烧光每分钟 token 预算，然后陷入 429 重试循环。为什么智能体负载会触发速率限制，以及如何让一次运行跑完。 |
input length and `max_tokens` exceed context limit: 199999 + 819… | 当 Cline 累积的任务上下文加上输出预留装不进模型窗口时，会出现 400 input length and max_tokens exceed context limit。如何恢复。 |
Cline API Request Failed——诊断真正的错误
Cline 的 API Request Failed 横幅只是提供商响应的包装。如何读取其下的状态码和 error.type，把自己引导到真正的修复方法。
Cline 401 invalid x-api-key（Anthropic）解决方法
当 Anthropic 兼容端点拒绝密钥时，Cline 返回 401 invalid x-api-key：base URL 字段填错、密钥带空白，或密钥已被吊销。修复清单如下。
Cline 429 rate_limit_error——终止重试循环
Cline 的智能体运行会快速烧光每分钟 token 预算，然后陷入 429 重试循环。为什么智能体负载会触发速率限制，以及如何让一次运行跑完。
Cline 报 input length and max_tokens exceed context limit 的解决方法
当 Cline 累积的任务上下文加上输出预留装不进模型窗口时，会出现 400 input length and max_tokens exceed context limit。如何恢复。
全部工具 · Claude API 错误码 · 配置指南