Cline 接入 UniRoute
在 VS Code 的 Cline 中配置 OpenAI Compatible、Base URL、API Key 与模型，检查调用并排查常见错误。
Cline 接入 · 按量 API
在 Cline 的 OpenAI Compatible 供应商中填入 UniRoute 地址、API Key 和模型，用同一套配置完成对话与编程任务。
适合：在 VS Code 中规划、编写与修改代码的开发者。
快速配置
登录后可一键创建 Key 并自动填入 登录
打开 Cline → 设置（齿轮）→ API Configuration，逐项复制以下内容。
API Provider
OpenAI CompatibleBase URL
https://api.uniroute.app/v1OpenAI Compatible API Key
YOUR_UNIROUTE_API_KEYModel ID
deepseek-v4-flash配置步骤
1. 打开本地供应商设置
在 Cline 侧栏点击齿轮，打开 API Configuration。出现 Local / Cloud 选择器时，选择 Local。
此配置用于 Local；Cloud 任务有独立的模型设置。
2. 填写接口与 Key
将 API Provider 设为 OpenAI Compatible，按上方字段填写 Base URL 与 OpenAI Compatible API Key。将 Custom Headers 留空，不启用 Use Azure Identity Authentication 和 Set Azure API version。
3. 选择模型
在 Model ID 选择 deepseek-v4-flash；手动填写时，选择 Use custom model ID…，再在 Custom Model ID 填入同一个 ID。Base URL 保留 /v1，Cline 会追加 /chat/completions。
4. 保存 Plan 与 Act 设置
共用一套配置时，关闭 Use different models for Plan and Act modes；分开使用时，为 Plan 与 Act 各设置一次供应商和模型，然后保存设置。
首次配置文本任务时，Model Configuration 中的上下文、输出长度、图片与采样设置保持默认。
这几个变量分别做什么
| 字段 | 用途 |
|---|---|
| API Provider | 选择 Chat Completions 请求格式。 |
| Base URL | API 前缀；Cline 在其后追加 /chat/completions 或 /models。 |
| OpenAI Compatible API Key | 用于 UniRoute 请求认证。 |
| Model ID / Custom Model ID | 实际发送给 API 的完整模型 ID。 |
| Model Configuration | 控制模型能力信息和可选请求参数；首次文本配置保持默认。 |
选择模型
怎么确认已经切过来了
发送一句测试：只回复 OK。
打开 用量日志，查看模型、请求状态与扣费。测试会产生实际 API 费用。
收到回复后，让 Cline 读取工作区中的一个小文件并说出文件名，按提示批准读取操作，在用量日志中核对后续请求。
切回原配置 / 恢复备份
回到 API Configuration，选择原供应商与模型并保存。若为 Plan 与 Act 分别配置，恢复两个模式。
还没安装？
在 VS Code 的扩展面板安装 Cline，再打开 Cline 侧栏。参见 Cline 官方安装说明。
常见问题
需要开通 ClinePass 吗？
选择 OpenAI Compatible 并使用 UniRoute Key；调用由 UniRoute 按用量计费。
模型列表为空怎么办？
选择 Use custom model ID…，在 Custom Model ID 填入完整 ID，再检查 Base URL 和 Key。
Base URL 要包含 /chat/completions 吗？
填写 https://api.uniroute.app/v1 即可，Cline 会追加接口路径。
常见错误
401 / Invalid API Key
Key 不完整、已撤销或未保存。
重新粘贴有效的完整 Key 并保存设置。
404
Base URL 包含重复接口路径。
使用 https://api.uniroute.app/v1，不追加 /chat/completions。
Model Not Found
模型 ID 或 Key 权限需要调整。
填写完整模型 ID，并检查控制台中的 Key 权限与余额。
Plan 正常，Act 使用其他模型
Plan 与 Act 保存了不同的配置。
为两个模式分别配置，或关闭 Use different models for Plan and Act modes。
相关链接
管理 API Key
· 协议与地址 ·
模型价格
· 用量记录 · Cline 官方配置