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

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

Последняя проверка: 2026-09-18 · 📄 По официальной документации (расширение VS Code 4.1.19 от 2026-09-17; десктоп — ниже)

Кратко¶

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

Почему Cline?¶

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

• Гибкое переключение моделей: переключайте claude-sonnet-5, claude-opus-5, gpt-5.6-terra и другие модели в одном интерфейсе (4.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, модели Claude недоступны. Точка OpenAI у QCode обслуживает только GPT и четыре китайских семейства; идентификатор claude-* вернёт model_not_available_on_endpoint. Для Claude вернитесь к варианту A (Anthropic) с Base URL https://api.qcode.cc/api. См. Точки доступа и форматы API.

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

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

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

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

# Протокол OpenAI (на этом протоколе только GPT или китайские id)
curl -i https://api.qcode.cc/openai/v1/chat/completions \
  -H "content-type: application/json" \
  -d '{"model":"gpt-5.5","messages":[{"role":"user","content":"hi"}]}'

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

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

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

Cline Desktop¶

14 сентября 2026 года Cline выпустил десктопное приложение (официальный анонс: "Bring your own API key and connect natively to any provider — Anthropic, OpenAI, Gemini, open-weight models, or a local endpoint"; на странице продукта дата не указана). Логика настройки провайдеров совпадает с расширением (выбор API Provider + кастомный Base URL); полевые названия для десктопа отдельно не задокументированы — сверяйтесь с интерфейсом. Загрузки и платформы: cline.bot/desktop.

Режимы Plan / Act¶

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

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

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

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

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

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-5, claude-sonnet-5 (и всё ещё продающиеся 4.8 / 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 (например, glm-5.3) — выбирать из списка не обязательно.

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

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

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

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

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

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

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

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

• Китайские семейства моделей — тот же OpenAI-совместимый набор полей для GLM / Kimi / DeepSeek / Qwen

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

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