Интеграция с Cline

Использование расширения Cline для VS Code с QCode.cc API

Интеграция с Cline¶

Cline — это расширение AI-программирования для VS Code (миллионы установок), поддерживающее любые AI-модели и пользовательские API-эндпоинты. Оно включает режимы Plan / Act, предпросмотр изменений файлов в виде diff, выполнение команд в терминале и вызов инструментов через MCP. С помощью Cline и QCode.cc API вы можете использовать модели Claude, GPT и другие в VS Code по низкой стоимости.

Почему Cline?¶

• Без наценки: никаких надбавок к стоимости модели — вы платите только за QCode.cc API

• Гибкое переключение моделей: переключайте claude-opus-4-8, claude-sonnet-4-6, gpt-5.x и другие модели в одном интерфейсе

• Глубокая интеграция с VS Code: боковая панель, встроенные действия с кодом, предпросмотр изменений в виде diff, авто-одобрение

• Режимы Plan / Act: сначала планирование, затем выполнение — сложные изменения остаются под контролем

• Полностью открытый исходный код: прозрачный код, активное сообщество

• Поддержка MCP: подключение внешних инструментов (базы данных, браузеры, документация) через Model Context Protocol

Установка и настройка¶

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

В VS Code:

1. Откройте панель расширений (Ctrl+Shift+X / Cmd+Shift+X)

2. Найдите "Cline"

3. Нажмите Установить

4. После установки иконка Cline появится на левой панели действий

У Cline также есть версия для командной строки (Cline CLI), которая использует ту же конфигурацию в терминале; это руководство сосредоточено на расширении для VS Code.

Шаг 2: Настройка QCode.cc API¶

Один API-ключ QCode.cc (начинается с cr_) совместим как с протоколом Anthropic, так и с протоколом OpenAI. Cline предлагает два способа подключения — выберите любой из них:

Вариант A: Совместимый с Anthropic (рекомендуется для моделей Claude)¶

В настройках Cline (иконка шестерёнки) откройте выпадающий список API Provider и выберите "Anthropic", затем заполните:

SDK автоматически добавляет /v1/messages после Base URL, поэтому укажите Base URL до /api — не пишите /api/v1/messages и не добавляйте завершающий слеш.

Вариант B: Совместимый с OpenAI¶

В выпадающем списке API Provider выберите "OpenAI Compatible", затем заполните:

Режим, совместимый с OpenAI, использует эндпоинт /chat/completions и даёт доступ ко всей линейке Claude и GPT из одного интерфейса.

Шаг 3: Проверка подключения¶

Введите простое сообщение в чат Cline (например, "Hello"). Если получен ответ — настройка прошла успешно.

Вы также можете проверить себя с помощью curl в терминале (ответ 401 означает, что путь верен и не хватает только аутентификации):

# Протокол Anthropic
curl -i https://api.qcode.cc/api/v1/messages \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-4-6","max_tokens":16,"messages":[{"role":"user","content":"hi"}]}'

# Протокол OpenAI
curl -i https://api.qcode.cc/openai/v1/chat/completions \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-4-6","messages":[{"role":"user","content":"hi"}]}'

Резервные узлы¶

Один и тот же ключ работает на 4 доменах доступа, которые дублируют друг друга. Если основной домен нестабилен, замените api в Base URL на соответствующий поддомен из таблицы ниже:

Пользователям в материковом Китае рекомендуется отдавать предпочтение asia.qcode.cc — обычно у него самая низкая задержка. Подробнее см. Точки доступа и форматы API.

Режимы Plan / Act¶

Cline предлагает переключатель Plan / Act под полем чата:

• Plan (планирование): Cline читает код, задаёт вопросы и предлагает план реализации, но не изменяет файлы. Удобно для согласования требований перед началом работы.

• Act (выполнение): Cline реально создаёт/редактирует файлы, выполняет команды и вызывает инструменты. Каждое изменение показывается в виде diff для одобрения или авто-одобрения.

Типичный рабочий процесс: сначала в режиме Plan дайте модели изложить и подтвердить подход, затем переключитесь в режим Act для пошаговой реализации. Для сложных задач планируйте с более сильной в рассуждениях claude-opus-4-8, а выполняйте с более выгодной claude-sonnet-4-6.

