Руководство по устранению неполадок

Решения распространенных проблем и часто задаваемых вопросов о Gemini CLI. Найдите быстрые исправления и подробные руководства для различных проблем.

Быстрые диагностические команды

Начните с этих команд для диагностики распространенных проблем

gemini --version

Проверить версию CLI и информацию о сборке

gemini config list

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

gemini config reset

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

gemini logs

Просмотреть последние журналы ошибок и отладочную информацию

gemini doctor

Запустить диагностические проверки и проверку работоспособности

gemini cache clear

Очистить кэшированные данные и временные файлы

Распространенные проблемы и решения

Просматривайте по категориям, чтобы найти решения конкретных проблем

Проблемы установки

Проблемы при установке и настройке

npm install завершается с ошибками разрешений

Используйте npm с флагом --global или настройте npm для использования другого каталога. На macOS/Linux вам может потребоваться использовать sudo или правильно настроить npm.

Решение:
npm install -g @google/generative-ai-cli

Команда не найдена после установки

Убедитесь, что глобальный каталог bin npm находится в вашем PATH. Проверьте с помощью `npm config get prefix` и добавьте каталог bin в ваш PATH.

Решение:
export PATH=$PATH:$(npm config get prefix)/bin

Проблемы совместимости версий Node.js

Gemini CLI требует Node.js 16 или выше. Обновите Node.js с помощью nvm или загрузите с nodejs.org.

Решение:
node --version  # Should be 16.0.0 or higher

Проблемы аутентификации и API

Проблемы с API-ключами и аутентификацией

Ошибка недействительного API-ключа

Убедитесь, что ваш API-ключ правильный и имеет соответствующие разрешения. При необходимости получите новый ключ из Google AI Studio.

Решение:
gemini config set api-key YOUR_API_KEY

Превышена квота API

Проверьте ваши лимиты использования в Google AI Studio. Рассмотрите возможность обновления плана или внедрения ограничения скорости.

Решение:
gemini config set rate-limit 10  # Requests per minute

Проблемы с сетевым подключением

Проверьте интернет-соединение и настройки брандмауэра. Проверьте конфигурацию прокси, если находитесь за корпоративным брандмауэром.

Решение:
gemini config set proxy http://proxy.company.com:8080

Configuration Problems

Issues with CLI configuration and settings

Файл конфигурации поврежден или отсутствует

Сбросьте конфигурацию к значениям по умолчанию и перенастройте. Сначала создайте резервную копию важных настроек.

Решение:
gemini config reset
gemini config set api-key YOUR_API_KEY

Модель недоступна или устарела

Проверьте доступные модели и обновите конфигурацию. Некоторые модели могут иметь региональные ограничения.

Решение:
gemini models list
gemini config set model gemini-pro

Переменные окружения не распознаны

Убедитесь, что переменные окружения правильно установлены и экспортированы. Проверьте имена и значения переменных.

Решение:
export GEMINI_API_KEY=your_key_here
export GEMINI_MODEL=gemini-pro

Проблемы производительности

Медленные ответы и проблемы производительности

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

Проверьте сетевое соединение, уменьшите размер запроса или попробуйте другую модель. Рассмотрите использование потоковой передачи для длинных ответов.

Решение:
gemini config set stream true
gemini config set max-tokens 1000

Высокое использование памяти

Ограничьте историю разговоров, уменьшите размеры пакетов или периодически перезапускайте CLI-сессию.

Решение:
gemini config set history-limit 10
gemini session clear

Ошибки тайм-аута

Увеличьте настройки тайм-аута или разбейте большие запросы на меньшие части.

Решение:
gemini config set timeout 60000  # 60 seconds

Проблемы с инструментами и плагинами

Проблемы с функциональностью инструментов и плагинов

Сбой выполнения инструмента

Проверьте разрешения инструмента, пути к файлам и зависимости. Убедитесь, что инструмент правильно установлен и настроен.

Решение:
gemini tools list
gemini tools test tool-name

Плагин не загружается

Проверьте путь к плагину, проверьте синтаксические ошибки и убедитесь, что все зависимости установлены.

Решение:
gemini plugins list
gemini plugins reload plugin-name

Проблемы подключения к серверу MCP

Проверьте состояние сервера, сетевое подключение и совместимость версий протокола.

Решение:
gemini mcp status
gemini mcp reconnect server-name

Все еще нужна помощь?

Если вы не можете найти решение здесь, попробуйте эти ресурсы

Документация

Ознакомьтесь с полной документацией для подробных руководств и примеров.

Просмотреть документацию →

GitHub Issues

Сообщайте об ошибках или запрашивайте функции в нашем GitHub-репозитории.

Сообщить о проблеме →

Сообщество

Присоединяйтесь к нашим обсуждениям в сообществе и получайте помощь от других пользователей.

Присоединиться к обсуждению →

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

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

Руководство по участиюСправочник APIВернуться к документации