Gemini CLI: как установить и почему он не подключается к стороннему шлюзу
Gemini CLI это агент Google для терминала, и он работает с Gemini-протоколом. Подключить его к стороннему OpenAI-совместимому шлюзу не получится: переменная с базовым адресом меняет адрес Gemini, а не включает чужой протокол. Для моделей каталога LLM Mart есть агенты, которые это умеют.
Содержание
Что такое Gemini CLI
Gemini CLI это агент Google для работы в терминале. Он читает проект, предлагает правки и выполняет команды, как Claude Code или Codex CLI. Внутри он общается с Gemini по собственному протоколу Google, и это ключевое ограничение.
Для задач с моделями Google в облаке инструмент удобен: он бесплатен в рамках лимитов аккаунта Google и ставится одной командой.
Почему не подключается к LLM Mart
Соблазн понятен: кажется, что достаточно поменять базовый адрес и вставить ключ. На практике переменная вроде GEMINI_API_BASE_URL меняет адрес Gemini-протокола, а не переключает клиент на OpenAI-совместимый шлюз. Формат запросов при этом остаётся Google.
Отсюда типичные симптомы: требование ключа Google, ответ 401 на sk-…, ошибка на путь /api/v1/chat/completions. Причина одна: клиент шлёт запросы в чужом формате на адрес, который ждёт OpenAI-формат.
Как проверить свою сборку
Запустите gemini --help и посмотрите список опций. Если есть явный параметр с OpenAI-совместимым адресом, инструмент можно попробовать настроить: базовый адрес https://llmmart.ru/api/v1, ключ из кабинета и слаг модели из каталога.
Если такого параметра нет, настройка не поможет. Переменная адреса здесь не то же самое, что поддержка протокола.
Что использовать вместо
Первое: Qwen Code. Это агент с той же моделью работы, что Gemini CLI, но с настройкой провайдеров через массив modelProviders, поэтому подходит для сторонних шлюзов.
Второе: OpenCode. Открытый агент с конфигом в JSON, подключается к любому OpenAI-совместимому адресу. Инструкция лежит в документации по OpenCode, разбор в статье про настройку OpenCode.
Третье: Codex CLI. Работает через Responses API и допускает разные модели, включая GLM, Qwen и Kimi. Подходит, когда нужен агент OpenAI-школы.
| Агент | Протокол | Модели каталога |
|---|---|---|
| Gemini CLI | Gemini | нет |
| Qwen Code | OpenAI-совместимый | да |
| OpenCode | OpenAI-совместимый | да |
| Codex CLI | Responses | да |
Когда Gemini CLI всё же нужен
Если задача требует именно моделей Google из их облака и лимитов аккаунта Google, инструмент работает как задумано. Для доступа к моделям каталога через один ключ он не подходит: там другой протокол.
Сравнение агентов есть в статьях про Claude Code и Codex, полный список интеграций лежит в раздел�� документации.
Частые вопросы
Что такое Gemini CLI?
Это агент Google для терминала: читает проект, предлагает правки, запускает команды. Он общается с моделями Gemini по протоколу Google, а не по OpenAI-совместимому. Поэтому для задач с моделями Google из их облака инструмент удобен, а для сторонних шлюзов вроде каталога LLM Mart он не подходит.
Можно ли подключить Gemini CLI к LLM Mart?
Нет, в основной сборке нет OpenAI-совместимого шлюза. Переменная с базовым адресом меняет адрес Gemini-протокола, а не добавляет поддержку чужого формата. Ключ sk-… вернёт 401, потому что клиент шлёт запросы в формате Google. Для каталога используйте Qwen Code, OpenCode или Codex CLI.
Почему ключ LLM Mart не работает в Gemini CLI?
Инструмент отправляет запросы по протоколу Google на адрес, который ждёт Gemini-формат. Ключ LLM Mart рассчитан на OpenAI-совместимый путь /api/v1/chat/completions. Отсюда ответ 401: авторизация не проходит, потому что клиент говорит на другом протоколе. Смена ключа тут не поможет, нужен другой инструмент.
Чем заменить Gemini CLI для моделей каталога?
Подойдут Qwen Code, OpenCode и Codex CLI: первый настраивается через массив modelProviders, второй через файл JSON с baseURL, третий работает по Responses API. Все три принимают слаги моделей каталога LLM Mart и оплачиваются тем же ключом в рублях. Инструкции есть в разделе интеграций документации.
Как установить Gemini CLI?
Через пакетный менеджер Node.js, после чего запускается команда gemini. Первый запуск попросит войти в аккаунт Google и применит лимиты этого аккаунта. Если в вашей сборке появился параметр OpenAI-совместимого адреса, проверьте его в gemini --help: в основной сборке такого параметра нет.
Комментарии 0