Советы по использованию¶

1. Рекомендации по выбору модели¶

Полные цены см. в разделе Тарификация.

2. Настройка инструментов MCP¶

Cline поддерживает Model Context Protocol (MCP), позволяя модели вызывать внешние инструменты (запросы к БД, браузеры, поиск по документам и т. д.). Добавьте сервер в панели MCP Servers в Cline:

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/project"]
    }
  }
}

Серверы MCP не привязаны к вышестоящей модели — вызовы инструментов работают независимо от того, подключаетесь ли вы к QCode.cc по протоколу Anthropic или OpenAI. Шаги установки и параметры каждого сервера см. в официальной документации соответствующего инструмента.

3. Пользовательские инструкции уровня проекта (.clinerules)¶

Создайте файл .clinerules в корне проекта, чтобы внедрить фиксированный контекст для этого репозитория — стиль кода, соглашения по стеку, структуру каталогов. Cline включает эти правила в каждый диалог, поэтому их не нужно вставлять повторно:

# .clinerules

- Везде использовать TypeScript, строгий режим
- Предпочитать переиспользование утилит из src/lib
- Перед коммитом запускать `pnpm test`

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

4. Ввод изображений (зрение)¶

claude-opus-4-8, claude-sonnet-4-6 и GPT-5.x поддерживают ввод изображений (vision). Перетащите скриншот интерфейса, скриншот ошибки или схему архитектуры прямо в поле чата Cline, чтобы модель писала код по изображению или искала ошибки.

Примечание: здесь речь о том, чтобы модель читала изображения. Чтобы генерировать изображения, используйте Генерацию изображений gpt-image-2 с именем модели gpt-image-2.

5. Авто-одобрение и контроль затрат¶

• В настройках можно отдельно включить Auto-approve для «чтения файлов», «записи файлов» и «выполнения команд», чтобы уменьшить прерывания; для рискованных операций оставьте ручное подтверждение.

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

• Для больших кодовых баз используйте @ (упоминание файла/папки/URL), чтобы передать точный контекст, вместо того чтобы модель сканировала весь проект — это экономит токены и сохраняет фокус.

6. Совместное использование с Claude Code CLI¶

Cline и Claude Code CLI имеют свои преимущества — рекомендуется использовать их вместе:

7. Общая квота¶

Cline и Claude Code CLI используют один и тот же API-ключ QCode.cc и разделяют квоту тарифного плана — не нужно запрашивать отдельные ключи для каждого инструмента.

Часто задаваемые вопросы¶

Не удаётся подключиться / 401 / 404?¶

1. Убедитесь, что в конце Base URL нет лишнего /

2. В режиме Anthropic укажите Base URL до /api (SDK добавит /v1/messages) — не пишите полный путь вручную

3. В режиме OpenAI укажите Base URL до /openai/v1

4. Проверьте, что API-ключ начинается с cr_ и скопирован полностью

5. Попробуйте переключиться на резервный узел (например, asia.qcode.cc)

6. Убедитесь, что сеть имеет доступ к сервису QCode.cc

Список моделей пуст?¶

В режиме, совместимом с OpenAI, вручную введите название модели в поле Model ID (например, claude-sonnet-4-6) — выбирать из списка не обязательно.

Режим Plan не изменяет файлы?¶

Это ожидаемое поведение. Режим Plan только планирует; изменения записываются лишь после переключения в режим Act.

Получаете 401, хотя настройки выглядят правильно?¶

401 обычно означает, что путь верен и не прошла только аутентификация. Перепроверьте, что API Key введён полностью и что выбран правильный тип Provider (Anthropic или OpenAI Compatible) с соответствующим Base URL.

Следующие шаги¶

• Ознакомьтесь с Точками доступа и форматами API — все протоколы и домены

• Ознакомьтесь с интеграцией с Aider — ещё одним открытым инструментом, совместимым с QCode.cc

• Ознакомьтесь с интеграцией с VS Code для использования официального расширения Claude Code

• Посмотрите информацию о тарификации для ознакомления с ценами

Ещё нет API-ключа? Посмотрите тарифы и цены QCode.cc →