# Свой API-ключ в Cline

> Настройте свой API-ключ в Cline через OpenAI-совместимого провайдера, правильные Base URL и Model ID, затем разберите ошибки 401, 404 и Model Not Found.

- Canonical HTML: https://omniakey.com/ru/blog/cline-custom-api-key
- Markdown: https://omniakey.com/ru/blog/cline-custom-api-key.md
- Published: 2026-08-11 (updated 2026-09-21)
- Author: Kiki, COO at OmniaKey
- Language: ru
- Category: API setup
- Reading time: 9 min
- All posts: https://omniakey.com/blog/llms.txt

---

Cline — это клиент для программирования. API-провайдер предоставляет модель, проверяет запрос и списывает стоимость токенов. Свой ключ соединяет эти уровни, но не делает платный API бесплатным и не обходит правила доступа провайдера.

В официальной настройке OpenAI Compatible у Cline есть ровно нужные поля: API Provider, Base URL, API Key и Model ID. Через OmniaKey один ключ может обращаться к поддерживаемым моделям Claude, GPT, Gemini, DeepSeek и другим.

> **Проверено 11 августа 2026 года.** Официальная документация Cline подтверждает тип OpenAI Compatible, поля Base URL, API Key и Model ID, а также проверку Verify. Доступность моделей и цены меняются — копируйте актуальные ID из каталога OmniaKey.

## Настройки своего API-ключа в Cline

Откройте Cline в VS Code, нажмите значок настроек и заполните:

|Поле|Значение|
|-|-|
|API Provider|`OpenAI Compatible`|
|Base URL|`https://api.omniakey.com/v1`|
|API Key|Ключ, созданный в dashboard OmniaKey|
|Model ID|Точный поддерживаемый ID, например `gpt-5.6-terra`|

Суффикс `/v1` входит в OpenAI-совместимый Base URL. Не оставляйте только домен и не дописывайте `/chat/completions`: путь запроса формирует Cline.

## Пошаговая настройка

### 1. Создайте отдельный ключ

Войдите в OmniaKey, пополните предоплаченный баланс и создайте API Key. Отдельный ключ для Cline упрощает лимиты, ротацию и аудит по сравнению с одной общей учётной записью для всех инструментов.

Не помещайте ключ в исходный код, файлы репозитория, issue или снимки экрана. Вставляйте его только в поле API Key в Cline.

### 2. Выберите OpenAI Compatible

В API Provider выберите `OpenAI Compatible`. Не выбирайте официальный OpenAI, если ключ выпущен другим провайдером: от типа провайдера зависят поля и адрес запроса Cline.

### 3. Укажите Base URL

Введите без изменений:

```text
https://api.omniakey.com/v1
```

Частые ошибки: голый `https://api.omniakey.com`, двойной `/v1/v1` и полный путь `/v1/chat/completions`.

### 4. Скопируйте точный Model ID

