Оформление
Подключение Cline: VS Code и CLI
Формат API OpenAI Compatible / Chat Completions · Base URL
https://1app.ru/v1
Cline — помощник для работы с кодом. Можно использовать расширение VS Code или отдельную программу в терминале. Выберите нужный раздел: устанавливать оба клиента не требуется.
Перед началом
- Создайте токен в консоли 1APP. Порядок описан в быстром старте.
- Проверьте баланс и группу токена. Выберите доступную этой группе текстовую модель с поддержкой инструментов.
- Скопируйте точный идентификатор модели из каталога моделей, а не её отображаемое название. Не используйте модели для изображений, аудио или видео.
В обоих клиентах понадобятся три значения:
| Поле | Значение |
|---|---|
| Провайдер | OpenAI Compatible |
| Base URL | https://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
- При первом запуске выберите использование собственного API-ключа. Если Cline уже настроен, откройте его настройки кнопкой с шестерёнкой.
- В API Provider выберите OpenAI Compatible, не OpenAI Codex / вход через подписку ChatGPT.
- Заполните Base URL, API Key и Model ID по таблице выше.
- Не включайте Azure Identity Authentication: токен 1APP не относится к Azure.
- Если настройка провайдеров разделена между Plan и Act, укажите 1APP и нужную модель для обоих режимов. Иначе после переключения режима запрос может уйти другому провайдеру.
- Сохраните настройки. Если есть кнопка 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.