Vtop AiVtop Ai
Начать

Агенты для API Vtop AI: 14 харнессов в одной подборке

Агент-харнесс — это обвязка вокруг модели: цикл «подумал — вызвал инструмент — посмотрел результат — повторил», доступ к файлам и командной строке, правила проекта, история сессии. Одна и та же модель в разных харнессах решает задачи по-разному, поэтому выбор агента — не менее важное решение, чем выбор модели.

Для публичного API Vtop AI важно другое: на каком протоколе агент говорит. Наш шлюз реализует два протокола — Anthropic Messages API и OpenAI Chat Completions. Поэтому напрямую подключаются и агенты с Anthropic-протоколом, и те, что умеют только формат OpenAI: без прослоек, переходников и собственных серверов. Таких в подборке почти все — не подключается напрямую один Gemini CLI, который говорит на протоколе Gemini. Об этом мы говорим прямо, а не выдаём инструкцию, которая не заработает.

14агентов в подборке
13подключаются напрямую
1работает на другом протоколе
0прослоек для прямых

Подключаются к Vtop AI напрямую

Эти агенты умеют указывать свой базовый адрес — на протоколе Anthropic Messages или OpenAI Chat Completions. Нужен только ключ из кабинета.

Агенты, которые подключаются к API Vtop AI напрямую: адрес шлюза и ключ, без переходников.
АгентТипЛицензияПротоколПодключается к Vtop AIЗвёзд на GitHub
Claude CodeТерминалПроприетарный (репозиторий — только документация и трекер)Anthropic Messages APIДа147 012
ClineРасширение к редакторуApache-2.0Anthropic Messages APIДа68 874
Roo CodeРасширение к редакторуApache-2.0Anthropic Messages APIДа24 302
Kilo CodeРасширение к редакторуMITAnthropic Messages или OpenAI-совместимыйДа27 377
ContinueРасширение к редакторуApache-2.0Anthropic Messages APIДа35 962
ZedРедакторGPL-3.0-or-later (часть компонентов — Apache-2.0)Anthropic Messages APIДа90 622
CrushТерминалFSL-1.1-MIT (через два года — MIT)Anthropic Messages APIДа28 203
OpenCodeТерминалMITAnthropic Messages APIДа208 833
GooseТерминал и приложениеApache-2.0Anthropic Messages APIДа54 501
OpenHandsПлатформа агентовMITAnthropic Messages APIДа88 624
Qwen CodeТерминалApache-2.0Несколько протоколов, включая Anthropic MessagesДа28 014
Codex CLIТерминалApache-2.0OpenAI Chat CompletionsДа125 494
AiderТерминалApache-2.0OpenAI Chat CompletionsДа49 082

Claude Code

Anthropic

напрямую

Терминал · Anthropic Messages API

Что это и как подключается

Для владельца ключа Vtop AI важно одно: Claude Code разговаривает ровно на том протоколе, который отдаёт наш шлюз, — Anthropic Messages API. Поэтому отдельные прослойки и переходники не нужны: адрес и ключ подставляются двумя переменными окружения, и агент работает через вашу модель из каталога Vtop AI.

Подключение

ANTHROPIC_BASE_URL + ANTHROPIC_AUTH_TOKEN

Лицензия и популярность

Проприетарный (репозиторий — только документация и трекер), 147 012 звёзд на GitHub.

Разбор агента

Cline

Cline Bot

напрямую

Расширение к редактору · Anthropic Messages API

Что это и как подключается

Для Vtop AI важно, что в настройках провайдеров у Cline есть готовый вариант «Anthropic» и галочка «Use custom base URL»: адрес шлюза подставляется в это поле, ключ — в поле ключа Anthropic. Никаких прослоек не нужно, потому что наш шлюз реализует тот же протокол Anthropic Messages.

Подключение

провайдер «Anthropic» + галочка «Use custom base URL»

Лицензия и популярность

Apache-2.0, 68 874 звёзд на GitHub.

Разбор агента

Roo Code

Roo Code

напрямую

Расширение к редактору · Anthropic Messages API

Что это и как подключается

Настройка подключения повторяет Cline: провайдер «Anthropic», ключ и галочка «Use custom base URL» для своего адреса. Шлюз Vtop AI принимает этот протокол напрямую, поэтому связка собирается за пару минут.

Подключение

провайдер «Anthropic» + галочка «Use custom base URL»

Лицензия и популярность

Apache-2.0, 24 302 звёзд на GitHub.

Разбор агента

Kilo Code

Kilo

напрямую

Расширение к редактору · Anthropic Messages или OpenAI-совместимый

Что это и как подключается

Для Vtop AI это значит, что в поле Base URL подставляется адрес шлюза, а в качестве типа API выбирается «Anthropic Messages». Дальше агент работает с моделями каталога как обычно.

