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

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

## Кратко

| Параметр | Описание |
|---|---|
| Доступные модели | Claude ✅ (путь A: провайдер Anthropic) · GPT ✅ · китайские модели ✅ (путь B: OpenAI Compatible) · Gemini ❌ (этот путь на странице не описан) |
| Протокол и Base URL | Anthropic: `https://api.qcode.cc/api` · OpenAI: `https://api.qcode.cc/openai/v1` |
| Где настраивается | Панель настроек расширения VS Code (API Provider + «Use custom base URL»); десктоп — та же логика |
| Официальная документация | [cline.bot](https://cline.bot) · [GitHub](https://github.com/cline/cline) |

[Cline](https://github.com/cline/cline) — это расширение AI-программирования для VS Code (миллионы установок), поддерживающее любые AI-модели и пользовательские API-эндпоинты. Оно включает режимы Plan / Act, предпросмотр изменений файлов в виде diff, выполнение команд в терминале и вызов инструментов через MCP. С помощью Cline и QCode.cc API вы можете использовать модели Claude, GPT и [китайские семейства](/docs/usage/cn-models) в 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"**, затем заполните:

| Параметр | Значение |
|----------|----------|
| API Key | Ваш API-ключ QCode.cc (начинается с `cr_`) |
| Use custom base URL | Включите и введите `https://api.qcode.cc/api` |
| Model | `claude-sonnet-5` (дневное умолчание) или `claude-opus-5` (сложные задачи). `claude-sonnet-4-6` / `claude-opus-4-8` всё ещё в продаже |

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

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

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

| Параметр | Значение |
|----------|----------|
| Base URL | `https://api.qcode.cc/openai/v1` |
| API Key | Ваш API-ключ QCode.cc (начинается с `cr_`) |
| Model ID | `gpt-5.6-terra`, `gpt-5.5` или [китайский id](/docs/usage/cn-models) вроде `glm-5.2`. **`claude-*` здесь не работает** |

> 🔴 **В режиме, совместимом с OpenAI, модели Claude недоступны.** Точка OpenAI у QCode обслуживает только GPT и четыре китайских семейства; идентификатор `claude-*` вернёт `model_not_available_on_endpoint`. Для Claude вернитесь к **варианту A (Anthropic)** с Base URL `https://api.qcode.cc/api`. См. [Точки доступа и форматы API](/docs/getting-started/endpoints-and-api-paths).

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

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

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

```bash
# Протокол 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 на соответствующий поддомен из таблицы ниже:

| Узел | Base URL (Anthropic) | Base URL (OpenAI) |
|------|----------------------|-------------------|
| По умолчанию | `https://api.qcode.cc/api` | `https://api.qcode.cc/openai/v1` |
| Азиатско-Тихоокеанский (предпочтителен в материковом Китае) | `https://asia.qcode.cc/api` | `https://asia.qcode.cc/openai/v1` |
| США | `https://us.qcode.cc/api` | `https://us.qcode.cc/openai/v1` |
| Европа | `https://eu.qcode.cc/api` | `https://eu.qcode.cc/openai/v1` |

> Пользователям в материковом Китае рекомендуется отдавать предпочтение `asia.qcode.cc` — обычно у него самая низкая задержка. Подробнее см. [Точки доступа и форматы API](/docs/getting-started/endpoints-and-api-paths).

## Cline Desktop

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

## Режимы Plan / Act

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

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

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

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

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

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

| Сценарий | Рекомендуемая модель | Описание |
|----------|---------------------|----------|
| Повседневное программирование | `claude-sonnet-5` | Текущий баланс, 1M / 128K; на дату текста вход дешевле, чем у 4.6 |
| Сложная архитектура / режим Plan | `claude-opus-5` | Текущий флагман. `claude-opus-4-8` всё ещё в продаже |
| Лёгкие задачи / правка текста | `claude-haiku-4-5` | Минимальная стоимость |
| Нужен стиль GPT | `gpt-5.6-terra` | Доступны напрямую по протоколу OpenAI |
| Китайские семейства / ниже цена | `glm-5.2` / `deepseek-v4-pro` | См. [китайские семейства моделей](/docs/usage/cn-models) |

Полные цены см. в разделе [Тарификация](/docs/reference/billing).

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

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

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

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

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

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

```text
# .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](/docs/usage/image-2) с именем модели `gpt-image-2`.

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

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

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

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

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

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

| Сценарий | Рекомендуемый инструмент |
|----------|--------------------------|
| Быстрое редактирование в VS Code | Cline |
| Анализ сложных проектов | Claude Code CLI |
| Рефакторинг нескольких файлов | Cline |
| Git-операции, ревью кода | Claude Code CLI |
| Миграция/ревью всей кодовой базы | Claude Code CLI ([субагенты](/docs/advanced/subagents)) |
| CI/CD-автоматизация | Claude Code CLI ([headless-режим](/docs/advanced/headless)) |

### 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](/docs/getting-started/endpoints-and-api-paths) — все протоколы и домены

- Ознакомьтесь с [интеграцией с Aider](/docs/ide/aider) — ещё одним открытым инструментом, совместимым с QCode.cc

- Ознакомьтесь с [интеграцией с VS Code](/docs/ide/vscode) для использования официального расширения Claude Code

- [Китайские семейства моделей](/docs/usage/cn-models) — тот же OpenAI-совместимый набор полей для GLM / Kimi / DeepSeek / Qwen

- Посмотрите [информацию о тарификации](/docs/reference/billing) для ознакомления с ценами

> Ещё нет API-ключа? [Посмотрите тарифы и цены QCode.cc →](https://qcode.cc/pricing)