> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hostlinku.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Cline & Roo 代码

> 在 Cline 和 Roo Code 中配置兼容 OpenAI 的提供商（或具有自定义基础 URL 的 Anthropic），以使用 Hostlinku 模型

[Cline](https://cline.bot) - 及其分支 **Roo Code** - 提供了一个 **OpenAI Compatible** 提供商，该提供商支持自定义基础 URL、API 密钥和模型 ID。 这是实现 Hostlinku 的最简单途径；关于通过 **Anthropic** 提供商实现的替代方案，将在下文讨论。正在使用 **Kilo Code**？请参阅 [Kilo Code](https://docs.hostlinku.com/zh/integrations/kilo-code.md) 中的专门指南。

### 打开运营商设置

在 Cline 面板中，点击齿轮图标（**设置**）→ **API 配置**。

首次打开 Cline 时，会显示 *“您将如何使用 Cline？”* 界面-请选择 **“使用我自己的 API 密钥”**，然后点击 **“继续”**。

![Cline 起始界面：已选中“使用我自己的 API 密钥”选项](https://mintcdn.com/hostlinku/wMpi8klIZneDqj3k/images/integrations/cline-setup.webp?fit=max\&auto=format\&n=wMpi8klIZneDqj3k\&q=85\&s=2aefc2fdbd11d1c601ff8dfd45365b43)

### 选择“OpenAI 兼容款”，并填写

| Field | 值 |
| - | - |
| **API 提供商** | `OpenAI Compatible` |
| **基础 URL** | `https://api.hostlinku.com/v1` |
| **API密钥** | `sk-…`（API密钥 Hostlinku） |
| **模型 ID** | [目录](https://docs.hostlinku.com/zh/models.md)中的slug，例如 `claude-sonnet-4-6` |

![Cline：API 提供商 OpenAI 与基础 URL https://api.hostlinku.com/v1 兼容](https://mintcdn.com/hostlinku/wMpi8klIZneDqj3k/images/integrations/cline-openai.webp?fit=max\&auto=format\&n=wMpi8klIZneDqj3k\&q=85\&s=2f8890c547b571b9a878fd507635d81a)

### （建议）填写配置表单

打开**模型配置**部分，以便 Cline 能正确管理上下文和价格：

* **支持图像**：请勾选此选项以启用视觉模型（`claude-sonnet-4-6`、`gpt-5-5`）。
* **上下文窗口大小**：目录中的 `context_window`（例如 `1000000`）。
* **最大输出Token数**：`64000` 是大型模型的安全值。
* **进出库价格**：如需准确估算Cline的成本，请从`pricing`目录中复制数据；实际账单仍以控制台记录为准。

  ![完整的API配置面板：基础 URL Hostlinku、API密钥、模型ID、模型配置](https://mintcdn.com/hostlinku/wMpi8klIZneDqj3k/images/integrations/cline-byok-openai.webp?fit=max\&auto=format\&n=wMpi8klIZneDqj3k\&q=85\&s=9b6e74504d9816cb77ca26c9c98b7467)

### 验证

点击\*\*“完成”\*\*，提交一项小任务（*“简要说明此仓库的README”*）。请求会显示在控制台 → **请求日志** 中。

## “计划-执行”模式与不同模型

Cline 可以为 **Plan** 和 **Act** 模式使用不同的模型。 常见的经济型组合：**Plan** = `claude-opus-4-6` 或 `gpt-5-5`（推理），**Act** = `claude-sonnet-4-6` 或 `deepseek-v4-flash`（执行）。 在设置中启用 *“为 Plan 和 Act 模式使用不同的模型”*，然后为同一提供商配置文件填写不同的模型 ID。

## 备选方案：提供商 Anthropic

Cline 还提供了一个名为 **Anthropic** 的提供商，其选项中包含 *使用自定义基础 URL*。请填写 `https://api.hostlinku.com`（不包含 `/v1`）以及 API 密钥 Hostlinku。 区别在于：该提供商中的模型列表**仅限于 Cline 识别的 ID**-请选择其 slug 与 Hostlinku 目录中完全一致的 Claude 模型（例如 `claude-sonnet-4-6`、`claude-haiku-4-5`）。 对于非Claude模型或列表中不存在的slug，请使用**OpenAI Compatible**。

![Cline：提供商 Anthropic，其“使用自定义基础 URL”字段包含 https://api.hostlinku.com](https://mintcdn.com/hostlinku/wMpi8klIZneDqj3k/images/integrations/cline-anthropic.webp?fit=max\&auto=format\&n=wMpi8klIZneDqj3k\&q=85\&s=aef9e9b6ff4d7f2c37eee35c591c6bc1)

提示缓存

通过Anthropic通道，Cline发送了`cache_control`，Hostlinku将其转发-缓存Token在`cache_read_input_tokens`中被报告，并按模型缓存价格计费。 通过 OpenAI Compatible 路径，缓存将由支持该功能的模型自动处理。

## Cline CLI

```bash theme={null}
cline auth -p openai -k "$HOSTLINKU_API_KEY" -b https://api.hostlinku.com/v1
cline --model claude-sonnet-4-6 "tambahkan validasi input di handler login"
```

## 故障排除

* **`401`** - 密钥错误/已被撤销。请在 Roo Code 中确认密钥已填写在当前活动的提供商**配置文件**中，而非其他配置文件。
* **`404 model_not_found`** - 模型ID输入有误；请复制自`GET /v1/models`。
* **所有请求中的 `404`** - 基础 URL 缺少 `/v1`（OpenAI 路径），或者在 Anthropic 路径中反而使用了 `/v1`。请与上方的截图进行对比。
* **Act模式下的空响应** - 不包含*工具调用*的模型。请使用[概述](https://docs.hostlinku.com/zh/integrations.md)中推荐的模型。
* **上下文缓冲区即将用尽** - 请根据目录设置 *Context Window Size*，以便 Cline 能正确截断历史记录。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.