Cline 接入自定义 API（OpenAI Compatible）配置教程

这篇教程说明如何在 VSCode 的 Cline 扩展里接入 HRouter。Cline 提供 OpenAI Compatible 类型的服务商，只需要填 Base URL、API Key 和模型 ID。界面文字可能随 Cline 版本变化，以你安装的版本为准。

开始前

一个可用的 HRouter Key，并已确认它的分组包含你要用的模型，见如何选择 Key 分组。
已在 VSCode 里安装 Cline 扩展。
当前 Key 的模型 ID：用 GET https://hrouter.net/v1/models 查询，见查询可用模型。

连接参数

字段	值
API Provider	`OpenAI Compatible`
Base URL	`https://hrouter.net/v1`
API Key	你的 HRouter Key
Model ID	当前 Key 返回的模型 ID

配置步骤

在 VSCode 侧边栏打开 Cline，点击设置。
把 API Provider 选为 OpenAI Compatible。
填入 Base URL https://hrouter.net/v1。
粘贴 HRouter Key。
在 Model ID 里填写从 /v1/models 复制的准确 ID，注意大小写和后缀。
保存后在对话框里发送一句最短的测试消息：

请只回复：连接成功

到使用记录确认请求出现。

使用 Claude 模型

如果要用 Claude 模型，可以把 API Provider 选为 Anthropic，并勾选使用自定义 Base URL，填入 https://hrouter.net（不带 /v1）。如果你的版本没有这个选项，也可以继续使用 OpenAI Compatible，前提是当前 Key 的分组允许通过 Chat Completions 接口调用这个模型。两种地址的差别见 API 地址对照表。

常见问题

提示找不到模型？ Model ID 必须和 /v1/models 返回的完全一致，见 model_not_found。

返回 404？ OpenAI Compatible 的 Base URL 需要带 /v1，不要再加 /chat/completions，见 404 路径错误。

返回 401？ 见 API 401 报错。

长任务中途中断？ 见 503、超时与流式中断。