Cline: настройка API через OpenAI Compatible и что значит API request failed

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

Получить ключ Что делать

/ Короткий ответ

Что это значит

Cline — это агент внутри VS Code, который сам читает файлы, пишет код и запускает команды в терминале, спрашивая разрешение на каждый шаг. Своих моделей у него нет: он ходит в тот API, который вы укажете в настройках. Для любого OpenAI-совместимого сервиса выбирается провайдер OpenAI Compatible, и дальше нужны ровно три поля: Base URL, API Key и Model ID.

Base URL — адрес сервера вместе с /v1, без /chat/completions на конце. API Key — ключ от этого сервера, не от OpenAI. Model ID — имя модели точно в том написании, которое понимает ваш API: у разных сервисов одна и та же модель называется по-разному, и это самая частая причина ошибки.

Когда что-то не так, Cline показывает «API request failed» и ниже — тело ответа сервера как есть. В нём и лежит ответ: 401 — ключ, 404 — путь или модель, 402 — баланс, 429 — частота. Читать нужно именно эту часть, а не первую строку.

/ Почему

Откуда берётся ошибка

Base URL без /v1 или с лишним хвостом. Cline сам добавляет /chat/completions, поэтому адрес должен кончаться на /v1. Иначе 404.
Ключ не от того сервиса. Ключ OpenAI с чужим base URL или наоборот. Ответ 401 authentication_error.
Model ID не в том написании. С точкой вместо дефиса, с лишним префиксом, старое имя. Ответ 404 model_not_found или 400.
Контекст больше, чем у модели. Cline отправляет много: системный промпт, файлы, историю. У модели с коротким контекстом это упирается в 400 context_length_exceeded.
Баланс или частота. 402 при пустом счёте, 429 при залпе запросов от агента в длинной задаче.

/ Что делать

Порядок действий

Выберите провайдера OpenAI Compatible

Шестерёнка Cline → API Provider → OpenAI Compatible. Не путайте с провайдером OpenAI: у того base URL зашит и поля адреса нет.

Заполните три поля

Base URL с /v1, ключ от того же сервера, Model ID как в каталоге сервера. Пример для нашего шлюза:

Base URL:  https://api.kosareva.cloud/v1
API Key:   ваш-ключ
Model ID:  claude-sonnet-5

Проверьте те же три значения curl

Если curl отвечает, а Cline нет, проблема в полях Cline: чаще всего пробел в конце ключа или адреса.

curl https://api.kosareva.cloud/v1/chat/completions \
  -H "Authorization: Bearer ваш-ключ" \
  -H "Content-Type: application/json" \
  -d '{"model":"claude-sonnet-5","messages":[{"role":"user","content":"Привет"}]}'

Прочитайте тело ошибки

В «API request failed» разверните текст ниже: там JSON с полями type, code и message. По code ищите страницу в справочнике: invalid_api_key, model_not_found, context_length_exceeded.

Подберите модель под задачу

Для длинных агентских задач берите модель с большим контекстом и не самую дорогую: агент делает десятки запросов за одну задачу, и выходные токены стоят в 5 раз дороже входных.

/ По инструментам

Где это чинится в разных инструментах

Cline в VS Code. Настройки хранятся в самом расширении, ключ — в защищённом хранилище VS Code. При переустановке расширения поля нужно заполнить заново.
Cline в Cursor и других форках VS Code. Те же три поля, тот же провайдер. Работоспособность самого редактора — отдельный вопрос.
Roo Code и другие ответвления Cline. Провайдер называется так же, поля те же, иногда добавлено поле для контекста модели — его стоит выставить руками.
Наше расширение VS Code. Готовит значения для Cline и кладёт их в буфер обмена, вставлять всё равно в поля Cline.

/ FAQ

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

Cline пишет API request failed без текста ниже. Что делать?

Значит, ответа от сервера не было вовсе: неверный адрес, нет сети или прокси не пропускает. Проверьте base URL и curl до того же адреса.

Можно ли в Cline держать несколько моделей?

Да, через профили конфигурации: у каждого свой провайдер, ключ и Model ID. Удобно держать дешёвую модель для рутины и сильную для сложного.

Почему Cline тратит так много токенов?

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

/ На kosareva.cloud

Как это выглядит у нас

В Cline наш шлюз подключается как OpenAI Compatible: Base URL https://api.kosareva.cloud/v1, ключ из кабинета, Model ID из каталога — gpt-5-6, claude-sonnet-5, deepseek-v4-flash. В кабинете можно выпустить отдельный ключ под Cline с лимитом, чтобы агент не выел весь баланс за ночь, и смотреть расход по нему. DeepSeek V4 Flash стоит 47,52 ₽ за миллион входных токенов и 142,56 ₽ за миллион выходных, Claude Sonnet 5 — 216 и 1 080 ₽.

/ Дальше

Рядом в справочнике

Ключ, который работает из России

OpenAI-совместимый адрес, оплата в рублях, ключ сразу после регистрации. Пополнение картой от 50 ₽.

Получить ключ