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

# Cline

> 如何在 VS Code 里把编码智能体 Cline 通过 OpenAI Compatible 模式和自定义 Base URL 接到 RuAPI

[Cline](https://cline.bot) 是个 VS Code 扩展 —— 自主编码智能体:读写文件、跑命令、按任务推进。它通过 **OpenAI Compatible** 提供方接 RuAPI,一个地址打开所有模型。

## 前置

<Steps>
  <Step title="RuAPI 账号和密钥">
    控制台 →\*\*「令牌」\*\*→ 创建 `sk-...` 密钥。余额用 USDT 充 —— 见[充值](/zh/topup)。
  </Step>

  <Step title="VS Code 和 Cline 扩展">
    从 VS Code 应用市场(或 [cline.bot](https://cline.bot))装上 Cline,点开侧边栏图标。
  </Step>
</Steps>

## 配置

<Steps>
  <Step title="打开 Cline 设置">
    在 Cline 面板点 ⚙️ → 提供方选择(**API Provider**)。
  </Step>

  <Step title="选 OpenAI Compatible 并填字段">
    | 字段               | 值                                           |
    | ---------------- | ------------------------------------------- |
    | **API Provider** | `OpenAI Compatible`                         |
    | **Base URL**     | `https://www.ruapi.ai/v1`  —— **带** `/v1`   |
    | **API Key**      | `sk-你的密钥`                                   |
    | **Model ID**     | 来自[价格页](https://www.ruapi.ai/pricing)的精确 ID |
  </Step>

  <Step title="保存">
    点 **Done / Save**。Cline 就绪。
  </Step>
</Steps>

<Tip>
  智能体任务挑强模型 —— Claude Sonnet 或 Claude Opus 系列在 Cline 的长链多步场景里更稳。
</Tip>

## 第一个任务

在 Cline 输入框描述任务,例如:

```
给 config.ts 里的 parseConfig 函数加上错误处理
```

Cline 会给出计划和改动。RuAPI 控制台 →\*\*「日志」\*\*有记录,说明请求走的是 RuAPI。

## 出问题时

<AccordionGroup>
  <Accordion title="401 / Unauthorized">
    * 密钥得是 RuAPI 令牌(`sk-...`)。
    * 确认选的是 **OpenAI Compatible**,Base URL 是带 `/v1` 的 `https://www.ruapi.ai/v1`。
  </Accordion>

  <Accordion title="找不到模型 / 404">
    Model ID 要和 RuAPI 一字不差。精确名称见[价格页](https://www.ruapi.ai/pricing)。
  </Accordion>

  <Accordion title="智能体很快烧掉余额">
    Cline 发送的上下文大、步数多,token 比普通聊天消耗快。在控制台 →\*\*「令牌」\*\*建一个带消费上限的单独密钥。
  </Accordion>
</AccordionGroup>