> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.beatapi.io/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.beatapi.io/_mcp/server.

# 在 Cline 中使用 BeatAPI

> 通过 Cline 的 OpenAI Compatible 选项，让这个 VS Code 插件跑在 BeatAPI 上。

# 在 Cline 中使用 BeatAPI

Cline 是一个 VS Code 插件，能在编辑器内写代码、执行命令、跨文件修改项目。它通过 **OpenAI Compatible** 选项接入 BeatAPI —— 填三个字段，不需要额外插件。

## 准备工作

1. **已安装 Visual Studio Code。**
2. **已安装 Cline 插件** —— 在扩展市场（`Ctrl+Shift+X` / `Cmd+Shift+X`）搜索 "Cline"。
3. **一把 BeatAPI 密钥** —— 在[控制台 → API 密钥](https://beatapi.io/dashboard/apikeys)创建。

## 第一步：打开接口配置

全新安装时，Cline 会显示欢迎面板，点 **Use your own API key**。

如果之前配置过，点 Cline 侧边栏顶部的齿轮图标。

## 第二步：配置 BeatAPI

展开 **API Configuration**，填写：

| 配置项          | 值                           |
| ------------ | --------------------------- |
| API Provider | `OpenAI Compatible`         |
| Base URL     | `https://api.beatapi.io/v1` |
| API Key      | 你的 BeatAPI 密钥               |
| Model ID     | 模型编号，例如 `claude-fable-5-1`  |

点 **Done**。配置自动保存并立即生效，不用重载窗口。

> **Note**
>
> 要选 **OpenAI Compatible**，不是 **OpenAI**。部分 Cline 版本在纯 OpenAI 选项下**不显示** Base URL 输入框，导致自定义地址根本填不进去。OpenAI Compatible 选项则一直有这个字段。

> **Note**
>
> Model ID 是手工输入的，所以拼错不会有校验提示，而是等到调用时返回 `not_found`。请从[价目页](https://beatapi.io/pricing)或 `GET /v1/models` 复制。编号区分大小写，且不带厂商前缀 —— 是 `claude-fable-5-1`，不是 `anthropic/claude-fable-5-1`。

Cline 有一个 **Verify** 按钮，正式开始任务前先点一下确认连通。

## 第三步：开始使用

在 Cline 面板底部的输入框描述任务：

```
写一个校验邮箱格式的 JavaScript 函数，并配上单元测试
```

Cline 会规划步骤、写文件，执行任何终端命令前都会先询问。在编辑器里选中代码后右键，还有 **Explain with Cline** 与 **Improve with Cline** 两项。

切换模型：点输入框下方的模型按钮，或在设置里改 Model ID，改完立即生效。

## 模型

| 模型编号                        | 适用场景               |
| --------------------------- | ------------------ |
| `claude-fable-5-1`          | 最新一代 —— 智能体编程的默认选择 |
| `claude-opus-5`             | 复杂架构与疑难排查          |
| `claude-sonnet-5`           | 日常开发，成本更低          |
| `gpt-5.6-sol`               | OpenAI 系最强编程档      |
| `claude-haiku-4-5-20251001` | 快速便宜，适合小改动         |

账户下所有文本模型都可用 —— 完整目录见[文本 API](/text-api)。

## 常见问题

### 提示密钥无效

1. 确认密钥是完整复制的，前后没有多余空白。
2. 确认 Base URL 恰好是 `https://api.beatapi.io/v1`，带 `/v1`，结尾不加斜杠。
3. 在[控制台 → API 密钥](https://beatapi.io/dashboard/apikeys)确认密钥仍然可用。

### 提示 Model Not Found

该 Model ID 在这个账户下不存在。对照[价目页](https://beatapi.io/pricing)检查拼写与大小写。

### 响应很慢

换成更快的档位 —— `claude-haiku-4-5-20251001` 或 `claude-sonnet-5` —— 并把任务范围收窄。Cline 会把当前打开的文件和你的选区一起作为上下文发出去，选得越少既更快也更便宜。

### 402 insufficient_credits

余额不足：余额为零或低于本次请求的价格，在控制台充值。

### 429 rate_limit_exceeded

该密钥超出请求频率上限。Cline 会自动重试；若持续失败就放慢节奏或提升额度。每分钟额度随累计充值提升，当前值在控制台可见。

### 怎么控制花费

* 只选中需要处理的代码，而不是整个文件。
* 日常小改用便宜模型，难题再切到强模型。
* 在 [`GET /v1/usage`](/quick-guide) 的 `by_api_key` 或控制台里按密钥查看消耗。

## 获取支持

在[控制台](https://beatapi.io/dashboard)提交工单，并附上失败响应里的 `request_id`。