Вернуться наверх

Использование ИИ-ассистента в средах разработки ​

В этом руководстве вы узнаете, как подключить и использовать ИИ-ассистента Cline в редакторе Visual Studio Code.

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

Чтобы развернуть ИИ-ассистента Cline:

  1. Создайте деплоймент языковой модели.
  2. Установите и настройте Cline в редакторе Visual Studio Code.
  3. Проверьте работу ассистента.

Если вам больше не нужны созданные ресурсы, удалите их.

Перед началом работы ​

  1. Создайте сервисный аккаунт с именем sa-inferencer и ролью gpt.inferencer. Он нужен для обращения к модели.
  2. Для сервисного аккаунта создайте API-ключ и сохраните его значение.

1. Создайте деплоймент языковой модели ​

  1. В веб-консоли выберите нужный проект.
  2. В списке сервисов выберите GPT Model Hub и нажмите кнопку Создать.
  3. Укажите имя деплоймента — qwen3-coder-480b-a35b.
  4. Выберите подходящую вам модель. В этом руководстве используется модель qwen3-coder-480b-a35b с контекстом в 128000 токенов.
  5. Нажмите кнопку Создать.

Дождитесь, когда статус деплоймента изменится на Active.

Как убедиться, что модель готова к работе?

Вы можете проверить доступность модели с помощью запроса:

bash
curl -X POST "https://gpt.mwsapis.ru/projects/<имя вашего проекта>/openai/v1/chat/completions" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <API-ключ>" \
  -d '{
    "model": "qwen3-coder-480b-a35b",
    "messages": [{"role": "user", "content": "Hello! Are you alive?"}]
  }'

2. Установите и настройте Cline ​

2.1 Установите Cline ​

  1. Откройте Visual Studio Code и нажмите View → Extensions.

  2. Введите в строку поиска Cline.

  3. Установите расширение с именем Cline и следующими параметрами:

    • Ссылка на сайт расширения: https://cline.bot/.
    • Верификация: This publisher has verified ownership of cline.bot.

В левом меню появится новая иконка Cline.

2.2 Настройте Cline ​

  1. Нажмите на иконку Cline в меню слева.

  2. Расширение предложит выполнить первоначальную настройку. Выберите опцию Bring my own API key.

  3. Укажите настройки API:

    • API Provider — OpenAI Compatible.

    • Base URL — https://gpt.mwsapis.ru/projects/<имя вашего проекта>/openai/v1.

    • OpenAI Compatible API Key — API-ключ, полученный ранее.

      Пример ключа: v1.mws6GEy32KinlG...MHi-74HpDfWP3q.

    • Model ID — qwen3-coder-480b-a35b.

  4. Раскройте блок Model Configuration и укажите настройки модели:

    • Supports Images — выключено. Выбранная для этого руководства модель не поддерживает работу с изображениями.
    • Context Window Size — 128000. Рекомендуется в настройках Cline устанавливать такое же значение контекста, как у выбранной модели. Это позволит Cline лучше управлять контекстом.

  5. Нажмите кнопку Done. Расширение готово к работе.

Как включить поддержку русского языка?

Чтобы переключить язык, на котором модель будет вести диалог:

  1. Перейдите в настройки Cline.
  2. Выберите пункт General Settings.
  3. Для параметра Preferred Language выберите вариант Russian - Русский.
  4. Нажмите кнопку Done.

3. Проверьте работу Cline ​

Cline может работать в двух режимах:

  • Plan — в этом режиме Cline работает как советник и не вносит изменения в код. Этот режим удобно использовать для обучения, изучения кода, проектирования решений и сложных изменений.
  • Act — в этом режиме Cline вносит изменения самостоятельно. Этот режим пригодится для автоматизации рутинных, четко поставленных задач, а также для массовых изменений в коде.

Чтобы использовать Cline:

  1. Нажмите на значок Cline в левом меню.
  2. В поле с описанием Type your task here... напишите ваш запрос, например, Привет! Ты готов к работе?.
  3. Выберите режим работы Cline: Plan или Act.
  4. Нажмите клавишу Enter.

Варианты использования Cline ​

ИИ-ассистент поможет вам в следующих задачах:

  • Разработка кода — создание новых файлов и компонентов, рефакторинг существующего кода, генерация функций, классов и модулей по описанию.

    text
    Напиши функцию на Python, которая сортирует список чисел методом пузырька.
    text
    Проанализируй этот код и предложи варианты оптимизации.

  • Работа с файловой системой — чтение, создание, редактирование, переименование и перемещение файлов, а также их пакетная обработка.

    text
    Сделай копию файла mycode.py и сохрани его в отдельном каталоге test/mycode.py.

  • Выполнение команд — установка пакетов, запуск тестов и сборок, работа с Git, управление проектом через CLI.

    text
    Установи Python и все нужные зависимости.
    text
    Обнови текущую ветку, покажи изменения.

  • Анализ и документирование — генерация документации по коду, создание README-файлов, комментариев и спецификаций.

    text
    Создай краткий README-файл по странице mycode.py.

  • QA и тестирование — написание unit-тестов, проведение ревью кода, поиск багов и уязвимостей.

    text
    Найди уязвимости и баги в моем файле mycode.py.

  • Интеграция с внешними сервисами — работа с REST API, GraphQL, парсинг веб-страниц.

    text
    Сделай curl-запрос к публичному API https://catfact.ninja/fact.

  • Обучение и онбординг — объяснение кода новичкам, создание учебных примеров.

    text
    Проанализируй страницу deployment.md и подготовь ее краткое содержание, понятное новичку.

Возможные ошибки при работе Cline ​

Иногда при выполнении запросов к Cline могут возникать ошибки 400 или 404:

bash
[OPENAI] 404 status code (no body)
{"message":"404 status code (no body)","status":404,"modelId":"qwen3-coder-480b-a35b","providerId":"openai"}

Ошибки связаны с особенностями работы расширения Cline. Они могут возникнуть в следующих случаях:

  • Пользователь указал некорректные значения при первоначальной настройке Cline, после чего исправил значения на верные.
  • Пользователь в процессе работы с Cline изменил какую-то из настроек, например, имя деплоймента или API-ключ.

Чтобы устранить ошибку:

  1. Убедитесь, что все настройки расширения Cline корректны.
  2. Перезапустите Visual Studio Code.
  3. Выполните новый запрос к Cline.
  4. Если ошибка сохраняется, попробуйте повторить запрос к Cline через несколько минут.

Удалите ресурсы ​

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