Cline (VS Code / Cursor)

Cline — агентное расширение для VS Code, VSCodium и Cursor. Он читает файлы проекта, сам пишет и правит код, запускает команды в терминале и выполняет многошаговые задачи, запрашивая у модели следующий шаг. Модель в Cline подключается как обычный OpenAI-совместимый чат, поэтому переход на SpeShu.AI сводится к двум значениям.

Нужны ровно два значения: базовый адрес https://speshu.ai/api/v1 и API-ключ в заголовке Authorization: Bearer. Cline ходит в /chat/completions обычным OpenAI-совместимым запросом, поэтому переписывать сценарии и промпты не нужно — меняется только провайдер в настройках. Ключ создаётся в личном кабинете, подробности — в разделе Аутентификация.

Установка

Откройте Extensions: Ctrl+Shift+X (Windows/Linux) или Cmd+Shift+X (macOS).
Найдите Cline в поиске и установите расширение.
Откройте панель Cline на боковой панели.

Команда Cline: Open In New Tab в палитре команд открывает ту же панель в отдельной вкладке редактора — удобно, когда основная панель занята терминалом.

Ключ и идентификатор модели

Создайте ключ и проверьте его

Ключ создаётся в веб-приложении: speshu.ai/profile, раздел API-ключей. Полное значение показывается один раз.

export SPESHU_API_KEY="sk-ваш-ключ"

Проверьте его запросом баланса — он ничего не стоит и не обращается к моделям:

cURL

curl -s https://speshu.ai/api/v1/balance \
  -H "Authorization: Bearer $SPESHU_API_KEY"

Ответ {"RUB": "...", "USD": "..."} означает, что ключ принят. Пустой объект {} — тоже корректный ответ: ключ рабочий, записей в кошельке пока нет.

Возьмите идентификатор модели из каталога

Идентификаторы текстовых моделей не зашивайте в код: состав каталога меняется, модели появляются, уходят и переименовываются, а зашитый в конфиг идентификатор начинает падать с 404 model_not_found без предупреждения. Возьмите его из каталога и подставьте в настройки:

cURL

export SPESHU_MODEL=$(curl -s https://speshu.ai/api/v1/models \
  -H "Authorization: Bearer $SPESHU_API_KEY" \
  | jq -r '.data[0].id')
echo "$SPESHU_MODEL"

.data[0] — первый элемент, чтобы пример был запускаемым. Выбирайте модель по context_length, cost_completion и наличию зрения: Cline отправляет в контекст выбранные файлы, и окно уходит быстрее, чем кажется. Формат ответа — в разделе Модели и цены.

Проверьте модель до того, как впишете её в Cline

Один пробный запрос стоит копейки и сразу показывает, принимает ли шлюз эту модель и ваш ключ вместе:

cURL

curl -s https://speshu.ai/api/v1/chat/completions \
  -H "Authorization: Bearer $SPESHU_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{
    \"model\": \"$SPESHU_MODEL\",
    \"messages\": [{\"role\": \"user\", \"content\": \"Ответь одним словом: работает?\"}]
  }" | jq -r '.choices[0].message.content, .usage.cost.total_cost'

usage.cost.total_cost — сумма, списанная с кошелька в рублях. Если этот запрос отработал, конфигурация Cline будет работать: он уходит в тот же адрес с тем же ключом.

Настройка подключения

Внутри Cline провайдер выбирается в панели настроек API-конфигурации — откройте панель Cline, нажмите на название провайдера у поля ввода (или кнопку Configure рядом с ним) и выберите OpenAI Compatible.

Поле в панели	Значение
API Provider	`OpenAI Compatible`
Base URL	`https://speshu.ai/api/v1`
API Key	`sk-ваш-ключ` с speshu.ai/profile
Model ID	значение `$SPESHU_MODEL` из шага выше
Use custom context window	включите, если хотите задать `context_length` вручную, иначе оставьте выключенным

