> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apiyi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Cline (VS Code)

> Руководство по интеграции AI-помощника по программированию для VS Code

Cline (ранее Claude Dev) — это мощный плагин-помощник по программированию на базе AI для VS Code, который поддерживает несколько моделей AI. Через APIYI вы можете гибко переключаться между различными основными моделями AI, чтобы помогать себе в программировании.

## Быстрая установка

### 1. Установите плагин

Найдите «Cline» в магазине расширений VS Code и установите его

### 2. Настройте APIYI

1. Нажмите на значок Cline слева
2. Нажмите кнопку настроек (значок шестерёнки)
3. Выберите **Совместимый с OpenAI**
4. Настройте параметры:
   * **Base URL**: `https://api.apiyi.com/v1`
   * **API Key**: Ваш ключ APIYI
   * **Model Name**: Введите имя модели

### Рекомендуемые модели

#### 🎯 Лучший выбор для разработки

* `claude-sonnet-4-20250514` ⭐ (последняя версия Claude 4, чрезвычайно сильная в программировании)
* `o4-mini` (модель рассуждения OpenAI, первый выбор для задач программирования)
* `gemini-2.5-pro` ⭐ (контекст 2M, мощная мультимодальность)
* `deepseek-coder` (модель, специализированная для кода, контекст 128K)

#### 💡 Сложные задачи рассуждения

* `o3` ⭐ (последняя модель рассуждения, значительно сниженная тарификация)
* `claude-sonnet-4-20250514-thinking` (режим chain-of-thought Claude 4)
* `deepseek-r1` ⭐ (последняя модель рассуждения, контекст 64K)
* `grok-3-mini` (легковесная модель с рассуждением)

#### 🚀 Быстрый отклик

* `gpt-3.5-turbo` (классическая модель, высокое соотношение цены и качества)
* `gemini-2.5-flash` ⭐ (быстрая, недорогая, контекст 1M)
* `claude-3-haiku` (легковесная быстрая версия, контекст 200K)
* `gpt-4o-mini` (легковесная быстрая версия, контекст 128K)

#### 💰 Максимальная экономичность

* `deepseek-chat` (контекст 128K, сильные общие возможности)
* `qwen-turbo` (быстрая версия Alibaba Qwen)
* `gpt-4.1-nano` (версия с ультранизкой стоимостью, контекст 128K)

## Основные возможности

### Умное автодополнение кода

```python theme={null}
# Input comment, AI auto-generates code
# Calculate the nth Fibonacci number
def fibonacci(n):
    # Cline will auto-complete implementation
```

### Пояснение кода

Выберите фрагмент кода и используйте:

* `Cline: Explain Code`: Объяснить код
* `Cline: Explain Error`: Объяснить ошибки

### Рефакторинг кода

* **Оптимизация производительности**: Предоставьте рекомендации по оптимизации
* **Повышение читаемости**: Выполните рефакторинг сложного кода
* **Исправление проблем**: Автоматически исправляйте распространенные проблемы

### Генерация тестов

```javascript theme={null}
// Original function
function add(a, b) {
    return a + b;
}

// Test generated by Cline
describe('add function', () => {
    test('should add two numbers correctly', () => {
        expect(add(2, 3)).toBe(5);
        expect(add(-1, 1)).toBe(0);
    });
});
```

## Распространенные команды

| Команда         | Сочетание клавиш | Функция           |
| --------------- | ---------------- | ----------------- |
| Cline: Ask      | `Ctrl+Shift+L`   | Спросить ИИ       |
| Cline: Explain  | `Ctrl+Shift+E`   | Пояснить код      |
| Cline: Refactor | `Ctrl+Shift+R`   | Рефакторинг кода  |
| Cline: Generate | `Ctrl+Shift+G`   | Сгенерировать код |

## Расширенные возможности

### Операции с несколькими файлами

Cline может понимать и работать с несколькими связанными файлами:

```bash theme={null}
"Move functions from utils.js to helpers.js and update all references"
```

### Проектирование архитектуры

Сгенерируйте архитектуру проекта:

```text theme={null}
Please design architecture for e-commerce admin system including:
- User management
- Product management
- Order processing
- Data analysis
Using React + Node.js + PostgreSQL
```

### Проверка кода

```text theme={null}
Review PR:
- Check code standards
- Find potential bugs
- Performance optimization suggestions
- Security vulnerability scan
```

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

### 1. Управление контекстом

Предоставляйте более полный контекст:

```typescript theme={null}
// @context: React component for user authentication
// @requirements: Support OAuth2 login flow
// @constraints: Compatible with NextJS 13+

// AI generates more accurate code based on context
```

### 2. Пользовательские prompts

Настройте в параметрах:

