Урок 1: Установка и бесплатный доступ

Чему вы научитесь

• Разберётесь, что такое Gemini CLI и чем он отличается от других AI-инструментов для разработчиков
• Установите Gemini CLI на вашу систему и настроите авторизацию через Google
• Выполните первый запрос к модели и поймёте базовую архитектуру
• Сравните Gemini CLI с Claude Code по ключевым параметрам

Что такое Gemini CLI?

Gemini CLI — это бесплатный интерфейс командной строки от Google для взаимодействия с моделью Gemini. Это полноценный AI-агент для разработчиков, похожий на Claude Code, но с одним огромным преимуществом: бесплатен.

Ключевые характеристики

┌─────────────────────────────────────────┐
│          Gemini CLI                     │
├─────────────────────────────────────────┤
│ • 1M токенов контекста                  │
│ • 60 запросов/минуту (бесплатно)        │
│ • Модель: Gemini 2.5 Pro                │
│ • Лицензия: Apache 2.0                  │
│ • Поддержка инструментов: shell, files  │
│ • Git интеграция: встроена              │
│ • Кроссплатформенность: macOS/Linux/Win│
└─────────────────────────────────────────┘

Gemini CLI предоставляет 1 миллион токенов контекста, тогда как Claude Code имеет стандартный лимит в 200K. Для анализа больших кодбейзов это критически важно.

Требования перед началом

• Node.js: версия 20+ (проверить: node --version)
• npm: обычно идёт с Node.js (проверить: npm --version)
• Интернет: для загрузки и авторизации
• Google аккаунт: бесплатно, нужен для получения API-ключа

Минимум 5-10 минут на весь процесс.

Шаг 1: Установка Gemini CLI

Откройте терминал и выполните:

npm install -g @google/gemini-cli

Процесс займёт 1-2 минуты. После завершения проверьте установку:

gemini --version

Вывод должен быть похож на:

gemini/0.x.x

Если команда не найдена, проверьте путь npm:

npm list -g @google/gemini-cli

Шаг 2: Получение API-ключа

Gemini CLI может работать двумя способами: через API-ключ или OAuth. Начните с самого простого — API-ключа.

Вариант А: API-ключ (рекомендуется для начинающих)

1. Откройте Google AI Studio в браузере
2. Нажмите “Create API Key”
3. Выберите “Create new API key in new project”
4. Скопируйте ключ (выглядит так: AIzaSyD...)

Важно: не делитесь этим ключом публично!

Вариант Б: OAuth (для production)

gemini auth

Откроется браузер, где нужно дать разрешение. После авторизации Gemini сохранит токен локально.

Шаг 3: Настройка окружения

Сохраните API-ключ в переменную окружения. Выберите вашу ОС:

macOS / Linux

# Откройте ~/.bashrc или ~/.zshrc
nano ~/.bashrc

# Добавьте строку:
export GOOGLE_API_KEY="AIzaSyD..."

# Сохраните: Ctrl+O, Enter, Ctrl+X
# Примените изменения:
source ~/.bashrc

Windows (PowerShell)

[Environment]::SetEnvironmentVariable("GOOGLE_API_KEY", "AIzaSyD...", "User")

Перезагрузите PowerShell и проверьте:

$env:GOOGLE_API_KEY

Шаг 4: Первый запуск

gemini

Вы попадёте в интерактивный режим. Введите простой запрос:

Привет! Как дела?

Вывод:

Привет! Спасибо за вопрос. Я ассистент Gemini, готов помочь с кодингом, анализом и творческими задачами. Чем я могу помочь?

Выход из интерактивного режима: exit или Ctrl+D.

Шаг 5: Конфигурация

Gemini CLI хранит настройки в файле ~/.gemini/settings.json. Посмотрите текущие настройки:

cat ~/.gemini/settings.json

Типичная конфигурация:

{
  "model": "gemini-2.5-pro",
  "apiKey": "AIzaSyD...",
  "temperature": 0.7,
  "maxTokens": 8000,
  "systemPrompt": ""
}

Вы можете редактировать этот файл вручную или через команду:

gemini config set temperature 0.5

Понимание файла GEMINI.md

Как Claude Code использует CLAUDE.md для инструкций агенту, Gemini CLI использует GEMINI.md.

Создайте файл в корне вашего проекта:

cat > GEMINI.md << 'EOF'
# Инструкции для Gemini CLI

## Роль
Вы помощник для разработки Python-приложений.

## Стиль кода
- Используйте type hints для всех функций
- Следуйте PEP 8
- Добавляйте docstrings в формате Google Style

## Проект
Это REST API с FastAPI.

## Запреты
- Не используйте глобальные переменные
- Не удаляйте файлы без подтверждения
EOF

Когда вы запустите gemini, он автоматически прочитает GEMINI.md и будет следовать этим инструкциям.

Сравнение: Gemini CLI vs Claude Code

Проверка работы: простой тест

Создайте новую папку для теста:

mkdir -p ~/gemini-test
cd ~/gemini-test

Запустите Gemini в режиме одного запроса (без интерактива):

gemini "Напиши функцию на Python, которая проверяет, является ли число простым"

Ожидаемый результат: вы получите код на Python с проверкой простых чисел.

Если код вывелся корректно — всё работает!

Попробуйте сами

Практическое задание 1: Установка и проверка

1. Установите Gemini CLI через npm
2. Получите API-ключ в Google AI Studio
3. Настройте переменную окружения GOOGLE_API_KEY
4. Выполните команду gemini --version
5. Запустите интерактивный режим gemini и введите: “Напиши функцию на JavaScript для сортировки массива”
6. Проверьте, что вывелся корректный код

Время: 10-15 минут

Практическое задание 2: Создание GEMINI.md

1. Создайте папку ~/my-project
2. Инициализируйте Git: git init
3. Создайте файл GEMINI.md с инструкциями для вашего типа проектов
4. Заполните секции: Роль, Стиль кода, Проект, Запреты
5. Запустите gemini и в первом сообщении упомяните проект — убедитесь, что Gemini ссылается на GEMINI.md

Время: 5-10 минут

Ключевые выводы

• Gemini CLI — бесплатный, мощный инструмент с 1M контекстом, идеален для больших проектов
• Установка простая: одна команда npm, авторизация через Google
• GEMINI.md файл позволяет дать агенту постоянные инструкции для вашего проекта
• Сравнение важно: Claude Code лучше для критичного кода (лучше рассуждает), Gemini CLI лучше для анализа больших кодбейзов (дешево и много контекста)
• Гибридный подход — используйте оба инструмента в зависимости от задачи

Следующий урок

→ Урок 2: Базовая работа с Gemini CLI

В следующем уроке вы научитесь анализировать кодбейзы, генерировать код и редактировать множество файлов одновременно. Подготовьте небольшой open-source проект на GitHub!