Cline: настройка OpenAI-совместимого API в VS Code
Коротко: в настройках Cline выберите провайдера OpenAI Compatible, вставьте Base URL, ключ и Model ID — и агент готов. Ниже подробно, с окном контекста и разбором ошибок, на которых обычно застревают.
Что такое Cline
Cline — расширение для VS Code (работает также в Cursor и в JetBrains), которое превращает редактор в агента: он читает проект, предлагает правки по файлам, запускает команды в терминале и показывает каждый шаг до применения. В отличие от встроенных ассистентов, Cline не привязан к одному поставщику моделей — провайдер настраивается вручную.
Шаг 1. Установка расширения
- Откройте VS Code, перейдите в «Расширения» (
Ctrl+Shift+X, на macOSCmd+Shift+X). - Найдите Cline и установите.
- Откройте панель Cline на боковой панели редактора.
Шаг 2. Получите Base URL и ключ
Нажмите кнопку ниже — она создаёт Base URL вида https://twelver.ru/api/ai/<config-id>/v1 и ключ вида sk-…. Регистрация и карта не нужны. Ключ показывается один раз — скопируйте сразу.
Прямо на странице
Получите Base URL и ключ для Cline
В блоке ниже появятся ровно те значения, которые нужно вписать в поля расширения — ваши, а не заглушки. Первый запрос можно отправить здесь же, не открывая VS Code: если ответ пришёл, дальше дело только в настройках Cline.
Нажмите — и получите base_url и API-ключ.
Регистрация и карта не нужны.
Бесплатно. Ключ появится прямо здесь.
Шаг 3. Настройка провайдера в Cline
Откройте настройки Cline (иконка шестерёнки) и заполните поля значениями из блока выше:
| Поле | Что вписать |
|---|---|
| API Provider | OpenAI Compatible |
| Base URL | |
| API Key | |
| Model ID | название серии из таблицы ниже, например auto |
В блоке Model Configuration задайте окно контекста. Cline использует это значение, чтобы решать, когда подрезать историю; если оставить значение по умолчанию, он может оборвать длинную сессию раньше времени либо, наоборот, отправить слишком много.
Проверьте связь простым сообщением вроде «привет» — если ответ пришёл, подключение работает.
Base URL оканчивается на /v1
/chat/completions к тому, что вы указали. Поэтому в поле должен быть адрес, оканчивающийся на /v1 — без завершающего слэша и без /chat/completions в конце. Лишний фрагмент даёт 404.Если поля не сходятся
Попросите ИИ настроить Cline за вас
Откроется чат с уже набранным вопросом — останется нажать «отправить». API-интегратор выдаст ваш base_url и ключ, продиктует значения для каждого поля Cline и посчитает стоимость. Туда же можно вставить текст ошибки, если подключение не проходит.
Какую серию выбрать
В поле Model ID указывается серия — она сама ссылается на актуальную модель, так что настройку не придётся править после обновления.
| Серия | Модель | Вход / выход, ₽ за 1 млн | Когда брать |
|---|---|---|---|
| qwen-flash | Qwen3.8-Flash | 15 / 47 | Самый дешёвый вход, но для правки кода слабовата |
| zai-flash | GLM-5.3-Flash | 15 / 50 | Альтернатива qwen-flash по той же цене |
| gpt | GPT-5.6 Luna | 20 / 120 | Дешёвый вход при заметно более сильной модели, чем flash-серии |
| auto / qwen | Qwen3.7-Plus | 40 / 160 | Повседневная работа — разумная точка входа |
| deepseek-flash | DeepSeek V4 Flash | 44 / 132 | Дешёвые массовые запросы |
| minimax | MiniMax M3 | 60 / 240 | Мелкие правки, длинный контекст |
| xiaomi | MiMo V2.5 Pro | 100 / 300 | Когда «auto» не дотягивает |
| zai | GLM-5.3 | 140 / 440 | Рефакторинг и длинные цепочки правок |
| grok | Grok 4.6 | 200 / 600 | Сложные задачи, разбор архитектуры |
| qwen-max | Qwen3.8-Max | 200 / 600 | Сложные задачи, 1 млн токенов контекста |
| deepseek | DeepSeek V4 Pro | 240 / 480 | Сильные рассуждения; выход дешевле, чем у grok |
| gpt-max | GPT-6 Astra | 1000 / 5000 | Точечно, когда остальное не справилось |
Чего в этом API нет
Если не работает
| Симптом | Причина | Что делать |
|---|---|---|
| 401 / Unauthorized | Неверный или обрезанный ключ | Ключ показывается один раз — если он потерян, выпустите новый |
| 404 при запросе | В Base URL лишний хвост или неверный config-id | Адрес должен оканчиваться на /v1, без /chat/completions и без слэша |
| Model not found | В Model ID указана несуществующая серия | Сверьтесь с таблицей выше; полный список отдаёт GET /v1/models |
| Ответ обрывается на середине | Окно контекста задано неверно | Выставьте его в блоке Model Configuration или начните новую задачу |
| Агент не вызывает инструменты | Модель слабо справляется с tool calling | Попробуйте серию классом выше — например zai или grok |
Как не переплачивать
- Новая задача — новая сессия. Контекст уходит целиком при каждом запросе, поэтому длинная переписка дорожает с каждым шагом.
- Не давайте агенту весь репозиторий. Чем уже контекст, тем дешевле вход — а вход и есть основная статья расхода у агентов.
- Начинайте с дешёвой серии. Поднимать класс модели стоит там, где качества не хватило, а не заранее.
Если вам ближе терминал, чем редактор, — та же схема для opencode. Разбор нескольких расширений сразу (Kilo Code, Roo Code) есть в отдельном руководстве по VS Code.
Частые вопросы
Как подключить Cline к своему API?
/v1, вставьте ключ и впишите Model ID. После этого задайте окно контекста в блоке Model Configuration и проверьте связь коротким сообщением.Какой Base URL указывать в Cline?
/v1 включительно, без завершающего слэша. Cline сам дописывает /chat/completions, поэтому добавлять этот путь вручную не нужно — иначе запрос вернёт 404.Почему Cline пишет Model not found?
GET /v1/models к вашему base_url и подставить название оттуда.Работает ли Cline в Cursor и JetBrains?
Сколько стоит пользоваться Cline?
qwen-flash), а разумная основная модель — auto при 40 / 160 ₽ за 1 млн вход / выход.Попробуйте сами
Получите base_url и ключ прямо сейчас
Кнопка на странице API выдаёт адрес и ключ сразу — без регистрации и без привязки карты.
Получить API-ключ