```json theme={null}
{
    "cline.customPrompts": {
        "codeReview": "Review code focusing on performance, security, standards",
        "optimize": "Optimize code performance and readability",
        "document": "Generate detailed Chinese documentation"
    }
}
```

### 3. Конфигурация на уровне проекта

Создайте `.cline/config.json`:

```json theme={null}
{
    "model": "claude-3-5-sonnet-20241022",
    "temperature": 0.7,
    "language": "zh-CN",
    "codeStyle": {
        "naming": "camelCase",
        "indent": 4,
        "quotes": "single"
    }
}
```

## Устранение неполадок

### Сбой подключения

Проверьте конфигурацию:

* Base URL: `https://api.apiyi.com/v1`
* API key действителен
* Сетевое подключение в норме

### Тайм-аут ответа

Решения:

1. Используйте более быстрые модели
2. Уменьшите сложность запроса
3. Разбейте большие задачи на части

### Низкое качество генерации

Способы улучшения:

1. Предоставьте больше контекста
2. Используйте более мощные модели
3. Четко укажите требования

### gpt-5.6 / gpt-5.5 / gpt-5.4 выдает 400

Ошибка `Function tools with reasoning_effort are not supported for ... in /v1/chat/completions` (400) — это официальное ограничение OpenAI, введенное в серии GPT-5.4: на `/v1/chat/completions` вызов tools нельзя сочетать с `reasoning_effort`, кроме `none` (значение `medium` по умолчанию тоже учитывается). Путь OpenAI Compatible в Cline жестко привязан к эндпоинту chat/completions и пока не поддерживает `/v1/responses`, поэтому обходного решения на стороне клиента нет.

Что делать:

1. Переключитесь на модель, на которую это не влияет: `gpt-5.1` / `gpt-5.2`, Claude, Gemini, DeepSeek и т. д.
2. Используйте клиент, который поддерживает эндпоинт Responses, — см. полную таблицу поддержки клиентов в [OpenAI Responses API Native Guide](/ru/api-capabilities/openai/native)

## Лучшие практики

### 1. Стратегия выбора модели

| Тип задачи                 | Рекомендуемая модель                   | Уровень стоимости | Причина                                                  |
| -------------------------- | -------------------------------------- | ----------------- | -------------------------------------------------------- |
| Простое завершение         | `gpt-3.5-turbo` / `gemini-2.5-flash`   | Очень низкий      | Быстро, недорого                                         |
| Генерация кода             | `claude-sonnet-4-20250514` / `o4-mini` | Средний           | Лучший для программирования                              |
| Сложное рассуждение        | `o3` / `deepseek-r1`                   | Средне-низкий     | Сильное рассуждение, цена o3 снижена                     |
| Проектирование архитектуры | `deepseek-r1` + `claude-4-sonnet`      | Низкий            | Сначала планируйте, потом реализуйте, экономьте средства |
| Проверка кода              | `gemini-2.5-pro` / `claude-4-sonnet`   | Средний           | Длинное контекстное окно, хорошее понимание              |
| Пакетный рефакторинг       | `deepseek-chat` / `qwen-turbo`         | Очень низкий      | Быстро и экономично                                      |
| Документация               | `gpt-4.1` / `qwen-max`                 | Средне-низкий     | Естественное изложение                                   |
| Обработка длинного текста  | `gemini-2.5-pro` (2M)                  | Средний           | Сверхдлинное контекстное окно                            |

### 2. Оптимизация промпта

```text theme={null}
❌ Bad prompt: Fix this function

✅ Good prompt: Fix floating point precision issue in calculateTotal function,
ensure amount calculation accurate to 2 decimal places
```

### 3. Поэтапная разработка

1. Сначала создайте базовый каркас
2. Постепенно добавляйте функции
3. В конце оптимизируйте производительность
4. Добавьте обработку ошибок

### 4. Осведомленность о безопасности

* Не включайте конфиденциальную информацию в код
* Проверяйте код, сгенерированный AI
* Проверяйте сторонние зависимости
* Следите за уязвимостями безопасности

## Интеграционный рабочий процесс

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

```bash theme={null}
# Auto-generate commit message
git add .
# Cline: Generate commit message based on changes
```

### Разработка через тестирование

1. Сначала напишите тестовые случаи
2. Cline генерирует код реализации
3. Запустите тесты для проверки
4. Повторяйте и оптимизируйте

### Интеграция CI/CD

Сгенерируйте файлы конфигурации:

```yaml theme={null}
# Cline can generate GitHub Actions config
name: CI
on: [push, pull_request]
jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v2
      - name: Run tests
        run: npm test
```

## Оптимизация токенов и контроль затрат

### 1. Мониторинг использования token

* **Мониторинг в реальном времени**: проверяйте оценочную стоимость в боковой панели Cline
* **Лимиты сеанса**: держите сеансы короткими, избегайте накопления контекста
* **Регулярный сброс**: завершайте длительные задачи в нескольких сеансах