Названия полей в панели Cline зависят от версии расширения и переименовывались между релизами. Ориентируйтесь не на подпись, а на смысл: выберите OpenAI-совместимого провайдера (в списке он называется OpenAI Compatible) и заполните базовый адрес, ключ и идентификатор модели. В некоторых сборках у провайдера OpenAI тот же результат даёт галочка Use custom OpenAI base URL — это тот же адрес и тот же ключ, другой лишь путь в интерфейсе.

Cline хранит настройки в хранилище самого редактора, а не в JSON-файле проекта. Переносить конфигурацию между машинами удобно кнопкой экспорта на экране API Configuration: она выдаёт копию всех полей сразу, а обратный импорт заполняет форму. Редактировать экспорт вручную не нужно — поменяйте значения в интерфейсе, иначе расхождение с фактическим состоянием расширения неизбежно.

Адрес пишите без завершающего слэша: https://speshu.ai/api/v1. Значение со слэшем на конце даёт путь с двойным разделителем и 404 при верных ключе и модели.

Первый запрос и проверка

Оставьте лимит запросов

В настройках Cline есть параметр Max Requests — сколько запросов к модели агент делает за одну задачу. Для проверки поставьте небольшое значение: у агента на каждый шаг уходит отдельный запрос, и длинная задача на большом контексте заметно съедает баланс.

Сформулируйте задачу в Plan Mode

Первым делом переключитесь в Plan Mode (кнопка переключения режима в панели Cline). В нём агент читает проект и составляет план, но не правит файлы и не запускает команды — это самый дешёвый способ убедиться, что модель и инструменты работают.

Отправьте пробную задачу

Например: «Найди в проекте все места, где HTTP-клиент создаётся без таймаута, и перечисли их файлы и строки». В ответ вы получите список файлов и предложенный план — без единого изменения на диске.

Переключитесь в Act Mode

Теперь тот же запрос можно выполнить: агент начнёт править файлы и запускать команды. Проверьте баланс до и после:

cURL

curl -s https://speshu.ai/api/v1/balance \
  -H "Authorization: Bearer $SPESHU_API_KEY"

Разница — реальный расход задачи. Если она оказалась неожиданно большой, снижайте Max Requests, убирайте лишние файлы из контекста и берите модель дешевле — фильтры по цене в каталоге приведены в разделе Модели и цены.

Автономный режим Cline — это расход без верхней границы в деньгах: запросы идут, пока агент считает задачу нерешённой. Первые задачи запускайте с автоодобрением выключенным и в Plan Mode. Полный список кодов и условия, при которых запрос повторяется, — в разделе Ошибки.

Об эмбеддингах

Эндпоинта /embeddings в /api/v1 нет, и Cline его не вызывает: поиск по проекту у Cline устроен на чтении файлов и контекстных ссылках, а не на векторах. Шлюз здесь не участвует. Если вы добавите в Cline контекстный провайдер, которому нужны эмбеддинги, он будет обращаться к адресу из настроек провайдера и получит 404. Заменить этот эндпоинт на стороне SpeShu.AI нельзя — векторный шаг нужно увести на отдельного провайдера со своим адресом и ключом.

Потоковая передача

Cline показывает токены по мере их прихода — это включено по умолчанию, отдельных настроек не требует. Формат кадров, маркер [DONE] и кадр со списанием разобраны на странице Потоковая передача.

Инструменты

Чтение и запись файлов, запуск команд в терминале, поиск по проекту — это инструменты Cline, и модель вызывает их сама через tools[] в POST /chat/completions. Настройка здесь одна: держите автоодобрение выключенным при первой настройке, пока не убедитесь, что модель не предлагает разрушительные команды. Формат tool_calls, возвращение результата и цикл агента разобраны на странице Вызов функций.

Через контекстные ссылки Cline подставляет выбранные файлы и папки в сообщение. Формулировки вроде «@src/auth» или «Focus on this file» экономят окно контекста сильнее, чем сокращение промпта: в запрос уходит ровно то, что нужно модели.

Изображения

Cline умеет прикреплять к сообщению картинку — перетащите файл в панель или вставьте из буфера обмена. Она уходит в модель как блок image_url и требует модели со зрением; модель без зрения отвергнет запрос целиком с 400 invalid_request, а не проигнорирует картинку. Требования к ссылке и все четыре типа блоков контента — в гайде Медиаввод.

