KozeKoze
← Вернуться к блогу
Учебное пособие2026年3月23日·管理员

Руководство по настройке Gemini CLI

Руководство по настройке Gemini CLI

📋 Подготовительные шаги

Перед началом убедитесь, что у вас есть:

  • Зарегистрированная учетная запись Koze и авторизованный пользователь
  • Создан ключ API на странице управления API
  • Установлен Gemini CLI (npm install -g @anthropic-ai/gemini-cli или обратитесь к Официальный репозиторий)

🚀 Метод 1: Доступ через API Gemini (рекомендуется)

Установите следующие переменные среды в терминале:

# Установка адреса прокси-сервера Koze Gemini export GOOGLE_GEMINI_BASE_URL='https://api.kozeai.com/gemini'

# Установите свой API-ключ Koze
export GEMINI_API_KEY='ваш API-ключ'

# Укажите используемую модель
export GEMINI_MODEL='gemini-2.5-pro'

Метод аутентификации:Выберите Использовать API-ключ Gemini при запуске. Если появится запрос на ввод ключа API, просто нажмите Enter и оставьте поле пустым.

💡 Если при запуске вас автоматически перенаправляет на страницу входа в Google, пожалуйста, удалите ~/.gemini/settings.json и перезапустите приложение.

🔧 Второй способ: доступ через API Code Assist

Еще один способ доступа, подходящий для некоторых особых сценариев:

# Настройка конечной точки Code Assist

export CODE_ASSIST_ENDPOINT='https://api.kozeai.com/gemini'

# Настройка токена доступа (с использованием вашего ключа API Koze)

export GOOGLE_CLOUD_ACCESS_TOKEN='ваш ключ API'

# Включение режима GCA

export GOOGLE_GENAI_USE_GCA='true'

# Укажите модель

export GEMINI_MODEL='gemini-2.5-pro'

Метод аутентификации:Выберите Войти с при запуске Google.

⚠️ Примечание: В консоли Gemini CLI может отображаться сообщение "Не удалось получить информацию о пользователе: 401 Unauthorized", что является нормальным явлением и не влияет на использование.

🎯 Шаг 3: Запуск Gemini CLI

После настройки запустите его в терминале:

gemini

📌 Сохранение переменных окружения

Рекомендуется записывать переменные окружения в файл конфигурации оболочки (используя метод 1 в качестве примера):

# Пользователь Zsh

cat >> ~/.zshrc << < EOF <

export GOOGLE_GEMINI_BASE_URL=

export GEMINI_API_KEY=<ваш API-ключ

export GEMINI_MODEL=

EOF source ~/.zshrc

📌 Доступные модели

Название модели Описание
gemini-2.5-pro Gemini 2.5 Pro, новейшее поколение высокопроизводительных моделей
gemini-2.5-flash Gemini 2.5 Flash, быстрее и больше экономичный
gemini-2.0-flash Gemini 2.0 Flash

⚠️ Часто задаваемые вопросы (FAQ)
Проблема Решение
Автоматическое перенаправление на вход в Google после запуска Удалите ~/.gemini/settings.json и попробуйте снова
Ответ 401 Unauthorized Это Это обычное сообщение, не влияющее на использование; игнорируйте его.
Модель недоступна Проверьте в лобби моделей Koze, включает ли ваш текущий тарифный план модели Gemini.

 

Руководство по настройке Gemini CLI | Koze AI