Подключение

провайдер с полем Base URL: «Anthropic Messages» или «OpenAI Compatible»

Лицензия и популярность

MIT, 27 377 звёзд на GitHub.

Разбор агента

Continue

Continue

напрямую

Расширение к редактору · Anthropic Messages API

Что это и как подключается

Такой способ удобен в команде: файл конфигурации можно положить в репозиторий и тем самым задать одинаковые настройки модели для всех. Лицензия — Apache-2.0.

Подключение

поле apiBase в файле config.yaml

Лицензия и популярность

Apache-2.0, 35 962 звёзд на GitHub.

Разбор агента

Zed

Zed Industries

напрямую

Редактор · Anthropic Messages API

Что это и как подключается

Для работы через Vtop AI достаточно одного блока в файле настроек: имя провайдера, адрес шлюза и перечень моделей, которые вы хотите видеть в списке. Ключ подставляется тем же способом, что и у других провайдеров Anthropic.

Подключение

language_models.anthropic_compatible → api_url

Лицензия и популярность

GPL-3.0-or-later (часть компонентов — Apache-2.0), 90 622 звёзд на GitHub.

Разбор агента

Crush

Charmbracelet

напрямую

Терминал · Anthropic Messages API

Что это и как подключается

Провайдер типа anthropic принимает свой адрес: в команде добавления указывается --base-url. Именно сюда подставляется адрес шлюза Vtop AI, а рядом — ключ и, при необходимости, дополнительные заголовки.

Подключение

crush provider add … --type anthropic --base-url

Лицензия и популярность

FSL-1.1-MIT (через два года — MIT), 28 203 звёзд на GitHub.

Разбор агента

OpenCode

OpenCode

напрямую

Терминал · Anthropic Messages API

Что это и как подключается

Для любого провайдера в конфигурации можно переопределить базовый адрес полем baseURL. Провайдер anthropic со своим baseURL — это и есть подключение к шлюзу Vtop AI: файл на несколько строк, без прослоек.

Подключение

provider.anthropic.options.baseURL в opencode.json

Лицензия и популярность

MIT, 208 833 звёзд на GitHub.

Разбор агента

Goose

Block

напрямую

Терминал и приложение · Anthropic Messages API

Что это и как подключается

У провайдера Anthropic есть необязательный параметр адреса — ANTHROPIC_HOST. Это ровно то, что нужно: вместо стандартного адреса Anthropic указывается шлюз Vtop AI, и агент работает с моделями каталога.

Подключение

ANTHROPIC_HOST + ANTHROPIC_API_KEY при настройке провайдера

Лицензия и популярность

Apache-2.0, 54 501 звёзд на GitHub.

Разбор агента

OpenHands

All Hands AI

напрямую

Платформа агентов · Anthropic Messages API

Что это и как подключается

В настройках модели у OpenHands есть поля провайдера, модели, ключа и адреса — последнее живёт в разделе расширенных настроек. Адрес шлюза Vtop AI указывается именно там, ключ — в поле ключа.

Подключение

поле Base URL в расширенных настройках модели

Лицензия и популярность

MIT, 88 624 звёзд на GitHub.

Разбор агента

Qwen Code

Alibaba

напрямую

Терминал · Несколько протоколов, включая Anthropic Messages

Что это и как подключается

Для Vtop AI это удобно: выбирается протокол anthropic, адрес шлюза подставляется переменной ANTHROPIC_BASE_URL, туда же уходит ключ. Отдельных прослоек не нужно.

Подключение

ANTHROPIC_BASE_URL + ANTHROPIC_API_KEY (протокол anthropic)

Лицензия и популярность

Apache-2.0, 28 014 звёзд на GitHub.

Разбор агента

Codex CLI

OpenAI

напрямую

Терминал · OpenAI Chat Completions

Что это и как подключается

Codex разговаривает на протоколах OpenAI, и шлюз Vtop AI принимает OpenAI Chat Completions на пути /v1/chat/completions. В config.toml описывается свой провайдер с адресом шлюза и wire_api = "chat" — переходник не нужен.

Подключение

model_providers.<id> в config.toml: base_url + env_key + wire_api = "chat"

Лицензия и популярность

Apache-2.0, 125 494 звёзд на GitHub.

Разбор агента

Aider

Aider

напрямую

Терминал · OpenAI Chat Completions

Что это и как подключается

Провайдер Anthropic в Aider умеет только ключ, без поля адреса, зато у OpenAI-совместимых провайдеров адрес задаётся свободно. Шлюз Vtop AI принимает этот формат, поэтому адрес платформы подставляется в --openai-api-base.

Подключение