Генерация медиа

Cline не умеет вызывать медиа-API: запрос создаёт задачу, оплата идёт при создании, результат приходит по опросу — это не формат чата. Если такая генерация нужна, делайте её отдельным вызовом из терминала по инструкции из Создание задачи. Идентификаторы медиа-моделей, в отличие от текстовых, стабильны: берите их из GET /api/v1/media/models.

MCP

Cline умеет подключать MCP-серверы. Файл настроек зависит от версии расширения: глобальный конфиг называется cline_mcp_settings.json, проектный — .mcp.json в корне рабочей папки. Проверьте фактическое имя в самом интерфейсе — переименование между релизами ломает настройку молча. Формат файла и подключение SpeShu.AI как MCP-сервера описаны на странице MCP-сервер.

Частые проблемы

404 на первом запросе, хотя ключ и модель верны

Проверьте адрес в Base URL: без завершающего слэша и без потерянного /v1. https://speshu.ai/api и https://speshu.ai/api/v1/ — обе частые причины, обе дают 404. Разбор адресов — в разделе Введение в API.

401 invalid_api_key

Проверьте, что в поле API Key попал полный ключ с префиксом sk-, без кавычек и переноса строки, и что он не отозван в профиле. Отдельно убедитесь, что выбран именно OpenAI Compatible, а не один из встроенных провайдеров с предзаполненным ключом.

402 insufficient_quota на платной задаче

На балансе нет положительной суммы. Проверьте его командой с шага выше; пополнение — в личном кабинете. Баланс проверяют до обращения к модели. За отказ деньги не списываются.

404 model_not_found после обновления расширения или спустя время

В поле Model ID зашит идентификатор, которого больше нет в GET /api/v1/models. Заберите значение заново и вставьте как есть — без префикса и без обрезки. Список в конфиге устаревает молча, поэтому проверяйте его при первом обращении к API и после любой смены модели в аккаунте.

422 content_too_large на длинной задаче

Агент собрал в контекст больше, чем помещается в окно модели. Сравните context_length из каталога с вашим реальным входом, сузьте контекстные ссылки или включите в Cline автокомпакцию. Подробности — в разделе Модели и цены.

Cline всё равно ходит в OpenAI, хотя адрес указан верный

Проверьте, что выбран провайдер OpenAI Compatible, а не встроенный OpenAI или Anthropic с предзаполненным адресом. В части версий у встроенного провайдера OpenAI адрес меняется только после включения галочки Use custom OpenAI base URL — без неё поле остаётся с адресом по умолчанию.

Всё остальное

Полная таблица кодов, три формата ошибок и цикл повторов — на странице Ошибки, таймауты и квоты — в разделе Лимиты.

Что дальше

Модели и цены

Как выбрать идентификатор и на что смотреть

Вызов функций

Как модель вызывает инструменты Cline

Потоковая передача

SSE, [DONE] и кадр со списанием

MCP-сервер

Инструменты управления аккаунтом из агента

Начало работы

Возможности моделей

Генерация медиа

Фреймворки

Базы данных

Агенты и редакторы

No-code и автоматизация

Установка

Ключ и идентификатор модели

Настройка подключения

Первый запрос и проверка

Об эмбеддингах

Потоковая передача

Инструменты

Изображения

Генерация медиа

MCP

Частые проблемы

Что дальше

Модели и цены

Вызов функций

Потоковая передача

MCP-сервер

​Установка

​Ключ и идентификатор модели

​Настройка подключения

​Первый запрос и проверка

​Об эмбеддингах

​Потоковая передача

​Инструменты

​Изображения

​Генерация медиа

​MCP

​Частые проблемы

​Что дальше

Модели и цены

Вызов функций

Потоковая передача

MCP-сервер

Установка

Ключ и идентификатор модели

Настройка подключения

Первый запрос и проверка

Об эмбеддингах

Потоковая передача

Инструменты

Изображения

Генерация медиа

MCP

Частые проблемы

Что дальше