### 2. Умное переключение моделей

```text theme={null}
Planning Phase → DeepSeek-R1 or o3 (strong reasoning, low cost)
Implementation Phase → Claude-4-Sonnet or o4-mini (strongest programming)
Simple Tasks → GPT-3.5-Turbo or Gemini-2.5-Flash (fast)
Long Text → Gemini-2.5-Pro (2M context)
```

### 3. Использование конфигурации .clinerules

Создайте файл `.clinerules` в корне проекта:

```text theme={null}
# Limit Cline operation scope
- Don't allow modifying node_modules
- Don't allow deleting important files
- Limit number of files modified at once
- Require confirmation for destructive operations
```

### 4. Альтернативные решения для снижения затрат

#### Интеграция GitHub Copilot Pro

* Ежемесячная плата всего \$10, неограниченное использование
* Использование через VSCode LM API
* Подходит для сценариев с высокой частотой

#### Локальные модели (Ollama)

```bash theme={null}
# Install Ollama and run local models
ollama run deepseek-coder:6.7b
ollama run qwen2.5-coder:7b
ollama run codellama:13b
```

#### Используйте отечественные модели, чтобы снизить затраты

* `qwen-turbo` (Alibaba Qwen)
* `glm-4` (Zhipu Tsinghua)
* `ernie-4.0` (Baidu Wenxin)

### 5. Оптимизация кэша

* Используйте сервисы вроде Requesty Router
* Можно сэкономить более 50% затрат на API
* Автоматическое кэширование повторяющихся запросов

## Продвинутые лучшие практики

### 1. Использование режимов Plan/Act

* **Режим Plan**: Для проектирования и ревью, только чтение
* **Режим Act**: Прямая реализация, подходит для простых задач
* **Память модели**: Cline запоминает предпочтение модели для каждого режима

### 2. Навыки управления контекстом

```typescript theme={null}
// Explicit context comments
// @context: React 18 + TypeScript 5
// @requirements: Support SSR, compatible with Next.js 14
// @constraints: Don't use external state management library
// @performance: First screen load < 3s
```

### 3. Система управления задачами

* **Закрепляйте важные беседы**: Используйте функцию звездочки
* **Экспортируйте ценный контент**: Сохраняйте как Markdown
* **Сортировка задач**: Сортируйте по стоимости, использованию Token
* **Пакетная очистка**: Регулярно очищайте сессии с низкой ценностью

### 4. Избегайте взрывного роста Token

```text theme={null}
❌ Wrong Approach:
- Handle multiple unrelated tasks in same session
- Let Cline read entire large codebase
- Constantly changing requirements causing context confusion

✅ Correct Approach:
- Start new session for each feature
- Only include relevant files
- Start after clarifying requirements
- Commit code immediately after completion
```

### 5. Анализ соотношения затрат и выгоды

| Сценарий                   | Традиционное время разработки | Стоимость Cline | Сэкономленное время | ROI           |
| -------------------------- | ----------------------------- | --------------- | ------------------- | ------------- |
| Модуль CRUD                | 4 часа                        | \$5-10          | 3.5 часа            | Очень высокий |
| Сложный рефакторинг        | 2 дня                         | \$20-50         | 1.5 дня             | Высокий       |
| Проектирование архитектуры | 1 неделя                      | \$50-100        | 5 дней              | Высокий       |

### 6. Оптимизация рабочего процесса

```bash theme={null}
# 1. Planning Phase (use reasoning models)
"Use o3 or DeepSeek-R1 to analyze requirements and develop architecture"

# 2. Implementation Phase (use programming-specialized models)
"Switch to Claude-4-Sonnet or o4-mini to implement core features"

# 3. Testing Optimization (use fast models)
"Use Gemini-2.5-Flash or GPT-3.5-Turbo for unit testing and optimization"

# 4. Documentation Phase (use comprehensive models)
"Use GPT-4.1 or Qwen-Max to generate project documentation"

# 5. Code Review (use long-context models)
"Use Gemini-2.5-Pro for comprehensive code review"
```

## Оптимизация производительности

### 1. Переключение моделей

Выбирайте модель в зависимости от задачи:

* Этап разработки: легковесные модели
* Сложные задачи: продвинутые модели
* Продакшен: сбалансируйте производительность и стоимость

### 2. Стратегия кэширования

* Включите кэширование ответов
* Кэшируйте часто используемые фрагменты кода
* Регулярно очищайте кэш

### 3. Оптимизация запросов

* Объединяйте связанные запросы пакетами
* Используйте ответы с потоковой передачей
* Задавайте разумные тайм-ауты

Нужна дополнительная помощь? Ознакомьтесь с [Подробной документацией по интеграции](/ru/scenarios/programming/cline).