解决： ① 检查 API Key 是否完整（无多余空格、换行）；② 确认 Base URL 是否匹配所选 Provider——选 OpenAI Compatible 时需要手动填 Base URL；③ 浏览器访问 API 地址确认可达（国内直连测试 —— DeepSeek API 可直连，OpenAI/Anthropic 需中转）；④ 检查 API 账户余额是否充足；⑤ 切换 Provider 再切回来，强制刷新连接。
DeepSeek 配置后报 401
DeepSeek 配置后报 401
用 DeepSeek 作为 Provider 时报认证错误。
解决： ① 确认在 platform.deepseek.com → API Keys 后台 Key 状态为'有效'（非'已过期'）；② DeepSeek 的 Base URL 填写 https://api.deepseek.com（注意不要加 /v1 后缀，Cline 会自动拼接）；③ 刚创建的 Key 需要等 1-2 分钟生效；④ 确认账户余额 > 0（新用户有免费额度）。
模型回复质量差
模型回复质量差
AI 回复不准确、答非所问，或生成的代码有明显错误。
解决： ① 检查选的模型是否适合编程——推荐 Claude Sonnet 或 DeepSeek-V3，不要用通用对话模型；② .clinerules 文件是否写了清晰的技术栈说明——Cline 的代码质量高度依赖项目规则；③ 描述任务时尽量具体——附上文件路径、错误信息、预期行为，不要只说'帮我改一下'；④ 在 Plan 模式下先让 Cline 解释计划，确认方向后再切换到 Act 模式执行。
切换 Provider 后对话上下文丢失
切换 Provider 后对话上下文丢失
换了一个 API Provider，之前的对话记录没了。
解决： 这是预期行为。不同 Provider 之间上下文不共享——Cline 的对话历史绑定在当前的 Provider + Model 组合上。切换前如果需要保留上下文，用右上角导出按钮保存对话为 Markdown。
Base URL 填写后不生效
Base URL 填写后不生效
OpenAI Compatible 模式下填了自定义 Base URL，但请求还是打到默认地址。
解决： ① 确认 Base URL 以 https:// 开头；② 不要在末尾加 /v1/chat/completions 等路径——Cline 自动拼接 API 路径，你只要填到域名+端口级别即可（如 https://api.deepseek.com）；③ 改完 Base URL 后点击面板右上角刷新按钮重连。
Ollama 本地模型连接不上
Ollama 本地模型连接不上
选择 Ollama Provider 后一直显示连接失败。
解决： ① 确认 Ollama 服务已启动——终端运行 ollama serve；② 确认模型已拉取——ollama list 查看已安装模型；③ Cline 的 Base URL 填 http://localhost:11434（注意是 http 不是 https）；④ Windows 用户：如果 Ollama 装在 WSL 中，Base URL 要填 WSL 的 IP 地址而非 localhost。
