Подготовка системы к работе
Для начала нужно убедиться, что ваша система Ubuntu готова к установке новых программ. Это базовый шаг, который пропускают многие, а потом сталкиваются с ошибками зависимостей. Откройте терминал. Обновите списки пакетов. Это нужно, чтобы менеджер пакетов знал о последних версиях программ в репозиториях. Команда простая: sudo apt update. После этого стоит обновить сами установленные пакеты. Введите sudo apt upgrade. Это может занять время, если у вас давно не было обновлений, но это надежный фундамент для дальнейшей работы.
Основная проблема при установке инструментов для работы с нейросетями на Ubuntu — это версия Node.js. В стандартных репозиториях Ubuntu часто лежит старая версия Node.js. Gemini CLI и сопутствующие библиотеки требуют более новой версии, обычно минимум 16 или 18. Если вы просто введете apt install nodejs, вы, скорее всего, установите устаревший софт, который не заработает. Поэтому мы будем использовать официальный репозиторий NodeSource. Это безопасный и проверенный способ получить актуальную версию.
Скачайте скрипт установки. Для версии 18 LTS, которая считается самой стабильной на данный момент, команда выглядит так: curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -. Эта команда скачивает скрипт и сразу запускает его. Она добавляет нужный репозиторий в вашу систему. После завершения работы скрипта можно устанавливать Node.js. Введите sudo apt install -y nodejs. Флаг -y означает, что система автоматически ответит «Да» на все вопросы подтверждения, что удобно для автоматизации.
Когда установка завершится, проверьте версии. Введите node -v и npm -v. Вы должны увидеть номера версий, которые соответствуют установленным пакетам. Если команды сработали и выдали номера, значит, среда выполнения JavaScript готова. Теперь нам нужен доступ к самому Google Gemini. Это облачный сервис, поэтому без интернета и API ключа работать не будет. Вам понадобится аккаунт Google. Если его нет, придется создать.
Переходите к получению ключа. Ключ API — это ваш пропуск к серверам Google. Зайдите на сайт Google AI Studio. Там будет кнопка «Get API Key» или «Создать ключ». Вам, возможно, потребуется создать новый проект в Google Cloud Console, но для простых экспериментов с CLI часто достаточно создания ключа в «Existing project» или создания нового проекта прямо в интерфейсе AI Studio. Следуйте инструкциям на экране. В конце вам покажут длинную строку символов. Это и есть ключ.
Важно: этот ключ нужно сохранить в безопасном месте. Не публикуйте его в GitHub, не отправляйте в чатах. Тот, у кого есть ключ, может тратить ваш лимит запросов. Google дает бесплатный лимит, но он не бесконечен. Скопируйте ключ в буфер обмена. Мы будем использовать его в следующем разделе. Пока просто убедитесь, что он у вас есть и доступен.
Теперь, когда Node.js установлен, а API ключ лежит в буфере обмена, можно переходить к установке самой утилиты командной строки. Существует несколько реализаций CLI для Gemini, но мы рассмотрим самый популярный и удобный вариант через npm. Это стандартный менеджер пакетов для Node.js, который мы установили на предыдущем этапе. Откройте терминал, если вы его закрыли. Мы будем устанавливать пакет глобально. Это означает, что команда gemini будет доступна из любой директории в системе, а не только внутри конкретной папки проекта.
Установка и настройка инструмента
Команда для установки выглядит так: sudo npm install -g gemini-cli. Здесь флаг -g как раз означает глобальную установку. sudo используется, потому что глобальные пакеты часто требуют прав администратора для записи в системные директории. Введите пароль пользователя, если система попросит. Начнется загрузка файлов из интернета. npm сам разберется с зависимостями, скачает все нужные библиотеки и установит исполняемый файл. Если процесс прошел без ошибок, значит, софт установлен.
Теперь нужно настроить аутентификацию. Утилита должна знать, как представляться серверам Google. Самый правильный и безопасный способ — использовать переменные окружения. Это лучше, чем прописывать ключ прямо в командах, потому что ключ не сохранится в истории команд терминала. В bash, который используется в Ubuntu по умолчанию, это делается через команду export. Введите: export GOOGLE_API_KEY=»ваш_ключ_здесь». Вместо «ваш_ключ_здесь» вставьте ту самую длинную строку, которую вы получили на сайте Google.
Эта переменная будет жить только до закрытия текущего окна терминала. Если вы закроете терминал и откроете новый, утилита перестанет видеть ключ и выдаст ошибку доступа. Чтобы этого не случилось, нужно прописать эту переменную в файл конфигурации оболочки. Обычно это файл .bashrc, который находится в вашей домашней директории. Откройте его редактором nano: nano ~/.bashrc. Прокрутите файл в самый конец и добавьте новую строку: export GOOGLE_API_KEY=»ваш_ключ_здесь». Нажмите Ctrl+O для сохранения, затем Enter для подтверждения имени файла, и Ctrl+X для выхода из редактора.
Чтобы изменения вступили в силу немедленно, нужно перезагрузить конфигурацию. Введите source ~/.bashrc. Теперь терминал знает о переменной. Проверить это можно командой echo $GOOGLE_API_KEY. Она должна вывести ваш ключ на экран. Если все верно, можно пробовать запускать утилиту. Попробуйте ввести простую команду, чтобы проверить связь: gemini «Привет, как дела?». Если вы все сделали правильно, нейросеть ответит вам текстом прямо в терминале.
Если вы получили ошибку, проверьте ключ. Часто бывает, что при копировании захватываются лишние пробелы или переносы строк. Убедитесь, что в переменной лежит только ключ. Также проверьте подключение к интернету. Если вы используете прокси или VPN, возможно, нужно настроить переменные окружения http_proxy и https_proxy, чтобы терминал мог выходить в сеть. Обычно для прямых подключений это не требуется, но в корпоративных сетях это частая проблема.
Когда базовая настройка завершена, можно переходить к реальному использованию. Gemini CLI поддерживает разные режимы работы. Самый простой — это отправка одного запроса и получение ответа. Вы уже делали это с командой «Привет». Но CLI гораздо мощнее. Вы можете передавать содержимое файлов. Например, у вас есть текстовый файл с кодом или статьей, и вы хотите, чтобы ИИ его проанализировал. Используйте оператор перенаправления ввода. Команда cat myfile.txt | gemini «Объясни этот текст» отправит содержимое файла в стандартный ввод, который утилита передаст в нейросеть вместе с вашим промптом.
Работа с инструментом и решение проблем
Также можно использовать интерактивный режим. В этом режиме вы ведете диалог с ботом, как в обычном чате, но прямо в консоли. Запуск обычно осуществляется флагом -i или —interactive, в зависимости от конкретной версии установленного пакета. Если команда gemini -i работает, вы увидите приглашение к вводу. Пишите вопросы, нажимайте Enter, читайте ответы. Чтобы выйти, обычно используется комбинация Ctrl+C или команда /exit. Это удобно, когда нужно задать серию связанных вопросов без необходимости каждый раз копировать ключ или вводить длинные команды.
Важно понимать лимиты. Бесплатная версия API имеет ограничения на количество запросов в минуту и в день. Если вы скриптами начнете слать слишком много запросов, сервер вернет ошибку 429 Too Many Requests. В таком случае нужно просто подождать некоторое время, пока лимит не сбросится. Для обычного ручного использования это редко бывает проблемой, но имейте в виду, если планируете автоматизацию рутинных задач через скрипты.
Что делать, если команда gemini не найдена? Это случается, когда путь к глобальным пакетам npm не добавлен в переменную PATH. Даже при установке через sudo система может не знать, где лежит исполняемый файл. Чтобы исправить это, нужно узнать, где npm хранит глобальные пакеты. Введите npm config get prefix. Путь, который выведет команда, обычно заканчивается на /usr/local или /usr. Внутри этой папки должна быть папка bin. Именно там лежит файл gemini. Добавьте этот путь в PATH. Для этого снова откройте ~/.bashrc и добавьте строку export PATH=»$PATH:/путь/к/папке/bin». Не забудьте сделать source ~/.bashrc после сохранения.
Еще одна частая ошибка — проблемы с сертификатами безопасности, особенно если вы работаете за корпоративным прокси. Если вы видите ошибки типа UNABLE_TO_VERIFY_LEAF_SIGNATURE, это значит, что Node.js не доверяет сертификату вашего прокси-сервера. Это можно исправить, установив переменную окружения NODE_TLS_REJECT_UNAUTHORIZED в значение 0, но это небезопасно, так как отключает проверку всех сертификатов. Лучше добавить корпоративный сертификат в хранилище доверенных сертификатов системы, но это тема для отдельной сложной настройки. Для дома обычно достаточно отключить VPN, если он мешает.
Экспериментируйте с промптами. В консоли нет красивого интерфейса, но скорость ответа часто выше, чем в браузере, так как нет лишней нагрузки на отрисовку графики. Вы можете использовать CLI для быстрого поиска информации, генерации кода, который сразу копируете в редактор, или обработки текстов. Попробуйте попросить нейросеть написать для вас bash-скрипт. Это отличный способ совместить пользу: вы получаете готовый код и учитесь новым командам терминала.
Данная статья носит информационный характер.