> 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.

# Подключение BeatAPI к Cline

> Настройте расширение Cline для VS Code на работу с BeatAPI через поставщика OpenAI Compatible.

# Подключение BeatAPI к Cline

Cline — расширение VS Code, которое пишет код, запускает команды и редактирует файлы проекта прямо в редакторе. Для подключения к BeatAPI выберите **OpenAI Compatible**: достаточно заполнить три поля, отдельный плагин не нужен.

## Что понадобится

1. **Установленный Visual Studio Code.**
2. **Установленное расширение Cline**: найдите «Cline» в магазине расширений (`Ctrl+Shift+X` / `Cmd+Shift+X`).
3. **API-ключ BeatAPI**: создайте его в [Dashboard → API Keys](https://beatapi.io/dashboard/apikeys).

## Шаг 1. Откройте настройки API

После установки Cline показывает экран приветствия. Нажмите **Use your own API key**.

Если Cline уже настроен, нажмите значок шестерёнки вверху его боковой панели.

## Шаг 2. Настройте BeatAPI

Разверните **API Configuration** и заполните поля:

| Настройка    | Значение                               |
| ------------ | -------------------------------------- |
| API Provider | `OpenAI Compatible`                    |
| Base URL     | `https://api.beatapi.io/v1`            |
| API Key      | Ваш API-ключ BeatAPI                   |
| Model ID     | ID модели, например `claude-fable-5-1` |

Нажмите **Done**. Настройки сохраняются автоматически и применяются сразу; перезагрузка не нужна.

> **Note**
>
> Выберите **OpenAI Compatible**, а не **OpenAI**. В некоторых версиях Cline обычный поставщик OpenAI скрывает поле Base URL, и свой адрес указать нельзя. У OpenAI Compatible это поле всегда доступно.

> **Note**
>
> Model ID вводится вручную, поэтому опечатка приведёт к `not_found`, а не к предупреждению в форме. Скопируйте ID со [страницы цен](https://beatapi.io/pricing) или из `GET /v1/models`. Регистр важен, префикс поставщика не нужен: `claude-fable-5-1`, а не `anthropic/claude-fable-5-1`.

Перед запуском задачи проверьте подключение кнопкой **Verify** в Cline.

## Шаг 3. Начните работу

Введите задачу в поле внизу панели Cline:

```
Create a JavaScript function that validates an email address, with unit tests
```

Cline составит план, запишет файлы и запросит разрешение перед запуском каждой команды терминала. Выделите код в редакторе и нажмите правую кнопку мыши, чтобы открыть **Explain with Cline** или **Improve with Cline**.

Переключить модель можно кнопкой под полем ввода или изменением Model ID в настройках. Изменения применяются сразу.

## Модели

| ID модели                   | Для каких задач подходит                                    |
| --------------------------- | ----------------------------------------------------------- |
| `claude-fable-5-1`          | Новое поколение; основной вариант для разработки с агентом  |
| `claude-opus-5`             | Сложная архитектура и поиск трудных ошибок                  |
| `claude-sonnet-5`           | Повседневная разработка с меньшими расходами                |
| `gpt-5.6-sol`               | Самый сильный вариант семейства OpenAI для программирования |
| `claude-haiku-4-5-20251001` | Быстрые недорогие шаги и небольшие правки                   |

Доступны все текстовые модели аккаунта. Полный каталог приведён в разделе [Text API](/text-api).

## Частые вопросы

### Клиент сообщает, что ключ недействителен

1. Убедитесь, что ключ скопирован полностью и без лишних пробелов.
2. Base URL должен быть точно `https://api.beatapi.io/v1`: с `/v1`, без завершающего слеша.
3. Убедитесь, что ключ активен, в [Dashboard → API Keys](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 повторяет запросы; если ошибка не исчезает, снизьте частоту или увеличьте лимит. Минутный лимит растёт с общей суммой пополнений и отображается в панели управления.

### Как контролировать расходы

* Выделяйте только нужный код, а не весь файл.
* Для обычных правок выбирайте недорогую модель, для сложных задач переключайтесь на более сильную.
* Проверяйте расходы по ключам в поле `by_api_key` ответа [`GET /v1/usage`](/quick-guide) или в панели управления.

## Поддержка

Создайте обращение в [панели управления](https://beatapi.io/dashboard) и укажите `request_id` из ответа с ошибкой.