Перейти к содержимому

Подключение Cline: VS Code и CLI ​

Формат API OpenAI Compatible / Chat Completions · Base URL https://1app.ru/v1

Cline — помощник для работы с кодом. Можно использовать расширение VS Code или отдельную программу в терминале. Выберите нужный раздел: устанавливать оба клиента не требуется.

Перед началом ​

  1. Создайте токен в консоли 1APP. Порядок описан в быстром старте.
  2. Проверьте баланс и группу токена. Выберите доступную этой группе текстовую модель с поддержкой инструментов.
  3. Скопируйте точный идентификатор модели из каталога моделей, а не её отображаемое название. Не используйте модели для изображений, аудио или видео.

В обоих клиентах понадобятся три значения:

ПолеЗначение
ПровайдерOpenAI Compatible
Base URLhttps://1app.ru/v1
API KeyВаш токен 1APP
Model IDТочный идентификатор доступной модели

Защита токена и проекта

Не публикуйте токен в репозитории, скриншотах или обращениях в поддержку. Cline отправляет модели контекст задачи и может читать файлы проекта. Не добавляйте секреты в контекст. На первом запуске оставьте автоматическое подтверждение действий выключенным.

Вариант 1: расширение VS Code ​

Шаг 1: установка ​

Откройте Extensions в VS Code (Ctrl+Shift+X, на macOS — Cmd+Shift+X) и установите Cline из Visual Studio Marketplace. Идентификатор официального расширения — saoudrizwan.claude-dev.

Откройте папку проекта и панель Cline на боковой панели редактора.

Шаг 2: подключение 1APP ​

  1. При первом запуске выберите использование собственного API-ключа. Если Cline уже настроен, откройте его настройки кнопкой с шестерёнкой.
  2. В API Provider выберите OpenAI Compatible, не OpenAI Codex / вход через подписку ChatGPT.
  3. Заполните Base URL, API Key и Model ID по таблице выше.
  4. Не включайте Azure Identity Authentication: токен 1APP не относится к Azure.
  5. Если настройка провайдеров разделена между Plan и Act, укажите 1APP и нужную модель для обоих режимов. Иначе после переключения режима запрос может уйти другому провайдеру.
  6. Сохраните настройки. Если есть кнопка Verify, проверьте подключение.

Названия и расположение полей могут немного отличаться между версиями. Размер контекста, поддержку изображений и другие возможности задавайте только по характеристикам выбранной модели. Цены в интерфейсе Cline служат оценкой; фактические списания смотрите в 1APP.

Шаг 3: проверка ​

В режиме Plan отправьте запрос:

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

Подтверждайте только ожидаемое чтение файлов. Ответ без ошибок авторизации подтверждает доступ к модели. В консоли 1APP проверьте журнал запросов: там должен появиться вызов выбранной модели.

Вариант 2: Cline CLI ​

Шаг 1: установка ​

Установите Node.js с npm, если npm ещё нет. Затем выполните в терминале:

bash
npm install -g cline
cline --version

Пакет cline устанавливает бинарный файл для поддерживаемой платформы. Актуальные требования и альтернативы установки смотрите в официальном README CLI.

Шаг 2: подключение 1APP ​

Запустите интерактивную настройку:

bash
cline auth

Выберите использование собственного API-ключа и провайдера OpenAI Compatible. Введите адрес https://1app.ru/v1, токен 1APP и точный Model ID.

Не выбирайте вход через Cline или подписку ChatGPT: это другой способ доступа, не подключение к 1APP. Настройки расширения VS Code не следует считать автоматически перенесёнными в CLI — настройте и проверьте CLI отдельно.

Почему интерактивная настройка

Не вставляйте токен прямо в команду с --apikey: он может сохраниться в истории терминала или попасть в список аргументов процесса. Используйте ввод в интерфейсе cline auth.

Шаг 3: запуск и проверка ​

Перейдите в каталог проекта и запустите:

bash
cline

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

Если не работает ​

  • 401 / invalid token: проверьте токен 1APP, его срок действия и ограничения. Не используйте токен учётной записи Cline вместо токена 1APP.
  • 404: адрес должен заканчиваться на /v1, без /chat/completions или /responses. Проверьте выбор OpenAI Compatible.
  • Нет доступных каналов / model not found: проверьте Model ID и группу токена. Выберите модель, доступную именно вашему токену.
  • Ответ есть, но инструменты не работают: проверьте поддержку инструментов выбранной моделью. Успешный текстовый ответ не гарантирует совместимость всех функций Cline.
  • После Plan/Act меняется поведение: проверьте провайдера и модель в обоих режимах.
  • Недостаточно средств / квоты: проверьте баланс аккаунта и лимит токена в 1APP.

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