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

Настройте Gemini CLI под ваш рабочий процесс

Команды настройки

Основные команды для управления вашей конфигурацией

gemini config list

Показать все текущие настройки конфигурации

gemini config get <key>

Получить значение определенной настройки

gemini config set <key> <value>

Установить значение конфигурации

gemini config unset <key>

Удалить настройку конфигурации (вернуть к значению по умолчанию)

gemini config reset

Сбросить все настройки к значениям по умолчанию

gemini config export

Экспортировать конфигурацию в файл

gemini config import <file>

Импортировать конфигурацию из файла

Опции конфигурации

Подробные настройки, организованные по категориям

Настройка API

Настроить API ключи и параметры модели

api-key

Обязательно

Ваш API ключ Google AI

Тип:string
Example:
gemini config set api-key YOUR_API_KEY

model

Модель по умолчанию для использования

Тип:string
По умолчанию:gemini-pro
Example:
gemini config set model gemini-pro

temperature

Уровень креативности (от 0.0 до 1.0)

Тип:number
По умолчанию:0.7
Example:
gemini config set temperature 0.7

max-tokens

Максимальная длина ответа

Тип:number
По умолчанию:2048
Example:
gemini config set max-tokens 2048

Настройки интерфейса

Настроить внешний вид и поведение CLI

theme

Цветовая тема для CLI

Тип:string
По умолчанию:auto
Опции:auto, light, dark
Example:
gemini config set theme dark

output-format

Формат вывода по умолчанию

Тип:string
По умолчанию:text
Опции:text, markdown, json
Example:
gemini config set output-format markdown

stream

Включить потоковые ответы

Тип:boolean
По умолчанию:true
Example:
gemini config set stream true

history-limit

Количество поворотов разговора для запоминания

Тип:number
По умолчанию:10
Example:
gemini config set history-limit 20

Переменные окружения

Альтернативная конфигурация с использованием переменных окружения

Общие переменные окружения

GEMINI_API_KEY=your_api_key

API ключ для аутентификации

GEMINI_MODEL=gemini-pro

Модель по умолчанию для использования

GEMINI_CONFIG_DIR=~/.config/gemini

Директория конфигурации

Установка переменных окружения

Bash/Zsh:

export GEMINI_API_KEY=your_key

PowerShell:

$env:GEMINI_API_KEY="your_key"

Файл .env:

GEMINI_API_KEY=your_key

Файлы конфигурации

Понимание расположения и форматов файлов конфигурации

File Locations

Глобальная конфигурация:

~/.config/gemini/config.json

Конфигурация проекта:

.gemini/config.json

Файл окружения:

.env

Example Config File

{
  "api-key": "your_api_key",
  "model": "gemini-pro",
  "temperature": 0.7,
  "max-tokens": 2048,
  "theme": "dark",
  "stream": true,
  "tools-enabled": true,
  "safe-mode": true
}

Лучшие практики

Рекомендации для безопасной и эффективной конфигурации

Security

  • • Никогда не коммитьте API ключи в систему контроля версий
  • • Используйте переменные окружения для чувствительных данных
  • • Включите безопасный режим для выполнения инструментов
  • • Регулярно меняйте ваши API ключи
  • • Проверяйте и ограничивайте разрешения инструментов

Performance

  • • Настройте температуру в зависимости от случая использования
  • • Установите подходящие лимиты токенов
  • • Включите потоковую передачу для лучшего UX
  • • Настройте разумные таймауты
  • • Ограничьте размер истории разговора

Связанные ресурсы

Изучите больше руководств по настройке и установке

Руководство по установкеПримеры использованияУстранение неполадок