Gemini CLI — открытый терминальный агент Google: он приносит модели Gemini в командную строку, умеет работать с файлами проекта, запускать команды и подключать инструменты. Код открыт под Apache-2.0, а сам агент стал основой для нескольких форков — например, Qwen Code.
Свой адрес API у Gemini CLI настраивается — за это отвечают переменные GOOGLE_GEMINI_BASE_URL и GOOGLE_VERTEX_BASE_URL. Но меняют они адрес Gemini-совместимого сервиса: протокол остаётся фирменным, а не Anthropic Messages. Наш шлюз говорит на Anthropic-протоколе, поэтому напрямую этот агент к нему не подключится.
Инструмент
- Тип: Терминал
- Разработчик: Google
- Лицензия: Apache-2.0
- Протокол: Gemini API / Vertex AI
- Свой адрес API: Да, но только адрес Gemini-совместимого сервиса
Подключение к Vtop AI
- Напрямую: нет
- Способ: GOOGLE_GEMINI_BASE_URL / GOOGLE_VERTEX_BASE_URL
- Раздел: ключи API
Переменная GOOGLE_GEMINI_BASE_URL переопределяет адрес запросов к Gemini API и используется, когда между клиентом и Google стоит прокси или собственный шлюз. Отдельная переменная GOOGLE_VERTEX_BASE_URL делает то же самое для Vertex AI.
Полезно понимать разницу: «свой адрес» и «другой протокол» — не одно и то же. Подмена адреса работает, только если сервис на другом конце отвечает тем же форматом. Для Gemini CLI это форматы Gemini API или Vertex AI.
Если задача — работать с моделями каталога Vtop AI из терминала, берите харнесс, который поддерживает Anthropic Messages: таких в подборке большинство, и настраиваются они так же просто — адресом и ключом.
Как подключить
Адрес задаётся переменной окружения перед запуском: GOOGLE_GEMINI_BASE_URL для Gemini API и GOOGLE_VERTEX_BASE_URL для Vertex AI. Ключ подставляется штатными переменными Google.
Шлюз Vtop AI эти адреса не обслуживает: он принимает Anthropic Messages на /v1/messages, а не запросы формата Gemini. Прямой связки нет.
Из этой подборки на Anthropic-протоколе работают Claude Code, Cline, Roo Code, Kilo Code, Continue, Zed, Crush, OpenCode, Goose и OpenHands — и все они подключаются к ключу Vtop AI.
| Переменная | Что означает |
|---|---|
GOOGLE_GEMINI_BASE_URL | адрес Gemini-совместимого сервиса вместо стандартного |
GOOGLE_VERTEX_BASE_URL | то же для запросов к Vertex AI |
Сильные и слабые стороны
Что хорошо
- Открытый исходный код (Apache-2.0) и активное сообщество.
- Понятная настройка адреса через переменные окружения.
- Лёг в основу других агентов — подход к расширению проверен практикой.
На что обратить внимание
- Протокол Gemini, а не Anthropic Messages — к шлюзу Vtop AI напрямую не подключить.
- Часть возможностей завязана на сервисы Google и требует их аккаунта.
- Форки расходятся с основной веткой, поэтому поведение и настройки отличаются от проекта к проекту.
Сравнение с другими агентами
Та же задача, но разными инструментами — так выглядит выбор между харнессами. Подробный разбор каждого — по ссылке в таблице.
| Агент | Тип | Лицензия | Подключение к Vtop AI |
|---|---|---|---|
| Gemini CLI — этот агент | Терминал | Apache-2.0 | напрямую не подключается |
| Qwen Code | Терминал | Apache-2.0 | ANTHROPIC_BASE_URL + ANTHROPIC_API_KEY (протокол anthropic) |
| Claude Code | Терминал | Проприетарный (репозиторий — только документация и трекер) | ANTHROPIC_BASE_URL + ANTHROPIC_AUTH_TOKEN |
| Codex CLI | Терминал | Apache-2.0 | напрямую не подключается |
| Crush | Терминал | FSL-1.1-MIT (через два года — MIT) | crush provider add … --type anthropic --base-url |
Сравнение всех 14 агентов
Полная таблица подборки — на странице раздела: тип, лицензия, протокол и способ подключения к Vtop AI.
Смотрите также
Частые вопросы
Можно ли направить Gemini CLI на шлюз Vtop AI?
Нет. Переменные GOOGLE_GEMINI_BASE_URL и GOOGLE_VERTEX_BASE_URL меняют адрес сервиса, но не протокол: ожидается ответ в формате Gemini API или Vertex AI, а наш шлюз отвечает в формате Anthropic Messages.
Чем «свой адрес» отличается от «свой протокол»?
Адрес — это куда отправлять запрос. Протокол — в каком формате. Подменить адрес можно, только если на другом конце сервис понимает тот же формат запросов и ответов.
Какой терминальный агент подойдёт для Vtop AI?
Claude Code, Crush, OpenCode, Goose — все они поддерживают Anthropic-совместимые адреса и настраиваются парой «адрес + ключ».
Gemini CLI и Qwen Code — это одно и то же?
Нет. Qwen Code начинался как форк Gemini CLI, но с версии 0.1 развивается самостоятельно и заявляет поддержку нескольких протоколов, включая Anthropic.