Cline

Cline — агент программирования в IDE, который может читать файлы проекта, выполнять команды и после разрешения изменять код. Настроив OpenAI Compatible Provider, вы можете использовать в Cline совместимую точку входа Chat Completions платформы AGTCloud.

В этом руководстве рассматривается расширение Cline для IDE. Поддержка вызова инструментов, ввода изображений, Computer Use и длина контекста зависят от модели. Выбирайте модель, доступную текущему ключу API и поддерживающую Chat Completions и вызов инструментов.

Подготовка

Перед началом убедитесь, что вы:

Установили поддерживаемый редактор, совместимый с VS Code, или JetBrains IDE;
Зарегистрировались и вошли в AGTCloud;
Создали токен на странице API Keys;
Скопировали из каталога моделей ID модели, доступной текущему токену и поддерживающей Chat Completions;
Подготовили тестовый проект без конфиденциального кода.

Установка Cline

Выберите способ установки для вашей IDE. Cline также предлагает CLI, SDK и Kanban; в этом руководстве они не рассматриваются.

Для VS Code, Cursor, Windsurf, VSCodium и других редакторов:

Откройте магазин расширений или нажмите Ctrl/Cmd + Shift + X;
Найдите Cline;
Выберите официальное расширение Cline и нажмите установку;
Нажмите значок Cline на панели действий или выполните Cline: Open In New Tab через палитру команд.

Windsurf и VSCodium используют Open VSX; процесс установки практически такой же.

Если при первом открытии появляется запрос авторизации или инициализации Cline, выполните его в интерфейсе текущей версии. Другие способы установки описаны в официальной документации Cline.

Настройка AGTCloud

Открытие API Configuration

Откройте панель Cline, нажмите значок настроек и перейдите в API Configuration. Расположение настроек может немного различаться между IDE и версиями Cline.

Выбор совместимого Provider

В API Provider выберите OpenAI Compatible. Не выбирайте встроенный Provider OpenAI.

Заполнение параметров подключения

Поле Cline	Значение
`API Provider`	`OpenAI Compatible`
`Base URL`	`https://api.agtcloud.cn/v1`
`OpenAI Compatible API Key`	`your-api-key`
`Model ID` или `Model`	`MODEL_ID`
`Custom Headers`	По умолчанию оставьте пустым

Замените your-api-key и MODEL_ID своим токеном и ID модели.

Проверка и сохранение

Если текущая версия предлагает кнопку Verify, сначала проверьте подключение. После успешной проверки нажмите Done или кнопку сохранения текущего интерфейса.

Base URL должен содержать /v1

OpenAI Compatible Provider в Cline требует полного API Base URL. Используйте https://api.agtcloud.cn/v1, а не только API Origin. Не добавляйте лишний /v1, образующий /v1/v1.

Выбор и настройка модели

MODEL_ID — заполнитель для замены, а не настоящее название модели. Скопируйте из каталога моделей ID модели, доступной текущему ключу API и поддерживающей Chat Completions и вызов инструментов.

Model Configuration в Cline может предлагать Context Window, Max Output Tokens, Image Support, Computer Use, Input Price и Output Price. При первом подключении рекомендуется оставить значения по умолчанию. Меняйте их только после проверки реальных ограничений и возможностей модели.

Расширенные настройки не создают возможности модели

Включение поддержки изображений или Computer Use в Cline не добавляет этих возможностей модели, у которой их нет. Поля цен используются преимущественно для локальной оценки расхода в Cline и не отражают итоговое начисление AGTCloud.

Запуск и проверка подключения

Открытие тестового проекта

Используйте проект без конфиденциального кода и убедитесь, что в нём есть README.md, который можно безопасно читать.

Отключение автоматического одобрения

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

Задание только для чтения

Введите в Cline:

Прочитайте README.md и в трёх пунктах опишите назначение проекта. Не изменяйте никакие файлы.

Проверка результата

Если Cline читает файл и возвращает описание без неразрешённых изменений, базовое подключение установлено. Этот шаг создаёт обычный расход API.

Частые вопросы

Симптом	Что проверить сначала	Решение
Расширение Cline не отображается	Источник установки, совместимость IDE и перезапуск	Убедитесь, что установлено официальное расширение Cline; перезагрузите или перезапустите IDE
Проверка `Verify` не проходит	Сеть и Base URL	Убедитесь, что AGTCloud доступен с устройства, и используйте полный `https://api.agtcloud.cn/v1`
Ответ `401`	Содержимое ключа API и состояние токена	Скопируйте действующий ключ API заново и удалите лишние пробелы
Ответ `403`	Права токена, доступ к модели и состояние аккаунта	Проверьте состояние токена и доступные аккаунту модели в консоли
Ответ `404`	Base URL, повторный `/v1` и ID модели	Исключите `/v1/v1` и скопируйте полный ID модели заново
Сообщение Model Not Found	Видимые текущему ключу модели и протокол	Выберите модель, доступную текущему ключу API и поддерживающую Chat Completions
Диалог работает, но инструменты не работают	Поддержку вызова инструментов и расширенные настройки	Используйте модель с вызовом инструментов и проверьте ограничения контекста и вывода
Ошибка изображений или Computer Use	Реальные возможности модели	Не полагайтесь только на настройки Cline; ориентируйтесь на фактическую поддержку модели
Некорректный результат или разрыв соединения	Сетевой прокси, параметры модели и ограничения контекста	Сначала восстановите расширенные настройки по умолчанию, затем проверьте прокси, межсетевой экран и контекст модели

Если причину найти не удаётся, запишите время запроса, ID модели, HTTP-статус и обезличенную ошибку, затем обратитесь к разделу ошибок и диагностики. Не отправляйте полный ключ API.