Начните с модели, которая сейчас есть в [каталоге OmniaKey](https://omniakey.com/ru/models):

|Model ID|Для чего взять сначала|
|-|-|
|`claude-opus-5`|Сложная работа с репозиторием, где важна глубокая проверка|
|`gpt-5.6-terra`|Повседневное программирование с балансом качества и цены|
|`gemini-3.1-pro-preview`|Эксперименты с длинным контекстом Gemini|
|`deepseek-v4-flash`|Быстрые и более дешёвые coding- и agent-задачи|

Это точные идентификаторы, а не приблизительные названия. Важны регистр, дефисы и суффиксы версии — копируйте ID из каталога.

### 5. Проверьте до изменения файлов

Если в интерфейсе есть Verify, сначала нажмите его. Затем дайте узкую обратимую задачу:

```text
Прочитай package.json и назови менеджер пакетов. Не изменяй файлы.
```

Проверка должна подтвердить:

1. Cline принял настройки провайдера.
2. Провайдер принял API Key.
3. Точный Model ID доступен ключу.
4. Простой ответ вернулся без редактирования и цикла инструментов.

После этого переходите к изменениям репозитория. Общая схема описана в [руководстве по coding agents](https://docs.omniakey.com/ru/coding).

## Как оплачивается Cline BYOK

BYOK означает Bring Your Own Key. Cline отправляет запросы с вашими настройками, а выбранный провайдер списывает использование модели. Свой ключ не превращает платный API в бесплатный.

Смотрите на входные, кэшированные входные и выходные токены, а не только на длину ответа. Агент также передаёт контекст репозитория, вызывает инструменты и повторяет шаги. [Руководство по прозрачному биллингу](https://omniakey.com/ru/blog/transparent-billing) объясняет, почему полезнее стоимость принятой задачи.

Если модель ещё не выбрана, сначала откройте [сравнение моделей для coding agents](https://omniakey.com/ru/blog/best-llm-coding-agents). Если вы подключаете десктопный клиент, а не расширение IDE, смотрите [настройку API Cherry Studio](https://omniakey.com/ru/blog/cherry-studio-api-setup) и [настройку своей модели в WorkBuddy](https://omniakey.com/ru/blog/workbuddy-custom-model-setup). Для Claude Code смотрите [руководство по настройке Claude Code](https://omniakey.com/ru/blog/claude-code-setup).

## Если API-ключ Cline не работает

### Invalid API Key или HTTP 401

`401` означает, что endpoint не принял переданные данные. Проверьте:

- ключ и Base URL относятся к одному провайдеру;
- нет пробелов до или после ключа;
- ключ активен, не удалён и не заменён;
- на аккаунте есть доступный баланс;
- в Cline всё ещё выбран `OpenAI Compatible`.

Смена Model ID не исправляет аутентификацию.

### Model Not Found или HTTP 404

`404` может означать неверный Base URL или недоступный Model ID. Сначала убедитесь, что URL заканчивается одним `/v1`, затем скопируйте ID из каталога.

Если тот же endpoint работает с другой моделью, соединение исправно, а проблема осталась в названии или доступе к модели.

### Ошибка соединения

Проверьте доступность `https://api.omniakey.com/v1` именно с машины, где запущен Cline. VPN, proxy, DNS, TLS inspection и firewall могут влиять на IDE отдельно от браузера.

Не отключайте проверку TLS ради скрытия ошибки сертификата. Исправьте сеть или доверие к сертификатам.

### Текст работает, а инструменты — нет

Один текстовый ответ доказывает только базовую генерацию. Для чтения, редактирования и команд Cline нужны структурированные tool calls. Проверьте сначала read-only задачу.

Если модель систематически формирует неверные вызовы, сравните модель, рассчитанную на agent work, вместо бесконтрольного увеличения лимита ответа.

### Расход выше ожидаемого

Большой контекст репозитория может доминировать в счёте при коротком финальном ответе. Сужайте задачу, исключайте лишние каталоги и сравнивайте стоимость принятого изменения.

Для экспериментов используйте отдельные ключи и caps. Cap ограничивает риск, но не уменьшает токены неэффективной задачи.

## Проверка безопасности

- Выделите Cline отдельный ключ, не используемый production-сервисами.
- Поставьте cap по масштабу проекта.
- Сразу замените ключ, попавший в репозиторий, запись терминала, скриншот или issue.
- Проверьте разрешения на команды и редактирование.
- В новом или недоверенном репозитории начните с read-only задачи.
- После первого сеанса проверьте журнал использования провайдера.

API Key управляет доступом к модели. Разрешения Cline управляют действиями агента на компьютере. Это разные границы безопасности. Если приложение собрано в Lovable, смотрите [где хранить Lovable API Key](https://omniakey.com/ru/blog/lovable-api-key).

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

### Можно ли использовать свой API-ключ в Cline?

Да. Выберите `OpenAI Compatible`, затем укажите Base URL, API Key и точный Model ID провайдера с совместимым интерфейсом.

### Свой API-ключ в Cline бесплатный?

Нет. BYOK меняет сторону, которая аутентифицирует и выставляет счёт. Провайдер по-прежнему может списывать входные, кэшированные и выходные токены.

### Какой Base URL нужен для OmniaKey?

`https://api.omniakey.com/v1`. Не добавляйте `/chat/completions` и не дублируйте `/v1`.

### Какую модель выбрать для Cline?

Начните с актуальной модели из каталога. `gpt-5.6-terra` — сбалансированная отправная точка; дальше сравнивайте результат принятой задачи.

### Почему Cline пишет Model Not Found?

Проверьте точный Model ID и Base URL. Валидный ключ не гарантирует доступ к каждой модели, а неправильный URL тоже даёт `404`.

### Хранит ли Cline ключ в репозитории?

Учётные данные провайдера должны находиться в настройках Cline, а не в проекте. Не копируйте ключ в код, prompt, снимки экрана или issue.

## Проверенные источники

- [Cline: OpenAI Compatible](https://docs.cline.bot/provider-config/openai-compatible)
- [Cline: Authorization и BYOK](https://docs.cline.bot/getting-started/authorizing-with-cline)
- [Настройка Cline с OmniaKey](https://docs.omniakey.com/ru/guides/cline)
- [Каталог моделей OmniaKey](https://omniakey.com/ru/models)
