AgentAPI

Cline (VS Code)

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

Настройка

  1. Установите расширение Cline из Marketplace.
  2. Откройте панель Cline → значок настроек (⚙).
  3. Заполните поля:
ПолеЗначение
API ProviderOpenAI Compatible
Base URLhttps://api.agentapi.ru/v1/ai
API Keyagentapi-ВАШ_КЛЮЧ
Model IDanthropic/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 по IP60 запросов в минуту на 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