Cline (VS Code)
Cline — автономный агент в VS Code: читает и правит файлы, запускает команды в терминале. Поддерживает провайдер «OpenAI Compatible», через него и подключается AgentAPI.
Настройка
- Установите расширение Cline из Marketplace.
- Откройте панель Cline → значок настроек (⚙).
- Заполните поля:
| Поле | Значение |
|---|---|
| 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 | Существенно дешевле для простых задач |
Проверяйте расход в статистике после первых сессий.
Настройка контекста
В расширенных настройках Cline стоит задать:
- Max output tokens — ограничивает длину одного ответа; параметр доходит до API и применяется.
- Auto-approve — держите выключенным, пока не убедитесь в поведении модели: агент исполняет команды в терминале.
Про вызов инструментов
Cline описывает инструменты текстом системного промпта и разбирает ответ модели сам, не полагаясь на native function calling. Поэтому агентный цикл работает на любой достаточно сильной модели.
Что учесть
| Особенность | Следствие |
|---|---|
| Нет списка моделей | Model ID вводится руками |
| Изображения в контексте | Не поддерживаются: content принимает только строку (см. Ограничения) |
| 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 — сверьтесь с каталогом Моделей |
429 | Лимит 60 запросов/минуту по IP |