--openai-api-base https://vtop-ai.site/v1 + модель вида openai/имя-модели

Лицензия и популярность

Apache-2.0, 49 082 звёзд на GitHub.

Разбор агента

Codex CLI

OpenAI

напрямую

Терминал · OpenAI Chat Completions

Что это и как подключается

Codex разговаривает на протоколах OpenAI, и шлюз Vtop AI принимает OpenAI Chat Completions на пути /v1/chat/completions. В config.toml описывается свой провайдер с адресом шлюза и wire_api = "chat" — переходник не нужен.

Подключение

model_providers.<id> в config.toml: base_url + env_key + wire_api = "chat"

Лицензия и популярность

Apache-2.0, 125 494 звёзд на GitHub.

Разбор агента

Aider

Aider

напрямую

Терминал · OpenAI Chat Completions

Что это и как подключается

Провайдер Anthropic в Aider умеет только ключ, без поля адреса, зато у OpenAI-совместимых провайдеров адрес задаётся свободно. Шлюз Vtop AI принимает этот формат, поэтому адрес платформы подставляется в --openai-api-base.

Подключение

--openai-api-base https://vtop-ai.site/v1 + модель вида openai/имя-модели

Лицензия и популярность

Apache-2.0, 49 082 звёзд на GitHub.

Разбор агента

Работают на другом протоколе

Этот агент говорит на протоколе Gemini, которого у нашего шлюза нет: между ним и Vtop AI нужен сервис-переводчик форматов. Честно предупреждаем, чтобы вы не тратили время на настройку, которая не заработает.

Агент на протоколе другого вендора: напрямую к шлюзу Vtop AI не подключается.
АгентТипЛицензияПротоколПодключается к Vtop AIЗвёзд на GitHub
Gemini CLIТерминалApache-2.0Gemini API / Vertex AIНет107 097

Gemini CLI

Google

нужен переходник

Терминал · Gemini API / Vertex AI

Что это и как подключается

Свой адрес API у Gemini CLI настраивается — за это отвечают переменные GOOGLE_GEMINI_BASE_URL и GOOGLE_VERTEX_BASE_URL. Но меняют они адрес Gemini-совместимого сервиса: протокол остаётся фирменным, а не Anthropic Messages. Наш шлюз принимает Anthropic Messages и OpenAI Chat Completions, а фирменного протокола Gemini не принимает, поэтому напрямую этот агент к нему не подключится.

Подключение

GOOGLE_GEMINI_BASE_URL / GOOGLE_VERTEX_BASE_URL

Лицензия и популярность

Apache-2.0, 107 097 звёзд на GitHub.

Разбор агента

Частые вопросы об агентах

Коротко о том, что чаще всего спрашивают перед подключением.

Что такое агент-харнесс простыми словами?

Это программа, которая превращает модель из собеседника в исполнителя: сама читает файлы, правит код, запускает команды и проверяет результат. Модель внутри агента — та же, что в чате, но работает она не одним ответом, а десятками шагов подряд.

Какие агенты подключаются к Vtop AI напрямую?

Те, что умеют указывать свой базовый адрес. На Anthropic Messages API это Claude Code, Cline, Roo Code, Kilo Code, Continue, Zed, Crush, OpenCode, Goose, OpenHands и Qwen Code, на OpenAI Chat Completions — Codex CLI и Aider. Всем им нужен только адрес шлюза и ключ из кабинета.

Почему Gemini CLI не подключается?

Он говорит на протоколе Gemini API и Vertex AI, а наш шлюз принимает Anthropic Messages и OpenAI Chat Completions. Чтобы соединить Gemini CLI с Vtop AI, нужен сервис-переводчик форматов — мы его не предоставляем.

Расход токенов у агента больше, чем у чата?

Да, и заметно. В контекст каждого шага попадают прочитанные файлы, результаты команд и предыдущие рассуждения. Один сеанс «почини баг» может стоить в разы больше переписки о том же баге. Поэтому лимит расходов на ключе — не формальность.

Какой агент выбрать?

Если работаете в терминале — Claude Code, Crush, OpenCode, Goose или Qwen Code, а из инструментов на формате OpenAI — Codex CLI и Aider. Если правите код в редакторе — Cline, Roo Code, Kilo Code или Continue. Если нужен автономный агент в песочнице — OpenHands. Если нужен редактор целиком — Zed.

Нужен ли отдельный ключ каждому агенту?

Не обязательно, но удобно: у каждого ключа свой лимит расходов и свой список разрешённых моделей. Тогда в журнале видно, сколько тратит конкретный инструмент, а лимит одного агента не мешает другому.

Подключите агента к своему ключу

Ключ создаётся в кабинете, там же задаётся лимит расходов и список разрешённых моделей.

Создать ключ