Настройка Gemini CLI
Gemini CLI — это инструмент Google для работы с ИИ в терминале. Он подходит для использования Gemini в командной строке для вопросов и ответов, анализа кода и помощи в проектах.
Официальная информация Загрузки и документация приведены с официального сайта.
Что это за инструмент и для чего он нужен
Google GeminiТерминальные инструментыВход через GoogleКлюч Gemini API
Сначала выберите способ аутентификации
| Способ | Кому подходит | Описание |
|---|---|---|
| Вход через Google | Индивидуальные пользователи и новички | Запустите Gemini и войдите в аккаунт по подсказкам |
| Ключ Gemini API | Пользователи, у которых уже есть ключ Google AI Studio | Укажите ключ в переменной GEMINI_API_KEY |
| Vertex AI | Корпоративные пользователи или облачные проекты | Настройте в соответствии с проектами и правами Google Cloud |
Как протестировать ключ API
Временное тестирование в PowerShell
$env:GEMINI_API_KEY = "YOUR_GEMINI_API_KEY" geminiВременное тестирование в Терминале
GEMINI_API_KEY="YOUR_GEMINI_API_KEY" geminiИнтерактивный вход
geminiЧто делать после успешного теста
- Сначала запустите Gemini CLI в пустой директории; не открывайте сразу важные проекты.
- Задайте один простой короткий вопрос, чтобы убедиться, что модель отвечает нормально.
- Затем дайте прочитать тестовый файл, прямо указав не изменять его.
- Если вы планируете использовать ключ API на постоянной основе, сохраните метод аутентификации в локальном окружении или конфигурации согласно официальной документации Gemini CLI.
- Если вы переключили провайдера ИИ или CC-Switch, выполните проверку повторно после перезапуска терминала.
| Проблема | Первоочередная проверка | Решение |
|---|---|---|
| По-прежнему запрашивает вход через Google | Используется ли сейчас способ входа через Google? | Сначала завершите аутентификацию по подсказкам Gemini CLI; не смешивайте устранение неполадок с ключом API и процедуру входа |
| Недействительный ключ | Получен ли GEMINI_API_KEY из Google AI Studio / Gemini? | Не указывайте ключи от OpenAI или Claude в Gemini |
| Модель недоступна | Взято ли имя модели из списка Gemini? | Не вводите названия моделей OpenAI / Claude в Gemini CLI |
На что обратить внимание при настройке провайдера ИИ
Gemini CLI и OpenAI-совместимый провайдер — это не одно и то же. Следуйте инструкциям только в том случае, если провайдер явно указывает способ настройки для Gemini CLI, Google Gemini или Vertex AI.
Не вводите обычный Base URL OpenAI в Gemini CLI. OpenAI, Claude и Gemini используют три разных протокола. Если провайдер предоставляет отдельные адреса в панели управления, необходимо указать именно тот, который соответствует используемому инструменту.
Официальная документация Gemini CLI Просмотр инструкций по установке, командам и настройке.
Документация по аутентификации Gemini CLI Подробнее о входе через Google, ключе Gemini API и Vertex AI.