Подготовка системного окружения и установка Node.js
Ubuntu 22.04 — надежная система, но пакеты в её стандартных репозиториях не всегда самые свежие. Для работы с современными инструментами вроде Gemini CLI нам нужен актуальный Node.js. Версия, которая идет по умолчанию в Ubuntu, может быть слишком старой и не поддерживать новые функции утилиты. Поэтому мы будем использовать репозиторий NodeSource, чтобы получить последнюю стабильную версию LTS. Это гарантирует, что все зависимости установятся корректно и не возникнет конфликтов версий.
Первым делом откройте терминал и обновите индекс пакетов. Это стандартная процедура, которая гарантирует, что вы устанавливаете самое свежее ПО из доступных источников. Введите команду обновления и дождитесь ее завершения. Если система предложит обновить установленные пакеты, можно согласиться, но это не обязательно для установки Node.js. Главное — иметь актуальный список доступных программ.
Далее нам нужно скачать скрипт установки NodeSource. Мы будем использовать версию 20.x, так как она является текущим LTS-релизом и отлично подходит для разработки. Команда curl загрузит скрипт, а затем передаст его в bash для выполнения. Это безопасный и быстрый способ добавить репозиторий. После добавления репозитория снова обновите список пакетов, чтобы система увидела новые версии Node.js.
Теперь можно установить сам Node.js вместе с менеджером пакетов npm. Npm понадобится нам позже для загрузки самого Gemini CLI. После установки обязательно проверьте версии установленных программ. Просто введите команды node -v и npm -v в терминале. Если вы видите номера версий, значит, всё прошло успешно. Если терминал выдает ошибку, значит, что-то пошло не так, возможно, не были добавлены права суперпользователя или возникли проблемы с сетью.
Также стоит убедиться, что у вас установлен curl. Хотя он используется в предыдущих шагах, в некоторых минимальных конфигурациях Ubuntu он может отсутствовать. Если curl не установлен, система сообщит об этом при попытке загрузки скрипта. В таком случае установите его через apt. Это базовый инструмент для работы с сетью из терминала, который всегда пригодится администратору или разработчику.
Сам по себе Gemini CLI — это просто оболочка. Чтобы он работал, ему нужно общаться с серверами Google. Для этого используется API ключ. Без него утилита бесполезна. Получить ключ можно в Google AI Studio. Это платформа для разработчиков, где предоставляется доступ к моделям Gemini. Вам понадобится аккаунт Google. Если его нет, придется создать. Процедура регистрации бесплатная, но требует указания номера телефона для подтверждения.
Получение API ключа и установка утилиты Gemini CLI
Заходите в Google AI Studio и ищете раздел, связанный с API ключами. Обычно там есть кнопка «Create API key» или «Создать ключ». Нажимайте на нее. Система может попросить выбрать существующий проект в Google Cloud или создать новый. Для простых экспериментов с CLI можно создать новый проект с именем по умолчанию. После создания ключа вы увидите строку с символами. Скопируйте её и сохраните в надежном месте. Этот ключ дает доступ к вашему квоте запросов, поэтому не выкладывайте его в открытый доступ, например, на GitHub или в социальных сетях.
Теперь переходим к установке самой утилиты. Поскольку мы уже настроили Node.js и npm, это делается одной командой. Мы установим пакет глобально, чтобы он был доступен из любого каталога в терминале. Используйте флаг -g в команде npm install. Пакет называется gemini-cli. Менеджер пакетов загрузит все необходимые файлы из реестра npm и разместит их в системной папке. Этот процесс может занять некоторое время в зависимости от скорости вашего интернета.
После завершения установки нужно настроить переменную окружения. Это самый важный шаг, чтобы связать установленную утилиту с вашим ключом. В Linux для этого обычно используют файл .bashrc или .zshrc в зависимости от того, какую оболочку вы используете. По умолчанию в Ubuntu это bash. Откройте файл .bashrc в вашем домашнем каталоге с помощью любого текстового редактора, например nano или vim.
В конец файла добавьте строку, которая экспортирует переменную GOOGLE_API_KEY. В кавычках вставьте тот самый ключ, который вы получили ранее. Сохраните файл и закройте редактор. Чтобы изменения вступили в силу, нужно перезагрузить конфигурацию оболочки. Можно просто закрыть терминал и открыть заново, либо выполнить команду source .bashrc. Теперь система знает, где брать ключ для авторизации. Проверить работоспособность можно простой командой запроса к модели. Если утилита отвечает, значит, настройка прошла успешно.
Теперь, когда всё установлено, можно начинать работу. Базовый синтаксис утилиты прост: вы пишете команду, а затем текст вашего запроса в кавычках. По умолчанию Gemini CLI использует модель gemini-pro. Она достаточно быстрая и умная для большинства текстовых задач. Попробуйте попросить утилиту написать код на Python, перевести текст или составить план статьи. Ответ появится прямо в терминале.
Работа с инструментом, практические примеры и отладка
Одна из самых полезных функций CLI — это возможность передавать данные через пайп (pipe). Это позволяет объединять несколько команд в цепочку. Например, вы можете вывести содержимое текстового файла с помощью cat и передать этот текст в Gemini для анализа. Или взять результат работы другой команды и попросить модель объяснить его. Это превращает терминал в мощный инструмент для обработки данных без необходимости копировать и вставлять текст вручную.
Утилита поддерживает различные флаги для управления поведением модели. Вы можете изменить модель, если вам нужна более мощная версия или версия, работающая с изображениями. Флаги позволяют управлять температурой генерации, что влияет на креативность ответов. Более низкое значение температуры делает ответы более строгими и предсказуемыми, высокое — более разнообразными. Эти настройки помогают адаптировать модель под конкретную задачу, будь то написание технической документации или генерация идей для блога.
Иногда возникают ошибки. Чаще всего это проблема с сетью или неверный API ключ. Если вы видите сообщение об ошибке 401 или 403, проверьте, правильно ли вы экспортировали переменную окружения. Возможно, в ключе есть лишние пробелы или он был скопирован не полностью. Ошибка 429 говорит о том, что вы превысили лимит запросов. В бесплатной версии есть ограничения по количеству запросов в минуту. В таком случае придется немного подождать перед следующей попыткой.
Для удобства можно создать алиасы в системе. Если вы часто используете один и тот же набор параметров, не стоит каждый раз писать длинную команду. Создайте короткое сокращение в том же файле .bashrc. Например, можно назначить команду «g» для быстрого доступа к Gemini. Это сэкономит время и сделает работу более приятной. Использование командной строки для работы с искусственным интеллектом может показаться сложным на первый взгляд, но на деле это очень гибкий и быстрый способ интеграции AI в ваш ежедневный рабочий процесс.
Данная статья носит информационный характер.