Cline 接入
通过 OpenAI 兼容 provider 配置，可以把 UniGateway 接入 Cline。
需要配置的内容
Cline 的 OpenAI 兼容文档明确列出了三个核心配置项：
- Base URL：
https://api.unigateway.ai/v1 - API key：你的 UniGateway key
- Model ID：
GET /v1/models返回的精确值
推荐配置顺序
- 打开 Cline 的 provider 设置。
- 选择 OpenAI 兼容 provider 路径。
- 填入 UniGateway 的 base URL 和 API key。
- 先用
GET /v1/models里的一个稳定模型 ID。 - 先验证一个普通编码任务，再逐步扩到团队使用。
运行建议
| 项目 | 建议 |
|---|---|
| Base URL | 不要指向官方 OpenAI 端点，要用 UniGateway 的 /v1 路径 |
| 模型 ID | 模型目录变化后重新核对，不要长期依赖保存下来的名称 |
| Tool-heavy 任务 | tool use 和结构化输出要和普通聊天分开验证 |
| 团队上线 | 先保留一个 canary 配置，再复制给更多用户 |
常见失败场景
| 问题 | 处理方式 |
|---|---|
| Provider 能保存，但没有模型能用 | 用直连 /v1/models 核对 base URL、API key 和精确模型 ID |
| 某类编码任务成功，另一类不稳定 | 把 tool use 和长上下文当成独立验证项 |
| 切换到新模型后行为变了 | 按模型重新验证提示词和输出假设 |
| Agent loop 下延迟明显升高 | 为交互式编码流量准备更快的备用模型 |