Cline AI в VS Code: как подключить API и проверить запрос

Cline — расширение для VS Code, которое передаёт задачу во внешний модельный API и показывает ответ в редакторе. Для работы через BetterToken в Cline нужно выбрать OpenAI Compatible и указать Base URL, API Key и Model ID. Ниже — короткий путь от установки расширения до проверки запроса в BetterToken Dashboard.

Что такое Cline и как он связан с VS Code

В этой связке работают три отдельных уровня:

  • VS Code — редактор, который запускает расширения. Он не обращается к AI API напрямую.
  • Cline — расширение, которое принимает задачу в редакторе и обращается к выбранному модельному API. Само расширение не является языковой моделью.
  • Модельный API — внешний сервис, куда Cline отправляет запросы. BetterToken предоставляет OpenAI-compatible интерфейс, через который Cline получает ответы моделей.

Cline не входит в VS Code и не является расширением BetterToken. Такое разделение помогает при диагностике: Cline отвечает за отправку задачи, а статус API-запроса и расход токенов проверяются на стороне BetterToken.

Что подготовить перед подключением API

Перед началом нужны три вещи:

  1. VS Code — установленный редактор. Официальный способ установки расширения описан в документации Cline.
  2. BetterToken API Key — собственный ключ из личного кабинета. Если аккаунта ещё нет, зарегистрируйтесь и создайте API Key.
  3. Model ID — точный идентификатор модели из группы Codex в текущем списке моделей BetterToken. Не фиксируйте модель по старому руководству: скопируйте доступный ID перед настройкой.

Из России подключиться к API Endpoint BetterToken можно без VPN и без иностранной банковской карты. Это касается именно соединения с BetterToken API — отдельные инструменты или их официальные сайты могут работать иначе.

Создайте BetterToken API Key и настройте Cline по актуальной документации: docs.bettertoken.ai/en/ai-tools/cline

Как настроить BetterToken в Cline

Шаг 1. Установка расширения

Откройте VS Code и нажмите Ctrl+Shift+X (Windows/Linux) или Cmd+Shift+X (macOS). В строке поиска введите Cline и установите расширение Cline. Откройте его через значок на боковой панели.

Если значок не появился, откройте командную палитру (Ctrl+Shift+P / Cmd+Shift+P) и выполните Cline: Open In New Tab.

Шаг 2. Проверка конфликтующих переменных

Если раньше вы настраивали другой OpenAI-compatible endpoint через переменные окружения, закройте VS Code, очистите их в том же shell и запустите редактор заново:

unset OPENAI_API_KEY
unset OPENAI_BASE_URL

Если таких переменных не было, пропустите этот шаг.

Шаг 3. Открытие настроек

При первом запуске нажмите Use your own API key в панели Cline. Если провайдер уже настроен, откройте параметры кнопкой ⚙️.

Шаг 4. Выбор провайдера

В поле API Provider выберите OpenAI Compatible.

Шаг 5. Заполнение параметров

Поле Значение
Base URL https://www.bettertoken.ai/v1
API Key ваш BetterToken API Key (например: your_api_key_here)
Model ID точный ID модели из группы Codex

Используйте Base URL именно в указанном виде. Дополнительные headers, включая User-Agent, для обычного подключения BetterToken не требуются. Добавляйте их только тогда, когда это прямо требует документация другого промежуточного сервиса.

Шаг 6. Сохранение и перезагрузка

Нажмите Done, затем перезапустите Cline или перезагрузите окно VS Code через командную палитру: Developer: Reload Window.

Как проверить Cline на безопасной задаче

Первую проверку стоит делать на задаче без права записи. Откройте любой файл в VS Code и отправьте Cline запрос:

Прочитай текущий открытый файл и объясни его назначение в двух-трёх предложениях. Не изменяй файлы и не запускай команды.

Подтверждайте только чтение файла. Если Cline запрашивает разрешение на изменение или запуск команды, отклоните действие: для первой проверки оно не нужно.

После этого откройте BetterToken Dashboard и проверьте историю запросов. Запись должна содержать:

  • статус запроса — успех или код ошибки;
  • имя модели — должно совпадать с Model ID, который вы указали в Cline;
  • input и output tokens по этой операции.

Если запись относится к вашему тесту, Model ID совпадает, а статус успешный, цепочка Cline → BetterToken API работает.

Что проверить, если запрос не появился в Dashboard

Если записи нет, BetterToken не зафиксировал тестовый запрос. Сначала проверьте настройки Cline и сетевое соединение.

Чек-лист:

  • API Key — скопируйте ключ заново, убедитесь, что нет пробелов в начале или конце. Один лишний символ даёт 401.
  • Base URL — должен быть точно https://www.bettertoken.ai/v1.
  • Model ID — скопируйте доступный ID из группы Codex на странице моделей BetterToken.
  • Сохранение настроек — нажмите Done, затем перезапустите Cline или выполните Developer: Reload Window.
  • Переменные окружения — убедитесь, что старые OPENAI_API_KEY и OPENAI_BASE_URL не подменяют текущую конфигурацию.
  • Сеть — проверьте firewall и прокси, если Cline сообщает об ошибке соединения.

Если запрос попал в Dashboard, но Cline показывает ошибку:

Откройте запись и сначала посмотрите её статус. При успешном API-статусе повторно проверьте версию Cline и выбранный Model ID. При ошибке используйте код и время запроса для дальнейшей диагностики.

Если Dashboard показывает ошибку:

Проверьте API Key, баланс и точность Model ID. Актуальный список моделей — на странице цен.

Официальные источники