# Cline (VS Code)

[Cline](https://github.com/cline/cline) — автономный агент в VS Code: читает и правит
файлы, запускает команды в терминале. Поддерживает провайдер «OpenAI Compatible»,
через него и подключается AgentAPI.

## Настройка

1. Установите расширение **Cline** из Marketplace.
2. Откройте панель Cline → значок настроек (⚙).
3. Заполните поля:

| Поле | Значение |
|---|---|
| **API Provider** | `OpenAI Compatible` |
| **Base URL** | `https://api.agentapi.ru/v1/ai` |
| **API Key** | `agentapi-ВАШ_КЛЮЧ` |
| **Model ID** | `anthropic/claude-3.5-sonnet` |

Base URL заканчивается на `/v1/ai` — Cline сам добавляет `/chat/completions`.
Model ID вводится вручную полным слагом: список моделей автоматически не подгружается,
так как внешнего `GET /v1/ai/models` у AgentAPI нет.

## Выбор модели

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

Разумные варианты:

| Модель | Когда |
|---|---|
| `anthropic/claude-3.5-sonnet` | Базовый выбор: хорошо следует инструкциям агента |
| `openai/gpt-4.1` | Альтернатива с большим контекстом |
| `deepseek/deepseek-chat` | Существенно дешевле для простых задач |

Проверяйте расход в [статистике](https://agentapi.ru/docs/billing) после первых сессий.

## Настройка контекста

В расширенных настройках Cline стоит задать:

- **Max output tokens** — ограничивает длину одного ответа; параметр доходит до API
  и применяется.
- **Auto-approve** — держите выключенным, пока не убедитесь в поведении модели:
  агент исполняет команды в терминале.

## Про вызов инструментов

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

## Что учесть

| Особенность | Следствие |
|---|---|
| Нет списка моделей | Model ID вводится руками |
| Изображения в контексте | Не поддерживаются: `content` принимает только строку (см. [Ограничения](https://agentapi.ru/docs/limitations)) |
| Rate limit по IP | 60 запросов в минуту на IP. Активный агентный цикл может упереться — при 429 подождите минуту |

## Диагностика

| Симптом | Что проверить |
|---|---|
| `404 Not Found` | В Base URL пропущен `/ai` или указан не тот хост |
| `401 Invalid API key format` | Ключ должен начинаться с `agentapi-` |
| `400 Negative or zero balance` | Пополните баланс |
| `502` | Неверный Model ID — сверьтесь с каталогом [Моделей](https://agentapi.ru/models) |
| `429` | Лимит 60 запросов/минуту по IP |