---
title: "将 Cline 接入 XiuRouter"
description: "在 VS Code 的 Cline 中选择 OpenAI Compatible 并配置 XiuRouter 地址、Key 和模型。"
image: "https://docs.xiu.ai/og.png"
---

> XiuAI 文档索引
> 完整文档索引：https://docs.xiu.ai/llms.txt
> 阅读前先通过索引确认当前可用页面。

# 将 Cline 接入 XiuRouter

Cline 应选择 `OpenAI Compatible` provider，并使用 XiuRouter 的 API Base URL、专用 API Key 和精确模型 ID。

## 前置条件

- VS Code 已安装当前稳定版 Cline。
- 已创建一把 Cline 专用 XiuRouter API Key。
- 已从 XiuRouter 当前目录复制模型 ID。

## 配置

1. 打开 Cline 设置。
2. API Provider 选择 `OpenAI Compatible`。
3. Base URL 填 `https://router-api.xiu.ai/v1`。
4. API Key 填 XiuRouter API Key。
5. Model ID 填当前目录中的精确模型 ID。
6. 保存设置。

先不要手动填写上下文、输出上限、图片或工具能力。只有在对应模型上验证后再补这些高级参数。

## 验证

1. 新建一个 Cline 任务。
2. 先要求它只读取一个不含敏感信息的文件并总结，不允许修改。
3. 确认 XiuRouter“使用记录”出现正确模型、状态和费用。
4. 再让它修改一个可撤销的测试文件，确认工具调用和结果回传正常。

只有设置页显示“已验证”不能证明 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 计费任务。

源文件：https://docs.xiu.ai/router/integrations/cline/index.mdx