Устранение неполадок с Gemini
Интерфейсы Gemini и OpenAI-совместимые интерфейсы — это не одно и то же. Настраивайте конфигурацию для Gemini только в том случае, если провайдер явно предоставляет интерфейсы для Gemini / Google / Vertex или в руководстве четко указана поддержка Gemini CLI.
Что следует проверить в первую очередь?
| Элементы проверки | Как проверить | Зачем |
|---|---|---|
| Целевой инструмент | Убедитесь, что вы настраиваете именно Gemini CLI | Метод аутентификации для Gemini CLI отличается от Codex и Claude Code |
| Поддержка Gemini провайдером | В панели управления или руководствах есть разделы, связанные с Gemini / Google / Vertex | OpenAI-совместимый интерфейс отличается от интерфейса Gemini |
| Тип ключа | Используйте соответствующий ключ для Gemini или Vertex | Если тип ключа указан неверно, вы можете получить ошибку 401, 403 или постоянные запросы на вход |
| Название модели | Укажите в соответствии со списком моделей Gemini | Не указывайте названия моделей OpenAI или Claude в Gemini |
Частые ошибки
| Проблема | Первоочередная проверка | Решение |
|---|---|---|
| По-прежнему запрашивает вход в Google | Собственная аутентификация Gemini CLI | Сначала выполните аутентификацию по запросу Gemini CLI; конфигурация провайдера не может заменить процесс входа, требуемый самим инструментом. |
| 401 / 403 | Ключ Gemini или права доступа | Убедитесь, что ключ относится к группе Gemini / Google / Vertex, а текущий проект или аккаунт имеет права доступа к соответствующей модели. |
| 404 / model not found | Название модели Gemini | Укажите название модели из списка Gemini в панели провайдера; не вводите названия моделей OpenAI или Claude. |
| Сбой подключения (Connection failed) | Base URL для Gemini | Не вводите стандартный OpenAI-совместимый Base URL в Gemini; настраивайте его только в том случае, если в панели управления прямо заявлена поддержка Gemini. |
| Ничего не меняется после переключения в CC-Switch | Целевой инструмент и статус терминала | Убедитесь, что целью применения выбран Gemini CLI, сохраните настройки, затем перезапустите терминал и повторите тест. |
Минимальный тест
Сначала убедитесь, что Gemini CLI может вернуть фиксированную короткую фразу, а затем переходите к проверке более сложных задач.
Минимальный тест Gemini
gemini "Please reply only: Gemini configuration test successful"Шаблон для обращения в поддержку
При обращении к провайдеру используйте следующий шаблон
Tool: Gemini System version: Provider dashboard Base URL: Model ID / model name: Exact error: I have checked: no spaces in the Key / balance is sufficient / model name copied exactly / Base URL copied from the dashboard / terminal reopened