Cline 应选择 OpenAI Compatible provider，并使用 XiuRouter 的 API Base URL、专用 API Key 和精确模型 ID。
前置条件
- VS Code 已安装当前稳定版 Cline。
- 已创建一把 Cline 专用 XiuRouter API Key。
- 已从 XiuRouter 当前目录复制模型 ID。
配置
- 打开 Cline 设置。
- API Provider 选择
OpenAI Compatible。 - Base URL 填
https://router-api.xiu.ai/v1。 - API Key 填 XiuRouter API Key。
- Model ID 填当前目录中的精确模型 ID。
- 保存设置。
先不要手动填写上下文、输出上限、图片或工具能力。只有在对应模型上验证后再补这些高级参数。
验证
- 新建一个 Cline 任务。
- 先要求它只读取一个不含敏感信息的文件并总结，不允许修改。
- 确认 XiuRouter“使用记录”出现正确模型、状态和费用。
- 再让它修改一个可撤销的测试文件，确认工具调用和结果回传正常。
只有设置页显示“已验证”不能证明 Agent 工具链可用。至少完成一次读取和一次可撤销编辑。
常见失败
| 现象 | 处理 |
|---|---|
| 验证 Key 失败 | 检查 Base URL 是否含 /v1，Key 是否有效且允许该模型 |
| 普通对话成功但不能改文件 | 换用已验证工具调用的模型，并检查 Cline 高级能力设置 |
| 长任务中断 | 确认 Base URL 使用 router-api.xiu.ai |
| 费用或模型不符合预期 | 停止任务，在 XiuRouter 使用记录中核对请求 ID、模型和分组 |
回滚
在 Cline 设置中切回原 provider、Base URL 和模型。确认新任务恢复原路由后，再撤销 XiuRouter 测试 Key。
来源与核对日期
本文按 Cline 官方 OpenAI Compatible 配置和 XiuRouter 当前 Chat Completions 入口核对，日期为 2026-08-19。本轮未运行真实 Cline 计费任务。