Cline API Error 排查：401、404、429 和连接失败

正确配置位置

1. 打开 Cline，点击设置齿轮；
2. API Provider 选择 OpenAI Compatible；
3. Base URL 填 https://api.openlux.ai/v1；
4. 填入 API Key；
5. 填写控制台当前可用的 Model ID，然后 Verify。

先用 curl 隔离客户端问题

curl https://api.openlux.ai/v1/models \
  -H "Authorization: Bearer 你的_API_Key"

能返回模型列表而 Cline 失败，问题更可能在 Cline 的 Provider 或 Model ID 配置。不要公开粘贴完整返回中的敏感字段。

按状态码处理

• 401/403：Key 错误、失效或无权限；
• 404：Base URL 路径或 Model ID 不匹配；
• 429：余额、并发或速率限制；
• 5xx：记录 request ID，稍后重试并查看服务状态；
• 超时：先检查 DNS、防火墙及系统代理。

仍失败时收集这些信息

保留 Cline 版本、Provider、脱敏后的 URL、Model ID、状态码、request ID 与发生时间。永远不要在工单、群聊或截图中展示完整 Key。

常见问题

Base URL 要不要加 /v1？

Cline 的 OpenAI Compatible 配置中，OpenLux 使用 https://api.openlux.ai/v1。

为什么 Verify 成功但对话失败？

常见原因是所选模型不支持当前工具调用、上下文超限或账户额度变化；查看实际响应状态码。

参考资料

Anthropic：LLM gateway configuration · Cline：OpenAI Compatible