首次配置直接选择 OpenAI Compatible，并填写 XiuRouter 地址、Key 和精确 Model ID。已经在使用 Cline 时，先记下原 provider、Base URL 和模型。
选择配置方式
- 首次配置：直接填写 XiuRouter 连接信息。
- 替换已有：先记录原设置，再切换到 XiuRouter。
- 对话协助：不提供。Cline 的凭据和 provider 由扩展设置界面保存。
前置条件
- VS Code 已安装当前稳定版 Cline。
- 已创建一把 Cline 专用 XiuRouter API Key。
- 已从 XiuRouter 当前目录复制模型 ID。
在 Cline 中配置
- 打开 Cline 设置。
- 记下当前 API Provider、Base URL 和 Model ID，作为回滚点。
- API Provider 选择
OpenAI Compatible。 - Base URL 填
https://router-api.xiu.ai/v1。 - API Key 填 XiuRouter API Key。
- Model ID 填当前目录中的精确模型 ID。
- 保存设置。
首次配置可跳过第 2 步。先不要手动填写上下文、输出上限、图片或工具能力。只有在对应模型上验证后再补这些高级参数。
验证
- 新建一个 Cline 任务。
- 先要求它只读取一个不含敏感信息的文件并总结，不允许修改。
- 确认 XiuRouter 控制台“检查实际请求”出现正确 Key、模型、接口和成功状态。
- 再让它修改一个可撤销的测试文件，确认工具调用和结果回传正常。
只有设置页显示“已验证”不能证明 Agent 工具链可用。至少完成一次读取和一次可撤销编辑。
常见失败
| 现象 | 处理 |
|---|---|
| 验证 Key 失败 | 检查 Base URL 是否含 /v1，Key 是否有效且允许该模型 |
| 普通对话成功但不能改文件 | 换用已验证工具调用的模型，并检查 Cline 高级能力设置 |
| 长任务中断 | 确认 Base URL 使用 router-api.xiu.ai |
| 模型或路由不符合预期 | 停止任务，在“检查实际请求”中核对 Key、模型、接口和时间 |
回滚
在 Cline 设置中切回原 provider、Base URL 和模型。确认新任务恢复原路由后，再撤销 XiuRouter 测试 Key。
来源与核对日期
内容核对于 2026-08-31。Cline 收到完整回复，并在 XiuRouter“检查实际请求”中出现对应模型、接口和成功状态后，基础接入才算完成。