Установка Gemini CLI на свой сервер
Установка Gemini CLI на сервер сводится к пакету npm и Node.js 20 или новее. На удалённой машине удобнее входить по ключу GEMINI_API_KEY: вход через аккаунт Google ждёт браузер на той же машине, где работает терминал.
Ответ за 30 секунд
Для коротких задач хватит 2 ядер и 4 ГБ памяти, для долгих сессий на большом коде Google советует 16 ГБ. На сервере входите по ключу API из файла ~/.gemini/.env, а не через браузер.
Конфигурации от 1 до 8 ядер, почасовые списания, root-доступ.
Какой сервер нужен для Gemini CLINode.js 20+требование установки
4-16 ГБпамяти по рекомендации Google
~/.gemini/.envфайл для ключа
01 · 1 мин
Gemini CLI на удалённом сервере: что получится#
Gemini CLI: открытый агент Google для терминала. Он отвечает на вопросы по коду, правит файлы, запускает команды и работает с моделями Gemini. Его можно запустить и без установки через npx, но на сервере удобнее глобальная установка.
Сервер даёт агенту постоянное место: проект, зависимости и история лежат в одном месте, а вы подключаетесь по SSH из дома, из офиса или с планшета. Остальные агенты этого класса собраны в разделе ИИ.
Инструмент · 1 мин
Какой сервер нужен для Gemini CLI#
| Параметр | Рекомендация Google |
|---|---|
| Linux | Ubuntu 20.04+ |
| Память | 4 ГБ+ для коротких сессий, 16 ГБ+ для длинных сессий и больших кодовых баз |
| Среда | Node.js 20.0.0+ |
| Оболочка | Bash, Zsh или PowerShell |
Разница в памяти объясняется контекстом: чем больше файлов агент держит в работе, тем больше расходует процесс Node.js. Если вы открываете монорепозиторий на сотни тысяч строк, сразу закладывайте старшую конфигурацию.
Какой сервер взять под Gemini CLI
Отметьте, как вы будете работать, и получите конфигурацию
03 · 1 мин
Установка Gemini CLI на Ubuntu через npm#
- Поставьте Node.js 20 или новее. Версии из стандартного репозитория Ubuntu бывают старше, проверьте
node -v. Варианты установки Node.js на сервер: Node.js на VPS. - Поставьте пакет глобально командой ниже.
- Положите ключ API в файл
~/.gemini/.env. - Запустите
geminiв каталоге проекта.
npm install -g @google/gemini-cli
mkdir -p ~/.gemini
echo 'GEMINI_API_KEY="ваш-ключ"' >> ~/.gemini/.env
chmod 600 ~/.gemini/.env
cd ~/project && geminiОбновление: npm install -g @google/gemini-cli@latest. Кроме стабильной ветки есть @preview и @nightly, на рабочем сервере их лучше не ставить.
04 · 1 мин
Как Gemini CLI входит в аккаунт без браузера#
У Gemini CLI три способа входа:
- Аккаунт Google. Бесплатно до 60 запросов в минуту и 1 000 в день, но нужен браузер на машине, которая видит терминал с агентом. На сервере это неудобно.
- Ключ Gemini API из AI Studio в переменной
GEMINI_API_KEY. Подходит для сервера лучше всего. - Vertex AI через
GOOGLE_API_KEYиGOOGLE_GENAI_USE_VERTEXAI=true: для команд с проектом в Google Cloud.
В режиме без интерфейса Gemini CLI берёт сохранённый вход, а если его нет, читает переменные окружения. Поэтому ключ в ~/.gemini/.env работает и в скриптах, и в cron.
Регионы Gemini
Gemini API работает только в доступных регионах из списка Google, России в нём на 14 октября 2026 нет. Обходить ограничение не стоит. Агенты с выбором модели, которые подключаются к OpenAI-совместимому API, например Qwen Code, работают с AI Gateway Таймвеб Клауд и оплатой в рублях.
Подключение Gemini CLI к OpenAI-совместимым API в документации не описано: агент рассчитан на модели Gemini.
05 · 1 мин
Песочница и долгие сессии Gemini CLI#
Флаг --sandbox запускает команды агента в контейнере Docker или Podman, Google публикует готовый образ песочницы. Это полезно, если вы даёте агенту запускать установку пакетов и скрипты из интернета.
Чтобы задача не прервалась при обрыве SSH, откройте окно в tmux (tmux new -s gemini), запустите агента и отцепитесь сочетанием Ctrl+B, D. Ключ из .env храните вне каталога проекта: так он не попадёт в коммит и в контекст модели.
06 · 1 мин
Вопросы об установке Gemini CLI#
Какая версия Node.js нужна для Gemini CLI?
Node.js 20.0.0 или новее. Проверьте командой node -v до установки пакета @google/gemini-cli.
Как войти в Gemini CLI на сервере без браузера?
Задайте переменную GEMINI_API_KEY, удобнее всего в файле ~/.gemini/.env. В режиме без интерфейса агент берёт ключ из окружения.
Как установить Gemini CLI на Windows?
Той же командой npm при Node.js 20 или новее, Google рекомендует Windows 11 24H2 и новее. Для удалённой работы агента всё равно удобнее Linux-сервер.
Сколько памяти нужно Gemini CLI на VPS?
По рекомендации Google от 4 ГБ для коротких задач и от 16 ГБ для долгих сессий на больших кодовых базах.
Почему этому можно верить
Как мы проверяли
Источники цифр на этой странице: VPS и VDS серверы Таймвеб Клауд, timeweb.cloud/services/vds-vps, проверено 14 октября 2026; AI Gateway Таймвеб Клауд, timeweb.cloud/services/ai-gateway, проверено 14 октября 2026; Маркетплейс приложений Таймвеб Клауд, timeweb.cloud/marketplace, проверено 14 октября 2026; Руководство tmux (man tmux), man7.org/linux/man-pages/man1/tmux.1.html, проверено 14 октября 2026; Gemini CLI: установка и рекомендуемые характеристики, geminicli.com/docs/get-started/installation, проверено 14 октября 2026; Gemini CLI: аутентификация, geminicli.com/docs/get-started/authentication, проверено 14 октября 2026; Gemini CLI: README репозитория (лимиты бесплатного входа), github.com/google-gemini/gemini-cli, проверено 14 октября 2026; Gemini API: доступные регионы, ai.google.dev/gemini-api/docs/available-regions, проверено 14 октября 2026.
Запустите свой сервер за пару минут
Почасовая оплата: тестовый стенд на сутки стоит десятки рублей, а не месячный тариф.
- NVMe-диски и гарантированная доля процессора
- Root-доступ и любой софт, от Docker до игровых серверов
- Маркетплейс: 91 приложение в один клик
- Бесплатный перенос проекта силами специалистов